ISPmanager: Troubleshooting

From ISPWiki

Jump to: navigation, search

This section provides troubleshooting information for users who are having troubles using and administering ISPmanager.


Logs are not displayed in the «Logs» module

Possible cause. The check box "Logs with rotation" is selected both for access and error. Why does it happen? User's home directories are located on one partition, while the ../httpd-logs/ directory is located on another.

Solution. It is not an error. Hard links are created only within one partition.

How do I disable backings?

You cannot terminate an active process with the kill command, as it will start again.

You need to delete the files from the /usr/local/ispmgr/var/run/ directory and then kill the 'ispbackup process.

"Failed to sign certificate" internal error occurred while enabling the SSL certificate for a domain

This error occurs if you are using the "User import" function to transfer data from a remote server. A set of keys was transferred as well.

To resolve this problem, go to the /data/etc/ directory of that user, locate the .crt .csr .key files (if any), move them to another location and try to enable the SSL certificate again.

"db4:TESTS NOT AVAILABLE" error occurred while installing

ISPmanager uses the db4 package to back up passwords from the SASL base. Verification tests do not exist. Ignore this message.

How can I learn the version of my control panel?

  1. /usr/local/ispmgr/bin/ispmgr -v
  2. Go to ISPmanager -> Help-> License

Image:Ispmgr ver.jpg

How do I change a link to ISPmanager?

Sometimes CMS and ISPmanager may conflict due to the identical link http://<IP>/manager/.
To avoid such a problem, you may move the server control panel.

1."Global" variant

  * Copy /usr/local/ispmgr/etc/ into /usr/local/ispmgr/etc/
  * Change Alias in /manager /usr/local/ispmgr/bin/ into a random one, such as /ispmanager.
  * Change the link to in the Apache configuration file 
  * Restart Apache
  * Restart ISPmanager

2. Variant for <virtualhost>
A server administrator may specify the following parameter

 Alias /manager/ /home/user/data/www/SITE/manager/ 

within the <virtualhost> directives for the CMS administrator panel opens by following the link http://SITE/manager/

How do I correctly update ISPmanager?

Normally, the control panel is updated automatically. If DisableAutoUpdate is specified in the ISPmanager configuration file, you need to run that is located in /usr/local/ispmgr/sbin to update manually.

 sh /usr/local/ispmgr/sbin/

Or you may download the control panel distribution, unpack it on the installed version and restart ISPmanager by the following command:

 killall -9 ispmgr

See also

How do I customize logs rotation for Nginx?

In /etc/newsyslog.conf specify:

 /var/log/nginx-access.log root:wheel 644 7 * * JCWg /var/run/
 /var/log/nginx-access.log               600  7     25000 *   ZC /var/run/
 /var/log/nginx-error.log root:wheel 644 7 * * JCWg /var/run/  
 /var/log/nginx-error.log               600  7     10000 *   ZC /var/run/

How do I enable Firewall?

In order to enable Firewall on the server and access it via ISPmanager:

  • Make sure you use our kernel or you have provided the required parameters (FreeBSD) to enable ifpw when compiling:
  • Go to ISPmanager -> the Server configuration section -> the Applications (ISPmanager) module and click the Enable icon to activate Firewall.


How do I restart ISPmanager?

Execute as root:

 killall -9 ispmgr

How do I restore lost files?

You may lose your files due to hardware or software failure. If it happens in ISPmanager, follow the instructions below:

  1. Download install.tgz с for your architecture.
  2. Unpack tar xzf install.tgz -C /usr/local/ispmgr/ to the panel's directory
  3. Restart the panel: killall ispmgr

Which password and login do I use to access ISPmanager?

To access the system as root, you need to enter the root password and login that you normally use for authorization. If you cannot log in, make sure you specified correct data, and root authorization is allowed (in the Ubuntu distribution root authorization is disabled). You can also execute the "sudo passwd root" command for authorization.

ISPmanager installation is followed by the "Invalid license" error

Synchronize your server's time with the time server.

If the license IP-address is not the first on the list, use the "--ip IP-address" key to manually specify an IP-address.

Installing ISPmanager on Gentoo

The installer is no longer developed due to the lack of interest to this product. You may install it manually.

  1. Download install.tgz from for your architecture (Linux-cc6).
  2. Unpack it into /usr/local/ispmgr/
  3. Create a /usr/local/etc/ispmgr.conf configuration file manually as described in the documentation.
    More information can be found in the outdated installation guide. Read that article from the "Technical details" section.

Installing ISPmanager on Solaris

See Installing ISPmanager on Gentoo

Logs rotation

Apache records the logs into


Logs are excluded from the user's home directory in order to prevent web-server failure if the user deletes the logs/ directory (if Apache fails to open the logs when restarting, it will not start).

The following log-file's hard links were created in the user's directory:


Logs rotation runs in the user's directory:


and creates the files:


Deletion of log-files may affect logs rotation and the analyser operation (Awstats\Webalizer).

ISPmanager log rotation mechanism: therotate task in the root crontab runs from 00 till 01 a.m. It rotates log-files and run the webstat generation script. The configuration file is located in /usr/local/ispmgr/etc/rotate.conf. It is strictly prohibited to edit that file! You can customize logs rotation in the ISPmanager control panel.

If any of the log files is too large, you may reset it with the following command:

 echo ""> /home/httpd-logs/

If you have deleted the log-files, you need to delete the file in the user's directory as well, restart the web-server and create the link again with the following command:

 ln /home/httpd-logs/ /home/username/data/logs/

Entering the Log module as user will fix the file's hard links as well.

Execute the following command to view user logs and edit hard links to the files:

/usr/local/ispmgr/sbin/mgrctl -m ispmgr user | awk '{print $1}' | \
awk -F= '{print "/usr/local/ispmgr/sbin/mgrctl -m ispmgr \"logs&su=" $2 "\""}' | sh

