GameCP

Game Server Control Panel
Europe
CLIENT AREA  |  DOCUMENTATION  |  SUPPORT  |  FAQs
Home
Demo
Downloads
Prices & Ordering
Features
Partners
Forums
Contact Us

Configure Remote Servers

Remote Servers are where the game servers are ran. This can be on the same machine as your web-server or on any machine around the world. All of your remote servers will be connected to 1 installation of the GameCP web-server software.


Contents

Add New Machine

  • Login to your GameCP Install
  • Browse to Settings > Manage Machines
  • Click Add New Machine
  • Complete the required items
    • If you have Ubunutu 10.x (not 9) ensure you select that for Machine OS
  • Add New machine
  • Read the directions displayed on the final page


Linux

  • Click the directions
  • Copy them
  • Connect to the server via SSH using a ROOT level account, or sudo to root
  • Run the commands
  • Make sure it says GameCP-Remote Started
    • If it does not there was an error! Copy and paste the terminal output and email it to support@gamecp.com


Windows

  • Download the remote software linked from the panel
  • Run the installer
  • Paste your configuration into it
Validate install path, it should not be in Program Files

Example: C:\GameCPRemote

How do I start the Remote?

Linux/FreeBSD

You can issue start, stop or restart 

service gamecp start

Or 

/etc/init.d/gamecp start

Rebooted? GameCP may not auto start!

Windows

  • Login to your servers desktop
  • Browse to your GameCP folder or Start Menu
  • Run start.bat - restart.bat and stop.bat also available



 


Reinstall

If you need to reinstall your remote goto Manage Machines > Edit > Install Instructions and you will be presented with the normal directions for installing the remote.


If your users were erased from the remote machine
  • Login to your panel
  • Goto the Games tab
  • Use the check box to pick the games owned by the missing user(s)
  • Click the Repair option in the select box above the check boxes.
If your games were erased from the remote machine
  • Browse to Download Games
  • Update the game(s) missing
  • Re-download them

Updating

Windows

  • Browse to Settings > Manage Machines
  • Edit Machine(S)
  • Click "Update Remote Server"

Manually

Linux

Automated updating is currently not supported, we were unable to make this feature work at this time.

  • Login to your remote servers via SSH
  • Browse to the 'gcp' folder
  • Download the Archive for your operating system
    • Links are below
  • Extract the archive
  • Set permissions on the binary files
  • Restart GameCP


Linux Example
cd /usr/local/gcp/
wget http://gamecp.com/get/from/this/mirror/GameCP-Remote-Linux.tar.gz ;
tar zxvf GameCP-Remote-Linux.tar.gz ; 
rm -f GameCP-Remote-Linux.tar.gz ;
chmod +x ./gamecp bin32/gamecp_i386 bin64/gamecp_x64;
/etc/init.d/gamecp restart
Unbuntu 10.x (not 9) Example
cd /usr/local/gcp/
wget http://gamecp.com/get/from/this/mirror/GameCP-Remote-Ubuntu.tar.gz ;
tar zxvf GameCP-Remote-Ubuntu.tar.gz ; 
rm -f GameCP-Remote-Ubuntu.tar.gz ;
chmod +x ./gamecp bin32/gamecp_i386 bin64/gamecp_x64;
/etc/init.d/gamecp restart

Remote Files

If you are in need of the remote files they can be obtained here

How do I debug a Remote Server?

  • Locate your Remote Servers gamecp.ini
    • Linux: /usr/local/gcp/gamecp.ini
    • Windows: C:\GameCPRemote\gamecp.ini
  • Edit the file gamecp.ini
  • Change 
debug=off
  • To 
debug=on


When you are done testing turn it off!


 

Reading a Remote Server log

Windows

  • Open the 'debug.txt' file

Linux

Linux writes to /var/log/messages 

cat /var/log/messages | grep gamecp_

Common Remote Server Issues

Unable to connect to Remote Server

Error: Unable to connect to Remote Server Error: Unable to connect to the Remote Server

