This section provides procedures for solving the most typical problems in Parallels Plesk Panel for Linux. Most importantly, it contains information on what to do if you:
If your problem is not discussed in this chapter or if the proposed solution does not work, visit the Parallels Knowledge Base at http://kb.parallels.com/ or contact our technical support department.
If you get the error messages "Unable to initialize session", "Domain ID is undefined", or "Client ID is undefined" when trying to access Parallels Plesk Panel, it means that Panel cannot create a session in $PRODUCT_ROOT_D/admin/sessions.
This may happen if there is not enough free disk space on the Panel server.
To check if there is enough disk space, run the commands:
# df -h
# df -i
If disk space usage is at 100%, you should remove useless files or rotate log files in /var/log/. For more information on log rotation, see the section Log Rotation.
If you get the error message "Access for administrator from address xx.xx.xx.xx is restricted in accordance with IP Access restriction policy currently applied." when trying to access Parallels Plesk Panel, it means that the Panel IP access policy does not allow you to log in from your current IP.
To access Panel from an IP address:
To find the current policy and its restricted and allowed IP addressess,run the following commands.
# mysql -uadmin -p`cat /etc/psa/.psa.shadow ` psa
mysql> select * from cp_access;
mysql> select * from misc where param='access_policy';
To clear the access policy settings:
mysql> delete from cp_access;
mysql> update misc set val="allow" where param='access_policy';
otherwise, you may get the following error message:
Unable to connect to database
login.php3: Unable to connect to database: Permission denied
ERROR 1045: Access denied for user: 'admin@localhost' (Using password: YES)
In this case, restart Panel and try to log in again:
# /etc/init.d/psa restart
If this does not work, do the following:
# ls -la /etc/psa/.psa.shadow
The right permissions and owner are -rw------- and psaadm respectively. If the current permissions are different from these, change them by running the commands:
# chown psaadm:psaadm /etc/psa/.psa.shadow
# chmod 600 /etc/psa/.psa.shadow
# ps ax | grep mysql
The following output indicates that the mysql is running properly:
3776 pts/0 S+ 0:00 grep mysql
24272 ? S 0:00 /bin/sh /usr/bin/mysqld_safe datadir=/var/lib/mysql --socket=/var/lib/mysql/mysql.sock --log error=/var/log/mysqld.log --pid-file=/var/run/mysqld/mysqld.pid user=mysql
24322 ? Sl 0:07 /usr/libexec/mysqld --basedir=/usr --datadir=/var/lib/mysql --user=mysql --pid-file=/var/run/mysqld/mysqld.pid --skip-external-locking --socket=/var/lib/mysql/mysql.sock
# mysql -uadmin -p`cat /etc/psa/.psa.shadow` -D psa
If you can access the mysql, then it is likely that Panel is ok and you have forgotten the administrator's password. See the section The Administrator's Password has been Forgotten for instructions on how to restore it.
If you forget the Panel administrator's password, there are two ways to resolve this issue:
To restore the Panel administrator's password:
PRODUCT_ROOT_D/bin/ where PRODUCT_ROOT_D is /usr/local/psa for RPM-based systems or /opt/psa on DEB-based systems.admin utility with the --show-password option:# ./admin --show-password
To set a new administrator password:
PRODUCT_ROOT_D/bin/ where PRODUCT_ROOT_D is /usr/local/psa for RPM-based systems or /opt/psa on DEB-based systems.init_conf utility with the new password specified:# /usr/local/psa/bin/init_conf --update -passwd new_password
When Panel is installed to Parallels Virtuozzo Containers PVC, administrators refer to Panel when performing web hosting operations and to Parallels Power Panel (PPP) when managing their container. The PPP becomes available when the administrators turn on the offline-management mode. When this mode is on and Panel is installed, some controls and menus of PPP become available in the top and left navigation panes of Panel. In other words, PPP is partially built into Panel in offline-management mode.
Since Panel 10, the integration between panels can lead to unexpected results. For example, some icons in Panel might not be displayed or the layout might be broken when the offline management is on. To resolve these problems, we recommend that you do not use the integration, and that you access the panels on different ports (4643 and 8443).
To make PPP and Panel operate on different ports, do the following:
vzctl set CT_ID --offline_management yes --offline_service vzpp --save
vzctl set CT_ID --offline_management yes --save
vzcfgt set CT_ID offlineservices vzpp
PVC 4.0 and later versions can discover EZ templates in a container and perform automatic actions depending on the templates. This feature provided opportunities for business automation software (such as PBAs) to automatically find products installed in a container and start billing the container owner.
The discovery algorithm is straightforward: If the system finds all packages included in an EZ template, it considers that such a template is installed. The major drawback of this approach is that Panel 9.x and SMB are very close to each other in terms of packages, so the auto-detection engine makes incorrect decisions. Namely, if only one of the applications is present in a container, the system considers that both templates are installed. The most noticeable outcome of this detection problem is that the system fails to update both applications or set proper billing for them.
It is possible to stop the auto detection if you use the billing automation software or if you want to install Parallels Small Business Panel. To do this, modify the /etc/vztt/vztt.conf file by setting APP_TEMPLATE_AUTODETECTION=no.
If you operate in Parallels Virtuozzo Containers Environment the Postfix mail service may consume too many resources and, hence, work in an unstable manner. This is particularly likely to happen if there is a lot of outgoing mail that cannot be delivered. By default, Postfix can create up to 100 mail sending processes that will not stop until they send the specified mail.
To reduce resources consumption by Postfix:
# postconf -e 'default_process_limit=20'
ifmail and uucp in the Postfix configuration file /etc/postfix/master.cf.# PRODUCT_ROOT_D/admin/sbin/mailmng --reload-service
PRODUCT_ROOT_D is /usr/local/psa for RPM-based systems or /opt/psa on DEB-based systems.