$Id: INSTALL_de.txt,v 1.2 2005/04/18 16:38:44 mdruilhe Exp $

======================================================

Installationsanleitung fr w-agora 4.2.x       DEUTSCH

	Deutsh translations by Karel Vejsada

======================================================

                     Teil I.  -  Server

Zielgruppe: Internet Service Provider; Virtual Server Betreiber;
            Anwender, die einen eigenen Server betreiben

Diese Installation nehmen Anwender vor, die Foren in eigener Regie und auf dem 
eigenen Server betreiben wollen oder Provider, welche die Installation von 
w-agora fr den Kunden auf dem providereigenen Server vornehmen.

------------------------------------------------------

Sie bentigen:

   -- PHP 4.1 oder hher,
   -- Datenbanksoftware 
       MySQL                oder
       postgres (6 oder 7)  oder
       Oracle 8             oder
       MS SQL Server 7

------------------------------------------------------

              VOR DER INSTALLATION AUF DEM SERVER

1. Datenbank einrichten

Sie mssen eine Datenbank erstellen. Die Anweisung drfte am Beispiel von MySQL 
folgendermaen aussehen:

         mysqladmin -uuser -ppassword create <db_name>

wobei <db_name> fr den frei whlbaren Namen der Datenbank steht.

.......................................................

2. Benutzer einrichten

Sie bentigen einen Benutzer der Datenbank, der Verwalter (super user) von 
w-agora sein soll. Die Vergabe der Rechte geschieht mit Hilfe der Anweisung 
GRANT auf der Ebene der Datenbank-Administration. Sie mssen als Super User der 
Datenbank (oft "root") angemeldetsein.

Beispiel:   GRANT all ON <db_name>.* TO <user>@localhost
                      IDENTIFIED BY <userpsw>;

oder (besser) abgeschwcht

            GRANT select, insert, update, create, alter, drop
                      ON <db_name>.* TO <user>@localhost
                      IDENTIFIED BY <userpsw>;

Der Benutzer <user> wird hiermit eingerichtet und erhlt das Anfangspasswort 
<userpsw>. Der Hostname ist standardmig "localhost".

-------------------------------------------------------

                  INSTALLATION AUF DEM SERVER

In Abhngigkeit vom Server und dem Datenbanksystem knnen sich abweichende 
Anweisungen ergeben. Hier wird das prinzipielle Vorgehen dokumentiert und mit 
Beispielen illustriert.

.......................................................

1. w-agora laden und entpacken

Whlen Sie ein Verzeichnis, in dem Sie das Archiv w-agora unterbringen. Sei der 
Name des Unterverzeichnisses, in dem sich das Archiv befindet, z. B. /tmp. Das 
Zielverzeichnis kann beispielsweise das Ausgangsverzeichnis der Web-Dokumente 
sein, also /html 

a)  Unter Linux bieten sich die Kommandos
    
          $ chdir /var/www/html
          $ tar -xzvf /tmp/w-agora-4.2.x.tar.gz
    
    an. Somit wird w-agora im Unterverzeichnis "w-agora" auf dem 
    Server dekomprimiert abgelegt.

b)  Unter Windows gengt es, das Dekomprimieren mit Hilfe von
    "winzip" oder "whaver" zu bewerkstelligen.

Im weiteren Text wird davon ausgegangen, dass "w-agora" der Name des 
Verzeichnisses mit dem enpackten Programm ist.

.......................................................

2. Dateieigenschaften festlegen

w-agora wird mit drei fast leeren Unterverzeichnissen ausgeliefert bzw. legt 
beim Entpacken die nachstehenden Unterverzeichnisse an:

            ".../w-agora/conf"
            ".../w-agora/forums"
            ".../w-agora/forums/agora"

In diesen Verzeichnissen befinden sich nur Dateien mit dem Standardnamen 
".htaccess". Diese Dateien werden von einigen Servern, u. a. von Apache 
bentigt, um das jeweilige Verzeichnis vor unbefugten Zugriffen zu schtzen.

