Website einrichten
  ==================

Admin Alfred will für User Ulrich eine Website zur Domain example.net
anlegen.



  0. Inhalt
  ---------
    1. Webuser anlegen
    2. Ordner anlegen 
    3. Apache konfigurieren
    4. Website aktivieren
    5. Website deaktiveren
    6. PHP einrichten
    7. Kontakt




  1. Webuser anlegen
  ------------------

Sofern noch nicht vorhanden, wird zunächst ein neuer User angelegt, mit dem
Ulrich seine Seite verwalten kann. Der Webuser hat das Prefix "www-", also
in unserem Fall www-ulrich. <uid> und <gid> werden aus dem Bereich des
Admins alfred gewählt. Irgendwas, was noch nicht benutzt wurde.


    groupadd -g <gid> www-ulrich
    useradd -u <uid> -g www-ulrich -c "Web User for Ulrich" \
            -d /home/www/alfred/ulrich/ www-ulrich



  2. Ordner anlegen
  -----------------

DocumentRoot (da, wo die HTML Dateien hinkommen):
  /home/www/$ADMIN/$USER/$DOMAIN

  Beispiel: 
     mkdir -p -m 775 /home/www/alfred/ulrich/example.net/
     chown -R www-ulrich.www-ulrich /home/www/alfred/ulrich

Logfiles
  /var/log/apache2/$ADMIN/$USER/$DOMAIN

  Beispiel:
     mkdir -p -m 2750 /var/log/apache2/alfred/ulrich/example.net
     chown -R root.www-ulrich /var/log/apache2/alfred/ulrich/example.net

   

  3. Apache konfigurieren
  -----------------------

Alfred legt in /etc/apache2/sites-available/alfred/ eine Datei example.net
an. Als Grundlage dient die Datei /etc/apache2/sites-available/_template_.

Darin tauscht er alle Pfade und Namen gegen sinnvolle Werte aus.

   * ServerName + ServerAlias
   * ErrorLog + CustomLog     - auf den unter 2. eingerichteten Pfad setzen
   * SuexecUserGroup          - wird nur für CGIs gebraucht; 
                                sonst: Zeile auskommentieren/löschen
   * DocumentRoot             - auf den unter 2. eingerichteten Pfad setzen
   * Directory                - gleicher Wert wie DocumentRoot
   * ScriptAlias,             - nur wenn PHP verwendet werden soll (s.u.)
     AddHandler, Action       

!! ACHTUNG !! 
Bei den Pfaden immer /var/www/... verwenden und nicht /home/www/... 

Das sind effektiv die gleichen Ordner (/var/www wird über mount bind
eingehängt) aber der suexec-Mechanismus braucht unbedingt /var/www/ als
Prefix.



  4. Website aktivieren
  ---------------------

Es sind nur die Websites aktiv, die unter /etc/apache2/sites-enabled
verlinkt sind. Wir müssen also einen Link setzen:

    cd /etc/apache2/sites-enabled/
    ln -s ../site-available/alfred/example.net .

Das war's. Jetzt den Apache restarten.

    /etc/init.d/apache2 restart

Nachgucken, ob der Apache auch wirklich läuft, z.B. http://dolly.gnuher.de/
abfragen.



  5. Website deaktiveren
  ----------------------

Einfach in /etc/apache2/sites-enabled/ den Link löschen und den Apache neu
starten.



  6. PHP einrichten
  -----------------

Ist ausführlich in "PHP einrichten.howto.txt" erklärt



  7. Kontakt
  ----------

Achim Settelmeier <kb-apache@m1.sirlab.de>


2005-04-17, settel