Logging and changing rotation start time

Rotation logs are specified into the message system log. The log contains information about the number of logs that were processed:

Jun 22 10:01:01 mary rotated[26006]: Rotation finished. 0 log files was processed. 0 seconds left

If the number if 0, this means that nothing was rotated. By default rotation runs 00 till 01 a.m. Changing the start time in cron will disable rotation.

To change the rotation period, edit start time in the cron job of the root user and specify the correct key:

Possible values:

/usr/local/ispmgr/sbin/rotate [-c <limit>] [-d hour] [-w weekday] [-m monthday]

For example, specifying the key -d 3 will change the rotation time into 03 a.m. of the server time.

PHP-extensions are blocked in ISPmanager

This means that they are either compiled into PHP statically or connected with a method that is unknown to the control panel.

Required encoding disappeared from the file manage after updating

All available encodings are located in the /usr/local/ispmgr/etc/filemgr.enc. file
If this file is missing, you may restore it with the command below:

 iconv -l |cut -d" " -f1|sed "s|//||g" > /usr/local/ispmgr/etc/filemgr.enc

Traffic in ISPmanager

WWW-traffic is collected by the mod_ispmgr module. Mail, ftp, etc., traffic is collected according to records in their logs. The following items are not counted: Nginx, MySQL, in case of replication or external usage, SSH and DNS.

Trying to set up a password to access the control panel

You may forbid your users to access the control panel by specifying an IP-addresses or a mask.

Image: ispmgr_access2.jpg

Where can I find firewall rules in ISPmanager?

More information on how to use this module can be found in Firewall (ISPmanager)

  • FreeBSD

When enabling a firewall, the following lines are added to /etc/rc.conf


All rules are located in /etc/firewall.conf

Execute the command below to read all the firewall rules:

 # /etc/rc.d/ipfw restart
  • Linux (example for Debian)

Two scripts are used (as the standard rc-script for firewall is not included into the distribution): When starting the interface, the script /etc/network/if-up.d/ispmanager_iptables starts as well

 /sbin/iptables-restore /etc/

When stopping the interface - /etc/network/if-down.d/ispmanager_iptables

 /sbin/iptables-save > /etc/

The rules are located in /etc/

Execute the command below to read the Firewall rules:

  1. /sbin/iptables-restore /etc/
  • Linux (example for Centos)

The standard init-script (included into this system) logs the rules into the following file:


Execute the command below to read Firewall rules:

 # /etc/init.d/iptables restart

When trying to recreate a WWW domain, ISPmanager returns the error: "Rotate already exists"

Delete the domain record (log rotation settings) from /usr/local/ispmgr/etc/rotate.conf, as the domain might have been removed incorrectly.

Maximum length of a MySQL database user name

You may enlarge a field size in the database where user names are kept. ISPmanager will process it, however the mysql.user table may get damaged. With the LogLevel 9 parameter set in ispmgr.conf, if the limit in the log file is exceeded, you will see something like this:

Nov 17 20:38:22 ../../src/dbmysql.cpp:144 �[1;33mDEBUG User name = 'just-hosting_ghj'�[0m
Nov 17 20:38:22 ../../src/dbmysql.cpp:270 �[1mTRACE Creating user�[0m
Nov 17 20:38:22 �[1;31mERROR Exception 9: User name too long�[0m

Users in ISPmanager have disappeared. The error " No record for user 'USER' at shadow. Can't disable" is shown in the log

Open the /etc/shadow system file with your favourite redactor to make sure it is correct. You will see something like this:

==[ /etc/shadow ]==
==[ /etc/shadow ]==

What is disk size?

It is a total amount of all files and/or quotas that a user can store on a web server.

What is disk quota?

Disk quota is the size of available hard disk space available to a login name (UID) or group (GID).

What is a "Limit on CPU" parameter?

This is a number of seconds of CPU time (processor time in the run status) that the processor is running for before it will be stopped.

What happens when the license expires?

You won't be able to log into the control panel and run any operation to customize the server. All other functions will continue functioning.

What should I install first on the sam server - BILLmanager or ISPmanager?

It depends on the release date. The panel with the latest version should be installed first.

Changing the maximum length of a MySQL user name

The maximum length of a user name in MySQL is 16 characters.

When using prefixes in MySQL user names you will need more characters.

To solve this problem, edit a User field's type in a user table in the MySQL base by the following MySQL request:

alter table mysql.user modify User char(32);

The "Invalid value for the disk" error occurred while transferring a site/user from one reseller to another

Locate the disk space limits in the user's properties. Resellers must have the value above 0. Provide the desired value in MB.

Access limits in ISPmanager

In the directory the following .htaccess file is created:

 <Limit GET POST>
        require valid-user
 AuthType Basic
 AuthName "/www/<directory>"
 AuthUserFile /home/<user>/data/etc/<file>.passwd

If the .htaccess file already exists in the directory, the structure described above is added at the end of the file.

Incoming email messages do not have subject, body and sender

In most cases spam filter is the cause of this error. Make sure it is running correctly. To learn if the spam filter is used for verifying incoming emails, view the logs (/var/log/maillog). Try turning the spam filter off and check incoming email messages once again.


- ISPmanager can use MariaDB as a database server. However, if you want to use MariaDB, you will do it at your own risk. ISPmanager is tested only with MySQL and PostgreSQL.

Domains are not present in the Domain names module

The control panel checks that:

  • the domain is specified in the panel configuration file (/usr/local/ispmgr/etc/ispmgr.conf)
  • the record is specified in the names configuration file
  • zone file is present

Make sure that everything is customized correctly.

Was this helpful? Yes | No
Personal tools