HowtoForge Forums | HowtoForge - Linux Howtos and Tutorials

HowtoForge Forums | HowtoForge - Linux Howtos and Tutorials (
-   Installation/Configuration (
-   -   Please read before posting! (

till 27th August 2012 16:17

Please read before posting!
Please provide the following information when you make a new thread, this helps us to solve your problem.

- Linux Distribution and version used on your server.
- ISPConfig version

Test your System with the ISPConfig test script for common issues

To start the test, run the following command as root user on your server:


wget -q -O htf-common-issues.php "" && php -q htf-common-issues.php
to view the report, run this command:


cat htf_report.txt | more
IP addresses are already anonymized in the report, so you can post it safely here in the forum.

It takes about 1 minute until ISPCOnfig writes changes to disk, ensure that you waited long enough before you test changes. If a job is listed in the jobqueue of the ispconfig monitor, then this job has not been processed yet. Wait until it disappears from the list.

Task specific information:

Email problems

- Do you use dovecot or courier as imap and pop3 server?

- Are you able to send and receive emails with webmail? A easy test if the local mailsystem works is to login to webmail with a account hosted on the server and send a email to the same address that you used to login to webmail. The email shall arrive within a minute back to your account when the local mailsystem works. If the email does not arrive, then check the mail.log as described below.

- Post the error message(s) that you get in the mail log file when the problem occurs. The mail log file is in the folder /var/log/, it is named "mail.log" on Debian and Ubuntu Linux and named "maillog" on other distributions.

Problems with Websites or PHP

- Which webserver software do you use, apache or nginx?

- Post the errors that you find in the global webserver error.log and the ones from the error.log of the website. The global log file is e.g. in /var/log/apache2/ for the apache server and the website error log is in /var/www/yourdomain.tld/log/

DNS Problems

- Have you waited long enough? Changes in DNS may take up to 24 hours until they propagate to all dns caches. If you like to test the local dns server for a domain name without waiting for the caches to renew, use this command:


dig @localhost yourdomain.tld
replace yourdomain.tld with the domain name that you want to query your local dns server for.

- If the nameservers (ns records) of the zone are subdomains of the zone, then ensure that you created A-Records for the ns1 and ns2 server in the zone as well and it might be nescessary to add glue records in the dns server of the domain registry.

- Post the errors of the named daemon (the BIND dns server logs under the name named) from /var/log/syslog

ISPConfig is not writing changes to disk

Debug instructions for the ISPConfig server process are in the FAQ:

Follow the instructions and post the output in your thread.

--- Post History ----------------------------------------------------
2013/11/28: Added ISPConfig test script.

All times are GMT +2. The time now is 01:09.

Powered by vBulletin® Version 3.8.7
Copyright ©2000 - 2014, vBulletin Solutions, Inc.