Contents Next

Allgemeines

1 Was ist ISPConfig?

Das ISPConfig-System ist eine Software zur Verwaltung von Servern, Webspace, Resellern und einzelnen Webs.

ISPConfig besteht aus drei Ebenen:

2 Begriffe und Aufbau des Handbuches

Den drei Ebenen entsprechend ist das vorliegende Handbuch in drei Abschnitte untergliedert:

Achtung: Diese Struktur bedeutet nicht, dass sich die Ebenen gegenseitig ausschließen. Die Ebene I umfasst die Ebenen II und III und die Ebene II die Ebene III.
Zur besseren Übersicht finden sich in den Handbüchern I und II Verweise auf die Anwendungen, die auch auf den jeweils untergeordneten Ebenen möglich - und entsprechend dort nachzulesen - sind.

3 Installation/Upgrade/Deinstallation

3.1 Installation

Zur Installation lesen Sie sich bitte die Installationsanleitung durch.

3.2 Upgrade

Das ISPConfig-System ist so ausgelegt, dass Sie von einer Version zu einer höheren innerhalb einer Hauptversion (z.B. 1.x, also z.B. von 1.1.12 auf 1.2.0) problemlos updaten können. Laden Sie sich dazu die gewünschte ISPConfig-Version auf Ihren Server und verfahren Sie dann wie bei der Installation. Die Installationsroutine erkennt dann, dass schon ein ISPConfig-System vorhanden ist und führt die nötigen Schritte für das Upgrade durch.

3.3 Deinstallation

Falls Sie das ISPConfig-System deinstallieren möchten, loggen Sie sich auf dem Server als root auf der Kommandozeile ein und führen Sie dann folgenden Befehl aus:

/root/ispconfig/uninstall

Der Uninstaller gibt Ihnen die folgenden Optionen zur Auswahl:

4 Login und Logout

Der Login in das ISPConfig-System wird in den einzelnen Handbüchern beschrieben (vgl. jeweils die Kapitel 1.1 der Handbücher I bis III).
Um sich auszuloggen, klicken Sie in der Menüleiste auf "Logout".

 

I Handbuch für Server-Administratoren

1 Allgemeines

1.1 Login und Passwort

