=pod =head1 NAME wwwAdmin - A system for configuring virtual Apache web servers =head1 SYNOPSIS # No options required, the system is managed via a menu wwwAdmin =head1 Apache Wizard Menu Beim Start des Apache Wizard Menues werden folgende Optionen zur Verfuegung gestellt. =head2 1) Host Menu Hier werden Hosts konfiguriert (siehe Host Administration) =head2 2) Apache Wizard Preferences Hier wird die globale Konfiguration mittels folgender Optionen festgelegt: =over 4 =item U Base Directory of Apache Wizard Verzeichnis in dem die Daten ueber Hosts, Server, etc... abgelegt werden. =back =head1 Host Administration Die Administration der Hosts ist vom gleichen Ablauf wie die Administration weiterer Punkte. =head2 Attribute eines Hosts =over 4 =item short descriptive name Eindeutiger Name, der dem Host zugeordnet ist. Falls Sie einen neuen Host anlegen wollen der den selben Namen hat wie ein bereits vorhandener, wird ein Fehler ausgeloest. Beispiel: wwwhost1 =item informative description Beschreibung des Hosts. Beispiel: My webserver machine =item architecture Die Host Architektur. Beispiel: linux-i586 =item DNS name or ip address Gueltige IP Adresse oder DNS name des Hosts. Falls eine ungueltiger DNS Name oder IP Adresse eingegeben wird, wird ein Fehler ausgeloest. Beispiel: iss12.neckar-alb.de =back =head2 1) Create a new Host - Neuen Host anlegen. Attribute fuer den neuen Host eingeben. Informationen ueber die Attribute befinden sich weiter unten. Danach erhalten sie folgende Auswahl =over 4 =item 1) Save these settings Den neuen Host abspeichern =item 2) Return to Host menu/Top menu Zum Hostmenue bzw. zum Startmenue zurueckkehren =back =head2 2) Modify an existing Host - Vorhandenen Host modifizieren Hier muessen Sie zuerst einen vorhanden Host auswaehlen, der geaendert werden soll. Danach wird dieser geladen und kann mittels der Eingabemaske, die auch zum Anlegen von Hosts verwendet wird, abgeandert und anschliessend gespeichert werden. Hier verhaelt sich bis auf die Hostauswahl alles genau wie beim Anlegen von Hosts. =head2 3) Server Menu Hier gelangen Sie zum Server Menu. (Naehres siehe unten) =head2 4) Delete an existing host - Einen Host loeschen Hier werden Sie mittels einer Auswahlliste gebeten eine Host auszuwaehlen. Anschliessend wird dieser geladen und dessen Daten werden angezeigt. Nun gibt es drei Moeglichkeiten fortzufahren. =over 4 =item Yes, delete it Den Host loeschen, aber das Datenverzeichnis in dem sich die alle Daten die zu diesem Host gehoeren, nicht loeschen. =item Yes, delete it, including data directory Dasselbe wie oben, wobei aber das Datenverzeichnis auch geloescht wird. =item Return to Host Menu/Top Menu Zu dem Host Menu bzw. zu dem Anfangsmenue zurueckkehren ohne den Host oder dessen Datenverzeichnis zu loeschen. =back =head2 98) Return to Top Menu Zum Startmenue zurueckkehren. =head1 Server Menu Hier werden die WWW server konfiguriert. Beim Anlegen eines neuen Servers wird automatisch ein Virtueller Server angelegt der den angelegten WWW server beschreibt. Beim anlegen des Virtuellen Severs wird automatisch ein Directory angelegt, dass das Root Verzeichnis des virtuellen Servers beschreibt. Naeheres in der Sektion VirtualServer Menu und Directory Menu. Im folgenden werden nur noch die Attribute beschrieben. Die Menupunkte und deren Funktion ist analog zum Host Menu. =head2 Attribute eines Servers =over 4 =item Server descriptive name. Eindeutiger Name des Servers (analog zu Hosts) =item Server DNS name or IP adress DNS Name oder IP Adresse des Servers, analog zu Hosts. =item Default directory for VirtualServers Standardprefix fuer die Rootverzeichnisse der virtuellen Sever. Zum Beispiel '/usr/local/www'. Beim Anlegen eines virtuellen Servers 'www.test.de' wird dann als root verzeichnis '/usr/local/www/www.test.de' vorgeschlagen.. Naeheres finden Sie in der Sektion VirtualServer Menue. =item Server administrator Email adresse des Webmasters des Webservers. =item HTTP, HTTPS Port Default HTTP bzw HTTPS Port der als Standard fuer die virtuellen Server verwendet wird. =back =head1 VirtualServer Menu Hier werden die virtuellen Webserver administriert. Die Menuoptionen und der Verlauf ist analog zu dem Server Menu. Lediglich die Attributseingabe erfolgt in zwei Schritten, wobei nach dem ersten Schritt abgebrochen werden kann. Beim Anlegen eines neuen virtuellen Webservers wird automatisch ein Verzeichnis angelegt, dass das root Verzeichnis des angelegten virtuellen Webservers entspricht, Naehres finden sie im Abschnitt Directory Menu. =head2 Attribute eines virtuellen Webservers =over 4 =item DNS name or IP address Gueltiger DNS name oder IP Adresse (siehe analoge Attribute fuer Hosts, Server) =item Server type Hier koennen Sie den Servertyp einstellen, die Auswahl besteht aus 'http', 'https' oder 'both'. Falls 'https' oder 'both' ausgewaehlt wird, hat das zur Folge das als HTTP version HTTP/1.0 automatisch eingestellt wird. Falls 'http' ausgewaehlt wird hat man die Moeglichkeit zwischen HTTP/1.0 oder HTTP/1.1 auszuwaehlen. =item Virtual WWW server root directory Das root Verzeichnis des virtuellen Webservers. =item Virtual WWW server admin Email adresse des Webmasters. =item HTTP port HTTP Port auf den der virtuelle Server hoeren soll, falls nichts eingegeben wird, wird der des Servers, zu dem dieser virtuelle Webserver gehoert, verwendet. =item HTTPS port Nur falls 'https' oder 'both' als 'Server type' ausgewaehlt wurde. Analog zu HTTP port. =item HTTP version Nur falls 'http' als 'Server type' ausgewaehlt wurde. =item Virtual WWW server interface number Eine eindeutige interface Nummer (Ganzzahl) des virtuellen Webservers. Die Eingabe kann leergelassen werden falls 'http' als 'Server type' und HTTP/1.1 als 'HTTP version' ausgwaehlt wurde. =item DirectoryIndex, Options Analog zu den entsprechenden Apache Konfigurationsoptionen (wird mit sinvollen defaults vorbelegt) =item Enable PCGI/EP/SSI Hier koennen Sie einstellen ob der virtuelle Webserver PCGI, EP oder SSI (Server Side Includes) unterstuetzen soll. =back =head1 Directory Menu Hier werden die Verzeichnisse der virtuellen Webserver administriert. =head2 Attribute eines Directory. =over 4 =item Directory pathname Eindeutiger Pfad des Directory, relativ zum root Verzeichnis des dazugehoerigen virtuellen Webservers. =item Directory redirect url Falls das Verzeichnis ein redirect beschreiben soll, muessen Sie hier die Redirect-Url (Die Url worauf dieses Directory redirected wird) angeben. =item User who owns that directory Falls Sie keine Redirect-Url eingegeben haben, muessen Sie hier einen gueltigen User eingeben, der der Besitzer dieses Verzeichnis sein soll. =item Group that owns that directory Optionale Eingabe einer gueltigen Gruppe, der dieses Verzeichnis gehoert. =back =head1 AUTHORS AND COPYRIGHT This module is Copyright (C) 1999 Jochen Wiedmann Am Eisteich 9 72555 Metzingen Germany Email: joe@ispsoft.de Phone: +49 7123 14887 and Amarendran R. Subramanian Grundstr. 32 72810 Gomaringen Germany Email: amar@ispsoft.de Phone: +49 7072 920696 All Rights Reserved. You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file. =cut