w-agora benutzt diese Verzeichnisse, um verschiedene Dateien zu speichern, etwa 
Konfigurations- und Vorlagendateien. Sollten die Verzeichnisse beim 
Dekomprimieren nicht angelegt worden sein, so mssen sie jetzt manuell erstellt 
werden. Die Zugriffseigenschaften dieser Verzeichnisse sollten auf "707" gesetzt 
werden.

Ferner muss sichergestellt werden, dass der Benutzer, unter dem der Web-Server 
luft, schreibenden Zugriff hat.

a) Linux/Unix - Installation: Sei "nobody" der Name des Benutzers,
        unter dem der Web-Server luft. Dann setzen Sie die
        Kommandos
                     $ chown -R nobody ./w-agora
                     $ chgrp -R nobody w-agora
                     $ chmod -R g+w w-agora
         
        oder, falls Sie nicht den Root-Zugriff haben, den Befehl

                     $ chmod -R nobody conf forums forums/agora

        ab.

b) Windows - Installation: Vergeben Sie entsprechend die
        Schreib-/Leserechte. 

.......................................................

3. Safe Mode beachten

Die meisten Server sind so eingerichtet, dass PHP im sog. Safe Mode luft. Dies 
bringt eine Einschrnkung mit sich: Verzeichnisse knnen via PHP nur von ihren 
Eigentmern beschrieben werden.

Der Eigentmer eines Verzeichnisses ist der Benutzer/die Task, 
der/die das Verzeichnis angelegt hat.

Whrend der Installationsroutine "setup.php" oder "setup.php3" werden weitere 
Unterverzeichnisse angelegt, die w-agora zur Verwaltung von Foren und Beitrgen 
bentigt, es sei denn, dass diese Verzeichnisse bereits existieren.

Der PHP-Interpreter luft unter einem internen Benutzer- /Tasknamen. Dieser Name 
ist vom Namen des Benutzers, der w-agora angelegt hat, i. d. R. verschieden. 

Mge beispielsweise der PHP-Interpreter unter dem Tasknamen "phprunner" 
ablaufen, whrend der Benutzer, der w-agora installiert, dies unter der Kennung 
"agoraboss" tut. Dann muss der Benutzer "agoraboss" die bentigten 
Unterverzeichnisse im w-agora Baum anlegen bevor das Setup-Programm gestartet 
wird. Andernfalls wird "phprunner" die Verzeichnisse kreieren, als deren 
Eigentmer eingetragen werden und der Benutzer "agoraboss" bekommt unter PHP 
keinen Zugriff auf die Foren.

Daher mssen die nachstehenden Verzeichnisse vom Benutzer "agoraboss" (s. obiges 
Beispiel) erstellt werden:

        .../w-agora/forums/agora

sowie fr jede Forengruppe (Site) mit dem Namen <sitename> und fr jedes Forum 
mit dem Namen <forumname> in der Forengruppe <sitename> 

        .../w-agora/forums/<sitename>
        .../w-agora/forums/<sitename>/default
        .../w-agora/forums/<sitename>/<forumname>
        .../w-agora/forums/<sitename>/<forumname>/notes

Die Zugriffseigenschaften der Verzeichnisse sollten auf "707" gesetzt werden.

Das manuelle Anlegen dieser Verzeichnisstruktur ist auch spter erforderlich, 
wenn weitere Forengruppen oder Foren erzeugt werden.

.......................................................

4. Softwareinstallation

Rufen Sie Ihren Browser auf mit der URL

         http://localhost/w-agora/setup.php 
   oder
         http://localhost/w-agora/setup.php3

In dem anschlieenden Dialog mssen Sie die Felder wie folgt versorgen:

a) Datenbankinformation

   Datenbank: Es ist der Name, der bei der Einrichtung der Datenbank
              vergeben wurde. Der symbolische Name war <db_name> - 
              s. Abschnitt "Vor der Installation" Ziffer 1.

   User:      Es ist der Name des Datenbankbenutzers <user> wie
              im Abschnitt "Vor der Installation" Ziffer 2 definiert.

   Password:  Es ist das <userpsw> wie im Abschnitt "Vor der
              Installation" Ziffer 2 vergeben.

   Hostname:  Der Name ist der Name, blicherweise "localhost", oder            
    die IP-Nr. des Servers, auf dem die Datenbank luft.

   Port:      Die Portnummer lautet blicherweise "". Sie wird nur
              von MySQL oder postgres oder bei Nicht-Standard-                  
    Installationen abgefragt.