Rufen Sie die URL des ISPConfig-Systems (z.B. https://www.domain.tld:81 bzw. http://www.domain.tld; "www.domain.tld" ist entsprechend zu ersetzen) in Ihrem Browser auf und geben Sie Benutzernamen und Kennwort in das Dialogfeld "Login" ein. Bestätigen Sie anschliessend mit "Login".


1.2 ISPConfig-Benutzeroberfläche für Server-Administratoren

Die Benutzeroberfläche des Administrators besteht aus folgenden Bereichen:


1.3 ISPConfig-Rechte für Server-Administratoren

Die Rechte eines ISPConfig-Administrators umfassen die eines ISP-Anbieters und die eines ISP-Kunden, d.h. dass Sie - als ISP-Administrator - ohne sich erneut einzuloggen - auch Anwendungen für Anbieter oder für Kunden vornehmen können.

Rechte des ISP-Administrators
  • Servergrundeinstellungen vornehmen und verändern
  • Anbieter anlegen und verwalten, -Statistiken lesen
  • Backup der ISPConfig-Datenbank erstellen
  • DNS-Einträge bearbeiten

Rechte des Anbieters/Resellers

  • Kunden anlegen und verwalten, -Statistiken lesen
  • Webs anlegen und verwalten
  • DNS-Einträge erstellen

Rechte des Kunden

  • Web-Basisdaten /-Statistiken lesen
  • User & Email-Postfächer anlegen und verwalten
  • (Sub-)Domains anlegen und verwalten
  • SSL-Zertifikate beantragen (optional)
  • MySQL-Zugangsdaten einrichten (optional)

Rechte des Users

  • Ändern der Einstellungen seines Email-Postfachs (Passwort, Spamfilter- und Antivirus-Einstellungen)

1.4 Speichern

Das ISPConfig-System bietet Ihnen zwei Möglichkeiten, Daten, die Sie in ein Formular eingegeben haben, zu speichern:

1.5 Ändern des Zugangspasswortes zum ISPConfig-System

Ihr Zugangspasswort für das ISPConfig-System können Sie unter "Tools" -> "Passwort ändern" bearbeiten.

Geben Sie im Formular "Passwort ändern" Ihr altes sowie Ihr neues Passwort (2x) ein und klicken Sie auf "Speichern".

1.6 Spracheinstellung

Die Sprache des ISPConfig-Systems können Sie unter "Tools" -> "Sprache ändern" einstellen.

Wählen Sie im Formular "Sprache ändern" die Sprache aus, die das System für Sie verwenden soll, und klicken Sie dann auf "Speichern".

Wichtig: Die Spracheinstellung betrifft nur Ihren Account. Andere Anbieter/Kunden können für sich individuell eine andere Sprache einstellen.

1.7 Anzeige von Passwörtern im ISPConfig-System

Passwörter, die in das System eingegeben werden (z.B. Anbieter- oder Kundenpasswort für den Zugang zum ISPConfig-System; Passwörter für MySQL-Kundendatenbanken), werden nach dem Speichern und dem neuerlichen Aufruf des Eingabeformulars aus Sicherheitsgründen grundsätzlich nicht angezeigt! Ein leeres Passwortfeld bedeutet also nicht, dass noch kein Passwort hinterlegt wurde.

Ein vorhandenes Passwort wird bei erneutem Laden des Formulars nicht angezeigt.

1.8 Hilfe

Klicken Sie auf den Menüpunkt "Hilfe".

Hier finden Sie das Admin-, Reseller- und Kundenhandbuch in deutscher und englischer Sprache im PDF-Format sowie Links zur Knowledgebase auf der Projektfarm-Website.

Weiterhin finden Sie neben einer Vielzahl von Eingabefeldern im ISPConfig-System ein Fragezeichen-Icon:

Durch Klicken auf das Fragezeichen öffnet sich ein kleines Browser-Fenster mit kontextbezogener Hilfe.

 

2 Grundeinstellungen

2.1 Servereinstellungen (Software)

Je nach Server werden einige Servereinstellungen bei der Installation des ISPConfig-Systems automatisch geladen. Weitere Einstellungen müssen manuell vorgenommen werden:

Um die Grundeinstellungen anzusehen oder Änderungen vorzunehmen, klicken Sie auf das Menü "Administration", öffnen Sie den Ordner "Server" und klicken Sie auf das Dokument "Einstellungen".

2.2 Serverstatus (Hardware und Statistik)

Die Hardwaredaten für den Server werden nach dem Login in ISPConfig automatisch geladen. Neben den Hardwaredaten sind über das ISPConfig-System u.a. Informationen zu Status und Auslastung des Servers abrufbar. Diese Informationen sind an zwei Orten hinterlegt:

Im Infofeld Server Status, das mit dem Login / Klicken auf ISP-Manager in der Bildschirmmitte erscheint oder mit Klicken auf das Menü "Administrator", den Ordner "Server" und das Dokument "Status".

Folgende Informationen sind abrufbar:

2.3 Datenbank-Backup

In der ISPConfig-Datenbank sind die Daten zu allen verwalteten Anbietern, Kunden, Webs, Domains sowie Usern & Email-Postfächern gespeichert. Es wird empfohlen, in regelmäßigen Abständen ein Datenbankbackup zu erstellen, die Datenbank zu checken, zu optimieren und ggf. zu reparieren.

So gelangen Sie zu den Datenbankfunktionen:

Klicken Sie in der Menüleiste auf "Administration".


Klicken Sie im Gliederungsbaum auf "ISPConfig-Datenbank".

2.4 Dienste (Monitoring und Firewall)

Das ISPConfig-System erlaubt es Ihnen, Dienste zu starten/stoppen/restarten, Dienste zu überwachen (beim Ausfall eines Dienstes wird eine Warn-Email an den Administrator verschickt; vgl. Kapitel I-2.1, "Admin-Email") sowie eine Firewall einzurichten (sofern iptables oder ipchains auf Ihrem System verfügbar ist).

Klicken Sie auf "Administration" -> "Server" -> "Dienste". Es öffnet sich das Formular "ISP Dienste" mit den Registern "Dienste", "Überwachung" und "Firewall".

2.4.1 Dienste starten/stoppen/restarten

Unter dem Register "Dienste" finden Sie einen Statusbericht verschiedener Dienste auf dem Server (online/offline), und Sie haben die Möglichkeit, Dienste zu starten, stoppen oder neu zu starten. Änderungen bestätigen Sie durch den "Übernehmen"-Button oder durch den Wechsel des Registers (vgl. I-1.4 "Speichern").

2.4.2 Dienste überwachen (Monitoring)

Unter "Überwachung" können Sie Dienste angeben, die vom ISPConfig-System überwacht werden sollen. Standardmässig werden die Dienste Web-Server, FTP-Server und MySQL-Server überwacht. Die Überwachung findet einmal alle 30 Minuten statt. Fällt ein Dienst aus, so wird eine Email an den Administrator verschickt (vgl. Kapitel I-2.1, "Admin-Email").

Achtung: Wenn Ihr Mailserver ausfällt, kann natürlich keine Warn-Email verschickt werden!

So richten Sie die Überwachung weiterer Dienste ein:

Klicken Sie auf den Button "Neu".

Es öffnet sich das Formular "ISP Überwachung".

Geben Sie die folgenden Informationen ein:

Klicken Sie dann auf "Speichern", oder wechseln Sie das Register.

Im Register "Aktionen" können Sie einen Shell-Befehl angeben, der ausgeführt wird, falls der betreffende Dienst offline ist (z.B. einen Befehl zum Restart des entsprechenden Dienstes):

Nach dem Speichern sind die zu überwachenden Dienste im Formular "ISP Dienste" im Register "Überwachung" aufgelistet und können dort wieder bearbeitet werden.

2.4.3 Firewall

Im Register "Firewall" können Sie Regeln für die Firewall auf Ihrem Server neu erstellen bzw. bestehende Regeln bearbeiten. Die Firewall ist natürlich nur aktiv, wenn Sie sie im Register "Dienste" gestartet haben. Standardmässig ist sie deaktiviert.

Eine Reihe von Firewall-Regeln ist im ISPConfig-System standardmässig implementiert:

Es gibt zwei Zustände:

  1. ein Port (und der darauf laufende Dienst) ist von aussen erreichbar und wird nicht von der Firewall geblockt: in der Spalte "Aktiv" wird "ja" angezeigt
  2. ein Port ist nicht von aussen erreichbar, wird also von der Firewall geblockt: dies trifft dort zu, wo in der Spalte "Aktiv" "nein" steht und auch bei allen Ports, für die keine Regel besteht!

Bestehende Regeln können Sie bearbeiten, indem Sie auf den Namen der Regel klicken; über den Button "neu" können Sie eine neue Regel anlegen.

Folgende Informationen werden benötigt:

Achtung: Um zu verhindern, dass Sie den Server gänzlich von der Aussenwelt abschneiden, also auch Sie als Administrator ihn nicht mehr erreichen können, können alle Ports geblock werden bis auf Port 22 (SSH) und Port 81 (das ISPConfig-System)! Wenn Sie versuchen, diese Ports zu blocken, wird dies vom ISPConfig-System ignoriert.

2.5 Update Manager

Den Update-Manager erreichen Sie über "Administration" -> "Update Manager" -> "Update". Er erlaubt es Ihnen, ISPConfig-Updates oder Tools wie z.B. Webmail, phpMyadmin oder einen Portscanner, die von der Projektfarm GmbH bereitgestellt werden, bequem zu installieren.

Es gibt zwei Wege, Updates einzuspielen:

  1. Sie laden sich das Update von der Projektfarm-Website auf Ihre lokale Festplatte herunter. Markieren Sie dann "Upload" und fügen Sie das Update mit dem "Durchsuchen"-Button in das Feld "Datei" ein und klicken Sie dann auf "Installation starten". Das Feld "URL" bleibt dann unberücksichtigt.
  2. Sie spielen das Update direkt von der Projektfarm-Website ein. Markieren Sie hierzu "URL" und tragen Sie unter "URL" die URL des Updates ein. Klicken Sie dann auf "Installation starten". Das Feld "Datei" bleibt dann unberücksichtigt.

Wenn die Projektfarm GmbH einen MD5 zu dem jeweiligen Update bereitstellt, können Sie diesen in das Feld "MD5" kopieren. Das ISPConfig-System wird dann den MD5 des Updates mit dem MD5, den Sie eingegeben haben, vergleichen und so die Integrität des Updates checken. Sollten die MD5s nicht übereinstimmen, wird das Update nicht installiert.

3 Anbieter

Die Verwaltung der Anbieter erfolgt über den Gliederungsbaum. Jeder Anbieter/Reseller ist dort zweimal sichtbar:


3.1 Anbieter anlegen

Das Anlegen eines neuen Anbieters erfolgt in 5 Schritten.

1. Schritt: Formular "ISP Anbieter" öffnen

Klicken Sie auf die Schaltfläche "Anbieter neu".

Es erscheint das Formular "ISP Anbieter " mit der geöffneten Registerkarte "Stammdaten".


2. Schritt: Titel, Ordnungsplatz und Stammdaten zuweisen

3. Schritt: Speicherplatz, Webs, User und Domains limitieren

Klicken Sie auf die Registerkarte "Limits".


4. Schritt: Anbieter/Reseller-Zugangsdaten (Benutzername und Passwort) zuweisen

Klicken Sie auf die Registerkarte "Zugangsdaten".


5. Schritt: Speichern

Klicken Sie auf "Speichern".

3.2 Anbieterdaten bearbeiten

Öffnen Sie im Gliederungsbaum von ISPConfig den Ordner "Anbieter " und klicken Sie auf den Titel des Anbieters, so dass das ISP-Anbieter-Formular erscheint. Geben Sie die gewünschten Änderungen ein und klicken Sie dann auf "Speichern".

4 Serviceleistungen für Anbieter

4.1 Kunden

Eine Übersicht über die Kunden der Anbieter oder auch über Ihre eigenen Kunden erhalten Sie im Gliederungsbaum:


Die Anwendungen, die die Kunden betreffen, können ebenso von den Anbietern auf der ISPConfig-Anwenderebene vorgenommen werden. Sie werden hier daher nur kurz aufgeführt und sind entsprechend im II Handbuch für Anbieter/Reseller nachzulesen.

Folgende kundenbezogene Anwendungen können Sie vornehmen:

4.2 Webs verwalten

Die Verwaltung der Webs erfolgt über den Ordner "Webs" bei eigenen Webs bzw. über den Unterordner "Webs" bei den Anbietern/Resellern.

Die Anwendungen, die die Webs betreffen, können alle auch von den Anbietern bzw. z.T. auch von den Kunden vorgenommen werden. Sie werden daher hier nur kurz aufgelistet.

Anbieterebene:

Kundenebene:

4.3 DNS-Einträge

4.3.1 Primary-DNS-Einträge erstellen (im Handbuch für Anbieter/Reseller)

So erstellen Sie einen DNS-Eintrag für ein Web / eine Co-Domain.

1. Schritt: Web-Formular öffnen

Klicken Sie im Gliederungsbaum auf den entsprechenden Kunden, auf die Registerkarte "Webs" und auf die IP-Adresse des entsprechenden Webs.

Oder:

Öffnen Sie das Web für das Sie DNS-Einträge erstellt möchten, direkt im Gliederungsbaum (im Ordner Webs).

2. Schritt: Subdomain öffnen und aktivieren (optional)

Klicken Sie auf die Registerkarte "Co-Domain" und auf IP-Adresse der Subdomain.



3. Schritt: DNS aktivieren

Aktivieren Sie die Kontrollkästchen "Create DNS" und "Create DNS MX".


4. Schritt: Speichern

Klicken Sie auf "Speichern".

Mit Klicken in der Menüleiste auf den "DNS-Manager" ist das Web als neuer Eintrag sichtbar.

4.3.2 Secondary-DNS-Einträge (Slave Zone)

So erstellen Sie einen Secondary-DNS-Eintrag (Slave Zone):

1. Schritt: Slave Zone-Formular öffnen

Klicken Sie auf "Slave neu".

2. Schritt: Slave Zone erstellen

3. Schritt: Speichern

Klicken Sie auf "Speichern".

4.3.3 DNS-Einträge bearbeiten

So bearbeiten Sie DNS-Einträge:

Klicken Sie in der Menüleiste auf "DNS-Manager".

Klicken Sie im Gliederungsbaum auf den DNS-Eintrag, den Sie bearbeiten möchten.

5 Statistiken

Die ISPConfig-Statistiken umfassen Informationen zum Speicherplatzverbrauch und zum Traffic.

5.1 Anbieterstatistik

Statistiken über den Traffic, den Ihre Reseller auf dem Server verursacht haben, finden Sie als ISPConfig-Administrator, indem Sie in der Baumansicht den betreffenden Reseller auswählen.

Im sich öffnenden Formular "ISP Anbieter" finden Sie im Register "Statistik" Informationen über den Web-, Email- und FTP-Traffic des jeweiligen Resellers, aufgeschlüsselt nach den Kunden des Resellers.


5.2 Kundenstatistik

Die Kundenstatistik ist auch vom Anbieter/Reseller einsehbar und wird deshalb im Kapitel II-5.1 beschrieben.

5.3 Webstatistik

Die Webstatistik ist auch vom Anbieter/Reseller einsehbar und wird deshalb im Kapitel II-5.2 beschrieben.

5.4 Webalizer-Statistiken

Die Webalizer-Statistiken sind auch vom Anbieter/Reseller einsehbar und werden deshalb im Kapitel II-5.3 beschrieben.

6 Web-FTP/Passwortschutz von Verzeichnissen (.htaccess/.htpasswd)

Web-FTP wird in Kapitel III-4 behandelt.

7 Zusätzliche Software

Für das ISPConfig-System ist folgende zusätzliche Software verfügbar:

Die Software ist kostenlos auf der Projektfarm-Website erhältlich und kann problemlos über den Update-Manager installiert werden (vgl. Kapitel I-2.5). Nach der Installation können Sie beide Programme über die entsprechenden Links unter "Tools" aufrufen.

7.1 Webmail

Es handelt sich um das Webmail-Programm "Uebimiau". Weitere Informationen dazu finden Sie auf der folgenden Website: http://uebimiau.sourceforge.net/ .

Sie können das Webmail-Programm aufrufen über den Link unter "Tools" oder über den Ordner "webmail", der im Web des ISPConfig-Systems liegt, also https://www.domain.tld:81/webmail/, wobei www.domain.tld entsprechen zu ersetzen ist.

7.2 phpMyAdmin

Weitere Informationen zu phpMyAdmin finden Sie unter http://www.phpmyadmin.net/ .

Sie können phpMyAdmin aufrufen über den Link unter "Tools" oder über den Ordner "phpmyadmin", der im Web des ISPConfig-Systems liegt, also https://www.domain.tld:81/phpmyadmin/, wobei www.domain.tld entsprechen zu ersetzen ist.

Anhang

1 Starten/Stoppen des ISPConfig-Systems

Das ISPConfig-System kann manuell auf der Kommandozeile gestartet/gestoppt werden. Loggen Sie sich dazu als root ein und führen Sie den folgenden Befehl aus:

/etc/rc.d/init.d/ispconfig_server start|stop|restart (RedHat und Mandrake)

bzw.

/etc/init.d/ispconfig_server start|stop|restart (SuSE und Debian).

2 Starten/Stoppen von vsftpd

Wenn auf Ihrem System vsftpd als FTP-Server zum Einsatz kommt, wird dieser Dienst nach der Installation des ISPConfig-Systems nicht mehr über inetd/xinetd gestartet, sondern über den ISPConfig-eigenen ispconfig_tcpserver. Dies geschieht deshalb, um sicherzustellen, dass es auch unter vsftpd pro IP-Adresse einen Anonymous-FTP-Account geben kann. Unter inetd/xinetd könnte es nur einen Anonymous-FTP-Account pro Server geben, auch wenn dieser Server mehrere IP-Adressen besitzt. Um diesen Nachteil gegenüber proftpd auszugleichen, setzt das ISPConfig-System den ispconfig_tcpserver ein.

vsftpd kann über den folgenden Befehl gestartet oder gestoppt werden:

/etc/rc.d/init.d/ispconfig_tcpserver start|stop|restart (RedHat und Mandrake)

bzw.

/etc/init.d/ispconfig_tcpserver start|stop|restart (SuSE und Debian).

Wenn Sie proftpd als FTP-Server einsetzen, ändert sich nichts.

3 Cron Jobs

Die folgenden Cron Jobs werden vom ISPConfig-System durchgeführt:

Befehl Beschreibung Aufruf
/root/ispconfig/php/php /root/ispconfig/scripts/shell/logs.php &> /dev/null Auswertung der Apache-Logs für die ISPConfig-Traffic-Statistiken 23:59h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/ftp_logs.php &> /dev/null Auswertung der FTP-Logs für die ISPConfig-Traffic-Statistiken 23:59h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/mail_logs.php &> /dev/null Auswertung der Mail-Logs für die ISPConfig-Traffic-Statistiken 23:59h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/cleanup.php &> /dev/null Löschen der Backups von endgültig gelöschten Webs 23:59h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/webalizer.php &> /dev/null Erstellung der Webalizer-Statistiken 04:00h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/check_services.php &> /dev/null Dienste-Monitoring (vgl. I-2.4.2) alle 30 min.

4 Rechte von Ordnern in einem über das ISPConfig-System angelegten Web

In einem neuen Web finden Sie die folgenden Ordner mit den folgenden Rechten:

Wenn es für das Web noch keinen Administrator gibt (vgl. Kapitel III-2.2.1), gehören die Ordner standardmässig dem User, unter dem der Webserver läuft (hier "nobody"), ansonsten dem Administrator (in diesem Fall "web5_admin").

Die Gruppe der Ordner ist immer die Gruppe des jeweiligen Webs, in diesem Fall also "web5".

5 Manuelle Ergänzungen in Konfigurationsdateien

Ab Version 1.2.0 des ISPConfig-Managers können Sie in folgenden Konfigurationsdateien Ergänzungen von Hand vornehmen, ohne dass diese vom ISPConfig-System überschrieben werden:

Sie finden in diesen Dateien eine der folgenden Zeilen:

Nach dieser Zeile können Sie Ergänzungen von Hand vornehmen.

Ergänzungen für den virtuellen Host-Container eines Webs können vorgenommen werden über das Feld "Apache Direktiven (Optional)" im "Basis"-Register des entsprechenden Webs (vgl. Kapitel II-3.1).


Contents Next