Personal tools
You are here: Home Tips & Tricks Debian Server Einrichtung ISPConfig installieren

ISPConfig installieren

Hinweis:
Bei der Systeminstallation werden mache Dateien ersetzt an denen Veränderungen vorgenommen wurden. Dies kann zum Verlust von Einträgen in der named.conf sowie in der Sendmail/Postfix Konfiguration führen.

Wichtig:
ISPconfig sollte auf einer neuen Linux Installation ohne Webseiten installiert werden. Falls Sie einen Server mit Webseiten betreiben und ein Controlpanel für diese existierenden Webseiten möchten, ist ISPconfig nicht dafür geeignet !

Stellen Sie sicher, dass sie die c und c++ Compiler auf ihrem Server installiert haben (gcc and cpp).

 

ISPConfig (stabil)

Download ISPConfig 2.2.19 von sourceforge.net [Download]

Loggen sie sich in ihre Shell als Benutzer root ein und laden sie das ISPconfig-Paket mittels wget auf ihren Server.

wget http://prdownloads.sourceforge.net/ispconfig/ISPConfig-2.3.2-dev.tar.gz

Entpacken Sie das ISPconfig Archiv.

tar xvfz ISPConfig*.tar.gz

Wechseln sie nun zum Ordner install_ispconfig:

cd install_ispconfig

In diesem Verzeichnis überprüfen Sie bitte die Datei dist.txt und passen Sie die Standardwerte gegebenenfalls an (sie sollten für eine Standardinstallation passend sein). Wenn Sie Werte ändern stellen Sie sicher, daß sie das Format der Datei nicht verändern. Starten Sie dann das Setup-Script:

./setup

Der Installer wird nun einen Apache mit PHP 5 kompilieren, der anschließend auf Port 81 läuft und von dem ISPconfig System gebraucht wird. Dies wird nichts an einer vorhandenen Apache Installation ändern.

Wichtig: Stellen Sie sicher, dass sie gcc, flex, und die ganzen anderen Tools, die für den Kompiliervorgang benötigt werden installiert haben, bevor Sie das Setup starten. Sie müssen ausserdem die MySQL Header-Dateien installieren, die normalerweise in einem Paket namens mysql-devel, mysql-dev, libmysql-devel oder ähnlich finden. Andernfalls wird PHP 5 nicht kompilieren und der gesamte Installationsvorgang stoppt.

Wenn der ISPconfig Apache kompiliert wird, wird ein benutzerdefinertes SSL Zertifikat erzeugt. Daher werden ihnen ein paar Fragen gestellt; Sie können entweder die Standardwerte übernehmen oder neue Werte eintippen, das spielt keine Rolle.

Bild 35

In Schritt 7 ("Encrypting RSA private key of CA with a pass phrase for security [ca.key]") und

Schritt 8 ("Encrypting RSA private key of SERVER with a pass phrase for security [server.key]")

des Zertifikat-Erstellungsprozesses werden Sie gefragt, ob Sie den entsprechenden Schlüssel jetzt verschlüsseln möchten.

Wählen Sie hier n da Sie andernfalls immer nach einem Passwort gefragt werden wenn Sie ISPconfig neustarten was bedeutet daß es nicht ohne menschliche Interaktion neugestartet werden kann !

Bild 36 

Falls der Kompiliervorgang fehlschlägt wird das Setup angehalten und alle kompilierten Dateien werden entfernt. Durch die Fehlermeldung sollten Sie in der Lage sein, die Ursache des Fehlers zu erkennen (z.B. ein fehlendes Package). Versuchen Sie dann, den Fehler zu beheben und das Setup neuzustarten.

 

Im Erfolgsfall geht das Setup weiter:

"Please choose your language"

Hier wählen Sie die Sprache des ISPconfig Interfaces.

Danach wird ihnen die ISPconfig Lizenz angezeigt; lesen Sie sie bitte sorgfältig! Sie akzeptieren sie durch drücken von y. Wenn Sie sie nicht akzeptieren möchten, drücken Sie n und der Installationsvorgang stoppt.

 

"Installation Mode"

Bitte wählen Sie danach den Installationsmodus aus, Sie können zwischen dem Standard- und dem Expertenmodus wählen.

Im Standardmodus werden die Standardwerte für ihre Distribution genommen und in ISPconfig eingestellt. Im Expertenmodus werden ihnen die Standardwerte vorgeschlagen (z.B. Pfad zum Log des Mailservers) und Sie können sie akzeptieren oder ändern. 

Unter normalen Umständen sollte der Standardmodus genügen; benutzen Sie den Expertenmodus wenn Sie bereits vertraut mit dem System sind.