b) Verzeichnisse

   Falls noch nicht manuell geschehen, werden whrend des Laufs
   des "setup.php"-Scripts Verzeichnisse fr Forengruppen und
   Foren angelegt. 

   Diese Verzeichnisse mssen so angelegt sein, dass der Benutzer,
   unter dessen Kennung der Server / der PHP-Interpreter luft,
   Schreibrechte hat. 

   Anm.: Diese Verzeichnisse KNNEN ausserhalb des Verzeichnis-
         baums von w-agora bzw. des Web-Verzeichnisbaums liegen,
         um sie vor Benutzern besser zu schtzen, die nicht ber
         das w-agora Script zugreifen.

c) Standard-Suchmaschine

   w-agora kann innerhalb der Forenbeitrge nach Strings suchen.
   Hier geben Sie ein, welche Suchmaschine verwendet werden soll.
   Die bernahme des voreingestellten Wertes "NONE" bewirkt, dass
   die Suche ber die Datenbanksoftware erfolgt.

d) Administrator von w-agora

   Der reservierte Name des Administrators von w-agora lautet
   "admin". Unter dieser Kennung kann sich der Administrator 
   anmelden, um Forengruppen, Foren, Benutzer, Beitrge zu
   verwalten oder die Scripts anzupassen.

   Das Passwort des Benutzers "admin" und seine E-Mail Adresse
   mssen ebenso hier erfasst werden.

.......................................................

5. Forengruppen (Sites) einrichten

Eine Forengruppe besteht aus einem oder mehreren Foren. Eine Forengruppe hat 
einen eigenen Datenbankzugang und eine eigene Benutzergruppe.

Es ist mglich, Forengruppen in der selben Datenbank anzulegen, in der die 
Hauptinstallation erfolgte. In diesem Falle mssen die im Teil 4 
"Softwareinstallation" eingegebenen Datenbank-Parameter auch fr die Forengruppe 
verwendet werden.

Wird eine andere Datenbank benutzt, so muss sie vorher angelegt werden.

Darber hinaus werden die nachstehenden Parameter versorgt:

a) Site Identifikation

   Die Identifikation besteht aus einem Namen, einem Titel und einer
   Beschreibung der Forengruppe.

b) Datenbankparameter

   Dies sind: Der Name der Datenbank, der Datenbankbenutzer, das
   Passwort, der Hostname und die Portnummer.

c) Forenverzeichnisse

   Fr jedes der Foren muss ein eigenes Verzeichnis angelegt werden.
   Existiert das Verzeichnis noch nicht, so wird agora es erzeugen.

   Falls das Verzeichnis bereits angelegt wurde, muss der Benutzer,
   unter dessen Kennung PHP luft, Schreibrechte erhalten.

   Sie KNNEN die Forenverzeichnisse ausserhalb des Web-Verzeichnis-
   Baums anlegen, um einen besseren Schutz zu gewhrleisten.

d) Suchmaschine

   Sie knnen die Standard-Suchmaschine angeben. Wird die Standard-
   Voreinstellung "NONE" akzeptiert, so erfolgt die Suche mit Hilfe
   der Datenbanksoftware.

e) Foren-Vorlage

   Hier wird die Standard-Vorlage angegeben, die fr die spter
   anzulegenden Foren benutzt wird (s. Schritt 6). 

Nachdem eine Forengruppe angelegt wurde, knnen 

   -- einzelne Foren angelegt werden,
   -- die Forengruppe administriert werden,
   -- eine weitere Forengruppe angelegt werden

.......................................................

6. Forum anlegen

Ein Forum wird mit Hilfe des Scripts "create_forum.php" oder "create_forum.php3" 
erzeugt. Folgen Sie den Hinweisen des Installationsschrittes.

Sie werden aufgefordert, folgende Parameter zu versorgen:

