10th March 2010, 15:45
Join Date: Apr 2005
Location: Lüneburg, Germany
Thanked 2,642 Times in 2,487 Posts
It's all explained on http://www.ispconfig.org/manual_installation.htm
Hint: With the system installation, some system files are replaced where adjustments were made.
This can lead to loss of entries in named.conf as well as in the Sendmail/Postfix configuration.
Important: ISPConfig is meant to be installed on new Linux installations with no web sites, so if you run a server with hundreds of web sites and need a control panel that can take care of those existing web sites, then ISPConfig is not for you!
Make sure you have the c and c++ compilers installed on your server (gcc and cpp).
Log in to your shell as root.
Unpack the ISPConfig-archive
tar xvfz ISPConfig*.tar.gz
and change to the directory install_ispconfig:
In this directory please check the file dist.txt and see if the values given there suit to your
Linux installation (they should be suitable for standard installations). If you change any
values please be sure not to change the format of the file.
Then start the setup-script from there:
The installer will now compile an Apache with PHP5 that will run on port 81 and is needed by the ISPConfig system itself. It will not interfere with your existing Apache installation so you can go on unworried.
Important: Be sure to have installed gcc, flex and all the other tools neded for compiling sources before you run ./setup! You also need to install the MySQL header files which normally come in a package called mysql-devel, mysql-dev, libmysql-devel or something similar. Otherwise PHP5 will not compile, and the installation of ISPConfig stops!
When the ISPConfig Apache is built, a custom SSL certificate is built. Therefore you are asked a few questions. You can accept the default values, or you can enter new values there, this does not matter:
In step 7 ("Encrypting RSA private key of CA with a pass phrase for security [ca.key]")and step 8 ("Encrypting RSA private key of SERVER with a pass phrase for security [server.key]") of the certificate creation process you are asked if you want to encrypt the respective key now. Choose n there because otherwise you will always be asked for a password whenever you want to restart the ISPConfig system which means it cannot be restarted without human interaction!
If the compilation fails, the setup is stopped and all compiled files are removed. From the error message you get you should be able to see the reason for the failure (in most cases a package (like the MySQL header files) is missing). Try to solve the problem and the re-run ./setup.
In case of success the setup goes on:
Please choose your language. This is the language of the ISPConfig interface.
Afterwards you are shown the ISPConfig licence (BSD licence). Please read it carefully! You accept it by typing
"y”. If you do not want to accept the ISPConfig licence, type “n”, and the installation routine stops.
Installation Mode. Please select the installation mode afterwards. You can choose between the
standard and the expert mode.
In standard mode the installation routine takes standard settings for your Linux distribution and writes them to the ISPConfig system.
In expert mode the installation routine proposes standard settings to you (e.g. location of the config
file of your FTP server or log file of your mail server) which you can confirm or edit.
In normal circumstances the standard mode should meet your requirements. Select the expert
mode if you are familiar with your system.
The installation sript checks if the following software is installed:
* Apache webserver,
* Mail Transport Agent (MTA): Sendmail or Postfix,
* ProFTP or vsftpd,
* Bind8 / Bind9,
* iptables or ipchains.
If any of the packages is not present, the installation routine stops. Install the missing package, delete the directoy install_ispconfig, unpack ISPConfig again and start from the beginning.
In addition to that the syntax of your existing Apache configuration files is checked. If any error is
found the installation routine stops.
If all conditions are fulfilled, you are asked a few questions, whose answers are necessary for the
installation of ISPConfig.
In case not all conditions are fulfilled the setup script stops. Install the missing software, delete the directoy install_ispconfig, unpack ISPConfig again and start from the beginning.
Afterwards the following information has to be provided:
Please enter your MySQL server: E.G. localhost
Please enter your MySQL user: E.G. root
Please enter your MySQL password: Your MySQL password
Please enter a name for the ISPConfig database: E.g. ispconfigdb
Please enter the IP address of the ISPConfig web: E.g. 192.168.0.1
Please enter the host name: E.g. www
Please enter the domain: E.g. xyz.de
Please select the protocol (http or https (SSL encryption)) to use to access the ISPConfig system: If you want to use your control panel with SSL, select 1. You can then access it under https://www.xyz.de:81. If you want to access it under http://www.xyz.de:81, choose 2.
After you have answered the questions ISPConfig should be duly installed. If you indicated www as host and xyz.com as the domain during the installation, you will find the ISPConfig interface under
https://www.xyz.de:81 or http://www.xyz.de:81. Here you can login first with the user name admin and password
admin. It is recommended to change the password immediately! This can be done under Tools
-> Change password.