Table of Contents
A. Starting web-cp
B. Problems Logging In
C. FTP Problems
D. Common Error Messages
Web-cp consists of two important parts, a web-based 'frontend' and a text-based 'backend'. The backend is a daemon that constantly schedules tasks and performs actions for web-cp's frontend. The backend is webcp.php and can be started with "php /home/webcp/server/webcp.php" on any unix system. The frontend is the web-based part which runs on a web server. Ensure both are running if you are having problems getting to setup or past it.
I. Check to see if the backend is running (run ps -aux | grep webcp.php)
1. If yes then continue to II.
- 2. If no then try each of the following
- A. service webcp start
B. /home/webcp/server/webcp.php -i
C. php /home/webcp/server/webcp.php
- 3. If still no
A. Check to see that -q is removed from the shebang line in webcp.php and webcp-httpd.php
- B. Run php -m and ensure that the following modules are included
- mysql
- ftp
- zlib
- posix
- pcntl
II. Check to see if the front-end is running (go to 
http://localhost:81)
1. If yes then continue to III.
- 2. If no then
- A. If $cfg['httpd_mode'] = apache then
- 1. Check the httpd.conf file for the front-end to ensure
-
2. run service httpd-cp start
- B. if $cfg['httpd_mode'] = webcp then
1. Check if the front-end us running (run _ps -aux | grep webcp-httpd.php)
- If yes then continue to C.
- If not then run service webcp-httpd start
C. more...
III. more...
I. I login and keep getting sent back to login.php
1. Use phpMyAdmin to ensure your user account exists in the database
2. Ensure that $cfg['sysname'] has at least 1 dot in it (eg. domain.com) or 2 if using IE 5.5
A. Try using FireFox to login.
3. Ensure that the URL you are using to access web-cp is IDENTICAL to $cfg['sysname']
4. Check the date/time on your server. If it is wrong, Internet Explorer will expire the login cookie as soon as it is created and login will fail.
II. more...
I. Users cannot log in via FTP
1. Proftpd
A. Ensure that in the proftpd.conf file, RequireValidShell? is set to off
2. Wuftpd
3. Pureftpd
II. Users can see all files
1. Proftpd
A. Ensure that in the proftpd.conf file, DefaultRoot? is set to ~
2. Wuftpd
3. Pureftpd
III. more...
error: Failed dependencies:
/usr/bin/php is needed by webcp-0.x.x.noarch
- Install php from RPM's or try running the rpmbuild command with --nodeps (make sure you have php installed before doing this).
illegal option...
- Remove -q from line 1 of /home/webcp/server/webcp.php and /home/webcp/server/webcp-httpd.php or upgrade to a newer version of web-cp.
Error in argument 1, char 3: option not found
- Remove -q from line 1 of /home/webcp/server/webcp.php and /home/webcp/server/webcp-httpd.php or upgrade to a newer version of web-cp.
PHP Warning: mysql_query(): Access denied for user 'webcp'@'localhost'
- Correct the $cfg['dbuser'] and $cfg['dbpass'] settings (or add them) in your config.php file.
The PHP CGI cannot be accessed directly.
- Your PHP binary is built as a CGI. You need the CLI binary. Try building PHP from source using the PHP directions in the FedoraCore1 manual.
Connection not established. This user may not have permission to upload files.
Warning: fileatime(): Stat failed for /usr/webcp/tag/.status
- The backend is not running or has not been restarted since you upgraded.
setquota: Can't find mountpoint for device
- Ensure that $cfg['devhd'] exists and is set correctly in your config.php (this should be set to the device with your home directories such as /dev/hda1).
Invalid User Root: /home/...
- The backend is not running or the user it is running as does not have write permissions to the /home directory (most likely the user is webcp).
Could not open document config file /home/webcp/httpd/include/include.httpd
- Ensure that Apache has permission to read the file and ensure that SELinux is not interfering with reading the file.
Call to undefined function: ...
- You are missing some modules from PHP - the modules that contain the funtion called. You need to recompile PHP with the correct modules.