a) Forumidentifikation

   Sie besteht aus dem Namen, dem Titel und der Beschreibung des
   Forums.

b) Vorlage / Thema

   Sie knnen das Thema bernehmen, welches Sie bei der Deklaration
   der Forengruppe angegeben haben, oder ein anderes Thema eingeben.

   Die Vorlage fr die usserliche Gestaltung des Forums kann
   entweder von der Definition im Schritt 5 bernommen werden,
   oder sie kann forenspezifisch angegeben / ausgewhlt werden.

Sobald ein Forum kreiert ist, kann es administriert werden, es kann ein anderes 
Forum kreiert werden oder das Forum kann benutzt werden.

.......................................................

Damit ist die Installation beendet. Jetzt knnen beliebige Benutzer gem der 
Forumspezifikation (ffentlich, registriert, eingeschrnkt, privat) ihre 
Beitrge einstellen.

Anzumerken ist, dass die Verwaltung der Forenbenutzer dem System w-agora 
obliegt. Das Programm unterscheidet zwischen Forenbenutzern und dem (einzigen) 
Datenbankbenutzer <user>, ber den die Forenbenutzer indirekt Beitrge 
einstellen und/oder lesen.

.......................................................

			Administration

Die Administration nach der Installation erfolgt ber den Aufruf

     "http://localhost/w-agora/admin.php"

vom Browser aus.

=======================================================

                     Teil II.  -  Client

Zielgruppe: Anwender, die auf einem externen Server ber einen
            Internet Service Provider ihre Foren betreiben wollen.

Diese Anwender unterscheiden sich von der im Teil I. beschriebenen Gruppe darin, 
dass sie selbst keinen Server administrieren, sondern die Nutzungsrechte 
erwerben. Die Administration des Servers obliegt dem Provider.

-------------------------------------------------------

Sie bentigen:

   -- Eine eigene Homepage (symbolischer Name <MyHomepage>)
   -- Plattenspeicher auf dem Server
   -- PHP-Nutzungsrechte auf dem Server
   -- Nutzungsrechte an der Datenbanksoftware auf dem Server
   -- FTP - Berechtigung fr den Server

Der Vertrag mit Ihrem Provider muss alle diese Leistungen umfassen. 

Der Provider wird Ihnen mitteilen, welches Ihr "Homeverzeichnis" auf dem Server 
ist und wie Ihr "Document Root"- Verzeichnis heisst. Meistens wird "Document 
Root" unter dem Namen "html" eingerichtet.

Ferner erhalten Sie eine Benutzerkennung fr die Nutzung der vereinbarten 
Dienste, den Namen der Datenbank, die fr Sie eingerichtet wurde, sowie den 
Web-FTP-Zugang.

Je nach Provider knenn Sie u. U. einige Namen selbst vergeben. Passworte, die 
fr die Nutzung der Dienste erforderlich sind, knenn Sie selbst bestimmen und 
spter auch ndern.

-------------------------------------------------------

       VOR DER INSTALLATION AUF DEM SERVER (vom Client aus)

1. Datenbank beantragen

Erfragen Sie Ihren Datenbanknamen beim Provider. Sei der Name der Ihnen zur 
Verfgung stehenden Datenbank symbolisch als <db_name> gekennzeichnet.

Das auf dem Server befindliche Datenbanksystem muss eines der Programme
             
       MySQL                oder
       postgres (6 oder 7)  oder
       Oracle 8             oder
       MS SQL Server 7

sein. Andernfalls ist z. Zt. kein Betrieb von w-agora mglich.

.......................................................

2. Datenbankbenutzer beantragen

Erfragen Sie bei Ihrem Provider die Benutzerkennung fr die Datenbank <db_name>. 
Mge der Name symbolisch <user> lauten. Oft werden Sie auch das Passwort des 
<user> von Ihrem Provider erhalten. Mge das Passwort <userpsw> lauten. 

Mit Hilfe der Administrationssoftware (oft ist es "phpMyAdmin") knenn Sie das 
Passwort Ihrer Datenbank verndern.

.......................................................

3. Hostnamen erfragen