Das Installationsscript überprüft, ob die folgende Software installiert ist:

  • Apache Webserver,
  • Mail Transport Agent (MTA): Sendmail oder Postfix,
  • Procmail,
  • Quota,
  • MySQL,
  • ProFTP oder vsftpd,
  • OpenSSL,
  • Bind8 / Bind9,
  • iptables oder ipchains.


Falls eines der Packages nicht vorhanden ist, stoppt die Installation.

Installieren Sie dann das fehlende Package, löschen Sie das Verzeichnis install_ispconfig, entpacken Sie ISPconfig erneut und starten Sie die Installation von vorne.

Zusätzlich wird die Syntax der bereits existierenden Apache Konfigurationsdateien überprüft. Falls ein Fehler gefunden wird, wird die Installation gestoppt. Wenn alle Bedingungen erfüllt sind, werden ihnen ein paar Fragen gestellt die für die Installation notwendig sind.

Falls nicht alle Bedingungen erfüllt sind, stoppt das Setup.

Löschen Sie dann das Verzeichnis install_ispconfig, entpacken Sie ISPconfig erneut und starten Sie die Installation von vorne.

Danach müssen Sie folgende Informationen bereitstellen:

Please enter your MySQL server: z.B. localhost
Please enter your MySQL user: z.B. root
Please enter your MySQL password: Ihr MySQL Passwort
Please enter a name for the ISPConfig database: z.B. ispconfigdb
Please enter the IP address of the ISPConfig web: z.B. 192.168.0.1
Please enter the host name: z.B. www
Please enter the domain: z.B. xyz.de
Please select the protocol (http or https (SSL encryption)) to use to access the ISPConfig system:
Wenn Sie ihr Control-Panel mittels SSL benutzen möchten, wählen Sie 1.
Sie können es dann unter https://www.xyz.de:81 erreichen.
Wenn Sie es unter http://www.xyz.de:81 ereichen möchten, wählen Sie 2.


Nachdem Sie die Fragen beantwortet haben, sollte ISPconfig ordnungsgemäß installiert sein.

Wenn sie beispielsweise www als host und xyz.com als Domain angegeben haben, sollten Sie das ISPconfig Interface unter https://www.xyz.de:81 oder http://www.xyz.de:81 erreichen können.

Hier können Sie sich nun mit Username admin und Passwort admin einloggen. Sie sollten das Passwort sofort ändern ! Dies können Sie unter Tools > Passwort ändern tun.

Wenn ihr Server mehr als eine IP-Adresse hat, überprüfen Sie bitte unter Management > Server > Eigenschaften > IP- Liste ob diese von der Installationsroutine korrekt erkannt wurden.

 

Sollte es zu einem Zertifikatsfehler führen, dieses nochmals erstellen:

(alle Befehle natürlich ohne Zeilenumbruch in einer Zeile)

openssl genrsa -des3 -passout pass:yourpassword -out 
/root/ispconfig/httpd/conf/ssl.key/server.key2 1024
openssl req -new -passin pass:yourpassword -passout pass:yourpassword -key
/root/ispconfig/httpd/conf/ssl.key/server.key2 -out
/root/ispconfig/httpd/conf/ssl.csr/server.csr -days 365
openssl req -x509 -passin pass:yourpassword -passout pass:yourpassword -key 
/root/ispconfig/httpd/conf/ssl.key/server.key2 -in
/root/ispconfig/httpd/conf/ssl.csr/server.csr -out
/root/ispconfig/httpd/conf/ssl.crt/server.crt -days 365
openssl rsa -passin pass:yourpassword -in 
/root/ispconfig/httpd/conf/ssl.key/server.key2 -out
/root/ispconfig/httpd/conf/ssl.key/server.key
chmod 400 /root/ispconfig/httpd/conf/ssl.key/server.key

  

SpamAssassin

ISPconfig wird mit SpamAssissin ausgeliefert, aber ohne das Perl-Modul welchens von SpamAssassin benötigt wird. Führen Sie daher bitte folgendes nach der Installation aus:

/home/admispconfig/ispconfig/tools/spamassassin/usr/bin/spamassassin

Falls Fehler auftreten müssen Sie ein paar Perl Module installieren:

perl -MCPAN -e shell
install HTML::Parser
install DB_File
install Net::DNS
(when prompted to enable tests, choose "no")
install Digest::SHA1

Um den Perl Shell-Typ zu belassen:

q

Falls folgendes:

/home/admispconfig/ispconfig/tools/spamassassin/usr/bin/spamassassin

nichts zurückgibt, ist alles in Ordnung. Sie können dann SpamAssassin beenden indem Sie STRG+C drücken.