This message indicates your master web server was unable to connect to your remote server. There are going to be several key reasons why this occurs:

  • Incorrectly configured remote server
  • Stopped remote server
  • Blocked ports (240 or 3306)
  • Bad settings, locate your gamecp.ini and check your settings. * see below
  • SELinux enabled, disable it


Resolution

  • Try to start your Remote (/etc/init.d/gamecp start)

OR


 

Can't connect to MySQL server on 'XXXXXXX' (110) 

Can't connect to MySQL server on 'XXXXXXX' (110)
Error: cannot connect to database. Please check your mysql_host, mysql_user, mysql_password & mysql_database settings in gamecp.ini. This information must be correct information used to connect to your MySQL database for GameCP, located on your master server.

This message indicates your gamecp.ini has incorrect MySQL information.

Validate your mysql information and update your gamecp.ini

Read more below


 

Received incorrect SID

  • Goto Manage Machines > Edit Machine > Backend settings
  • Copy the textarea that has the configuration
  • Update your gamecp.ini on the remote with them
  • Restart your remote
  • Try again

Incorrect MYSQL information

GameCP requires a remote MySQL connection to your master server database - this user is defined in:

  • Settings > General > MySQL Information.
Please ensure this information is correct and works

This information is stored in your gamecp.ini file on all remote machines. Be sure those files have the correct information.

The MySQL User

You need a MySQL user that can connect from a remote host (%) to your "instructions" database. The only access required is 'read'.

A remote user will have a mysql host of '%' not 'localhost'. You can also create users for each remote. The user only needs 'read' permission to the 'instructions' table.

It is easy to manage MySQL users with phpMyAdmin or using the command below.

Testing

  • Read the gamecp.ini
  • Test the mysql_ information located in this file via the command line, or with other methods
  • Verify the data with alternative tools like phpMyAdmin
Linux 
mysql -h<host> -u<user> -p<pass>
Windows
  • Verify settings with alternative tools like phpMyAdmin

Creating a remote MySQL user

Replace $user, $pass and $db with settings for your database 

CREATE USER '$user'@'%' IDENTIFIED BY '$pass';
GRANT USAGE ON *.* TO '$user'@'%';
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON $db.* TO '$user'@'%';
FLUSH PRIVILEGES;

/usr/local/gcp/bin**/gamecp_**: error while loading shared libraries *****

This error indicates some requirements are missing. At this time we are still building a final list of what is required but typically it is only 'mysql-client' or 'mysql' or the libssl package.

What to install will depend on your error, contact support for help. 


apt-get install libssl-dev

yum install mysql-client

yast2 install mysql-client

Unable to upload files

  • Is your FTPD enabled?
    • Windows users, did you install FileZilla?
  • Try to FTP as the client using their game ip, their username and password
  • Edit your php.ini
    • Change post_max_size to a large size
    • Change upload_max_filesize to the same size


There was an error loading the config. Error: Field is empty

This indicates your gamecp.ini file is missing data

  • Browse to Settings > Manage Machines
  • Edit the machine with the problem
  • Locate its Backend Settings
  • Copy its 'gamecp.ini'
  • Login to your remote machine
  • Locate your gamecp.ini
  • Edit it
  • Replace the contents with the info you copied from Manage Machines

The 'screen' program is missing

Install screen 

apt-get install screen

yum install screen

yast2 install screen


Then start gamecp 

/etc/init.d/gamecp start

The 'mkpasswd' program is missing

This is required for modern shar password. 

apt-get install mkpasswd

OR 

apt-get install whois

Then start gamecp 

/etc/init.d/gamecp start

32-bit libraries for 64bit OS

If you are having problems with x86_64 servers running games, use the command for your system to install the 32bit libraries.

Ubuntu 

sudo apt-get install ia32-libs

Fedora/CentOS 

yum install libXtst.i386
Retrieved from "http://wiki.gamecp.com/Configure_Remote_Servers"


Navigation

Download Providers


(wiki tools)
Personal tools
Views
Actions

GameCP © 2011

More Information

GameCP Links

Support





Need help? Chat with us!