Erfragen Sie bei Ihrem Provider, unter welchem Namen der Server betrieben wird. 
Meistens lautet der Name "localhost".

-------------------------------------------------------

          INSTALLATION AUF DEM SERVER (vom Client aus)

.......................................................

1. w-agora laden und entpacken

bertagen Sie per Download das w-agora Archiv von der w-agora Homepage auf Ihren 
Client und entpacken Sie die Software in ein Anfangsverzeichnis.

Beim Expandieren werden unterhalb des Zielverzeichnisses automatisch 
Unterverzeichnisse angelegt.

.......................................................

2. w-agora zum Server bertragen

Melden Sie sich auf dem Server unter Ihrem vom Provider mitgeteilten 
Benutzernamen an.

Starten Sie den vom Provider bereitgestellten FTP-Zugang oder  benutzen Sie 
einen FTP-Client Ihrer Wahl.

Legen Sie im Verzeichnis "html" das Unterverzeichnis "w-agora" an.

Kopieren Sie mit Hilfe der FTP-Software den gesamten entpackten w-agora 
Verzeichnisbaum von Ihrem Client zu dem Verzeichnis "html/w-agora" auf dem 
Server.

.......................................................

3. Verzeichnisse anlegen

Legen Sie MIT HILFE IHRER FTP-SOFTWARE auf dem Server die Unterverzeichnisse

    "/html/w-agora/conf"
    "/html/w-agora/forums"
    "/html/w-agora/forums/agora"

an. Ferner legen Sie fr jede zu erstellende Forengruppe (symbolischer Name 
<sitename>) und fr jedes in dieser Forengruppe enthaltene Forum (symbolischer 
Name <forumname>) MIT HILFE IHRER FTP-SOFTWARE auf dem Server weitere 
Unterverzeichnisse an:

     "/html/w-agora/forums/<sitename>"
     "/html/w-agora/forums/<sitename>/default"
     "/html/w-agora/forums/<sitename>/<forumname>"
     "/html/w-agora/forums/<sitename>/<forumname>/notes"

Es ist wichtig, dass diese Verzeichnisse manuell unter Ihrer Benuzterkennung 
angelegt werden. Sollten Sie zu einem spteren Zeitpunkt Ihre Foren oder 
Forengruppen erweitern wollen, so mssen Sie vorher die zugehrigen 
Verzeichnisse nach dem gleichen Schema manuell enlegen.

w-agora prft vor der Softwareinstallation, ob diese Verzeichnisse vorhanden 
sind. Ist dies nicht der Fall, so werden sie von w-agora erzeugt. Das wrde dazu 
fhren, dass Sie mglicherweise keinen Zugang zu Ihrer Software erhalten, 
nmlich dann, wenn der PHP-Interpreter im sog. Safe Mode luft. Das ist fast 
immer der Fall.

Detailliertere Angaben ber den Safe Mode befinden sich im Teil I.

Die Eigenschaften der Verzeichnisse sollen auf "707" gesetzt werden. Dies 
geschieht entweder mit Ihrer FTP-Zugangssoftware oder direkt mit dem Aufruf des 
FTP-Clients auf dem Server.

Die Anweisungen fr den FTP-Client auf dem Server lauten:

   $ ftp <Ihr.ftp.site.name>
   ftp> chdir w-agora
   ftp> mkdir conf
   ftp> quote site chmod 707 conf
   ftp> mkdir forums
   ftp> quote site chmod 707 forums
   ...

.......................................................

4. Softwareinstallation

Rufen Sie Ihren Browser auf mit der URL

         http://www.<MyHomepage>.<dom>/w-agora/setup.php 
   oder
         http://www.<MyHomepage>.<dom>/w-agora/setup.php3

wobei <dom> fr die Hauptdomain (com, net, de, ch, at, info, ...) steht, in der 
Sie Ihre Homepage registriert haben.

Verfahren Sie genau so, wie es im Teil I. ab der Ziffer 4 beschrieben ist. 

Lediglich bei der spteren Administration mssen Sie den Aufruf ber den 
"localhost" durch den Aufruf ber das Web ersetzen.

========================================================
