Installation Troubleshooting

If you have problems installing the GameCP PHP software to your web-server these topics may help.

GameCP Support is not your personal systems administrator

We are a programming company, not a systems administration service - if you need assistance with configuring GameCP we advise you to hire a systems administrator or order an installation service from GameCP.

Contents 1 Install Wizard Errors 1.1 MySQL 1.2 PHP 1.2.1 safe_mode 1.2.2 php_mysql 1.2.3 php_sockets 1.2.4 php_session 1.2.5 php_ftp 1.3 Permissions 1.3.1 cache 1.3.2 includes 1.3.3 site_path 2 Blank pages 3 Site error: the file **** requires the ionCube PHP Loader ioncube_loader_lin_***.** to be installed by the site administrator. 4 Forbidden! 5 500 Internal Server Error 6 UID of script "..." is smaller than min_uid

Install Wizard Errors

MySQL

PHP

These errors are related to your configuration of PHP. Windows users can easily turn most of these features on by editing their php.ini and commenting the exclusion of the required .dll file.

Non-Windows users have a few options

• Locate the module in your distributions repo

yum install php_mysql

• Recompile php with the module enabled

safe_mode

GameCP requires safe_mode to be disabled, while many features may work, all will not.

php_mysql

GameCP requires mysql so you must have php and mysql connected.

php_sockets

GameCP uses sockets to communicate to remote servers and query ports.

php_session

GameCP uses sessions to secure log-ins and other details.

php_ftp

GameCP uses ftp to transfer files.

Permissions

The install wizard will fail if your web-server does not have correct permissions of its files. This typically occurs when you have uploaded the web-files as root. You are required as a systems administrator to always ensure files you upload to your server are chown and chmod correctly.

Linux uses chmod and chown to set proper permissions.

• Locate your Apache user, this is www-data or apache on most systems
• Replace /path/to/gamecp with the actual path to gamecp, ie /var/www/html/panel
• Re-set the ownership
  • apache user

chown -R apache /path/to/gamecp

• • www-data user

chown -R www-data /path/to/gamecp

cache

This means your GameCP cache folder is not writable by apache.

includes

This means your installer's include folder is not writable by apache.

site_path

This typically means apache does not have write access to the main path for GameCP. It is very common for the files inside the site_path to be set correctly but the site_path folder itself be set incorrectly.

 

Blank pages

Blank pages typically indicate several things:

• A php error, check your web-servers error log or enable deubbing
  • If you need to manually enable debugging run this MySQL command:

UPDATE settings SET value='1' WHERE name='debugging';

• Ioncube was not installed, install ioncube.

It is common to find the error in your web-servers error log:

• /var/log/httpd/error_log
• /var/log/apache2/error_log

Site error: the file **** requires the ionCube PHP Loader ioncube_loader_lin_***.** to be installed by the site administrator.

Install ioncube to your server.

• http://www.ioncube.com/loaders.php

Forbidden!

If you receive apache messages saying that you are forbidden to see the GameCP installer, or your site - then your Linux File Permissions may have gone wrong.

This error is similar to 500 Internal Server Error so please read below

500 Internal Server Error

• Check your web-server error logs

Error typically indicates one of the following:

1. bad ownership
2. bad modes

You may need to 'chown' and 'chmod' your files for GameCP.

Check your apache/lighttpd error logs for more information.

# Example
tail /var/log/httpd/error_log

UID of script "..." is smaller than min_uid

You have phpsuexec enabled

• Locate your "apache user" (apache, www-data, nobody)

ps aux 

• Chown the web-files to the user

chown -R apache:apache var/www/html/panel

If that did not fix it

The apache user is still to high of a user. Add a new user - chown your files to it - and try again

adduser mywebfiles
chown -R mywebfiles:mywebfiles /var/www/html/panel