<?xml version="1.0" encoding="iso-8859-1"?>
<chapter id="appendix_wamp">
  <title>Installieren von Apache, MySQL, PHP und moregroupware unter Windows</title>
  
  <section id="appendix_wamp_intro">
    <title>Einführung</title>
    
    <para>Für eine stabile Verwendung von empfehle ich
      Ihnen, moregroupware unter Linux zu betreiben.
      Aber es ist ebenfalls möglich, moregroupware
      unter Windows zu installieren. Ich habe moregroupware
      erfolgreich unter Windows NT, Windows 2000, Windows XP und
      sogar Windows 9x, zwar nicht so stabil, getestet.
    </para>
    
    <para>Vergessen Sie nicht, ein temporäres Verzeichnis
      (<filename>tmp</filename>) auf der Systempartition (C:) einzurichten.
      Wenn dieses nicht vorhanden ist, können in Verbindung mit PHP eigenartige
      Fehler auftreten, weil als Standard in der <filename>php.ini</filename>
      dieses Verzeichnis als temporäres Verzeichnis für z.B.
      Sessions verwendet wird.
    </para>
    
    <para>Natürlich können Sie diese Einstellung ändern und ein anderes
      temporäres Verzeichnis verwenden (session.save_path = /tmp).
    </para>
  </section>
  
  <section id="appendix_wamp_download">
    <title>Herunterladen von moregroupware</title>
    
    <para>Für moregroupware benötigen Sie folgende Software auf
      Ihrem "Server":
    </para>
    
    <itemizedlist>
      <listitem>
        <para>Apache Webserver</para>
      </listitem>
      <listitem>
        <para>PHP4 (serverseitige Scriptsprache)</para>
      </listitem>
      <listitem>
        <para>MySQL Datenbank</para>
      </listitem>
      <listitem>
        <para>Und natürlich moregroupware</para>
      </listitem>
    </itemizedlist>
    
    <para>Zuerst sollten Sie die benötigten Programmpakete
      in ein temporäres Verzeichnis herunterladen:
    </para>
    
    <itemizedlist>
      <listitem>
        <para>Apache: Laden Sie Apache (zum Beispiel
        apache_1.3.27-win32-x86-no_src.exe) von
        <ulink url="http://www.apache.org/dist/httpd/binaries/win32/">
        http://www.apache.org/dist/httpd/binaries/win32/</ulink> herunter.
      </para>
    </listitem>
    <listitem>
      <para>PHP4: Laden Sie das PHP-4.2.x-Win32.zip Paket von
      <ulink url="http://www.php.net/downloads.php">
      http://www.php.net/downloads.php</ulink> herunter.
    </para>
  </listitem>
  <listitem>
    <para>MySQL: Laden Sie  mysql-3.23.xx-win.zip (stable) von
    <ulink url="http://www.mysql.com/downloads/">
    http://www.mysql.com/downloads/</ulink> herunter.
  </para>
</listitem>
<listitem>
  <para>moregroupware: Auf der Seite
    <ulink url="http://www.moregroupware.org/download.php">
    http://www.moregroupware.org/download.php</ulink>
    finden Sie die aktuelle Version von moregroupware.
</para>
</listitem>
</itemizedlist>

<para>Um die neueste Version von moregroupware zu erhalten,
  sollten Sie diese mit WinCVS herunterladen. Eine Anleitung für
  WinCVS finden Sie am Seitenende unter
  <ulink url="http://www.moregroupware.org/download.php">
  http://www.moregroupware.org/download.php</ulink>.
</para>

<para>Wenn Sie dies für schwierig erachten, können Sie die letzten
  stabilen Schnappschüsse von <ulink url="http://www.moregroupware.org/snapshots.php">
  http://www.moregroupware.org/snapshots.php</ulink> herunterladen.
</para>

<para>Gut, nun haben Sie die benötigten Dateien auf Ihrem Computer,
  jetzt können wir mit der Installation von moregroupware beginnen.
</para>

</section>

<section id="appendix_wamp_apache">
<title>Installieren des Apache Webservers</title>

<note>
<para>Zur Zeit ist es nicht empfehlenswert, Apache in der Version
  2.0.x zu verwenden. Ich habe einige eigenartige Probleme in
  Verbindung mit PHP und moregroupware bekommen, zum Beispiel
  hat der Browser des öfteren gemeint, er kann die Seite nicht anzeigen
  oder im Webmail2 Module konnten keine Bilder in eingehenden E-Mails
  angezeigt werden.
</para>

<para>Die Kombination von Apache 2.0.x und PHP ist derzeit noch
  ziemlich instabil. Sie sollten Apache 1.3.x noch den Vorzug
  geben und für ein noch ein bisschen warten.
</para>

<para>moregroupware sollte mit PHP 4.1.x problemlos laufen.
  PHP 4.0.x ist nicht aufgrund von Sicherheitslücken und Fehlern
  nicht verwendet werden.
</para>
</note>

<para>Zuerst beginnen wir mit der Installation des Apache Webservers.
  Dies ist mit dem Assistenten sehr einfach zu schaffen.
</para>

<para>Starten Sie die Installaton, gehen Sie zum nächsten Schritt
  über und stimmen Sie der Lizenz zu, nochmals weiter und weiter.
  Jetzt kommen die interessanten Servereinstellungen:
</para>

<itemizedlist>
<listitem>
<para>Domäne: Wählen Sie Ihre Domäne nach belieben aus,
  wenn Sie moregroupware nur innerhalb Ihres Netzwerks verwenden,
  zum Beispiel meinedomain.at.
</para>
</listitem>
<listitem>
<para>Servername: Geben Sie den Namen Ihres Windowsrechners hier ein.
  Es sollte der Name sein, mit dem Sie mit den anderen Computern im
  Netzwerk kommunizieren (zum Beispiel PC1). Wenn Sie unsicher sind,
  können Sie localhost eintragen.
</para>
</listitem>
<listitem>
<para>E-Mail des Administrators: Ihre E-Mail Adreses 
</para>
</listitem>
</itemizedlist>

<para>Klicken Sie auf weiter, wählen Sie eine Komplettinstallation,
  danach weiter und akzeptieren den voreingestellten Installationspfad.
  Für etwaige Änderungen können Sie später die Konfigurationsdatei
  httpd.conf editieren. Unter "Start" -> "Programme" -> "Apache HTTP Server"
  -> "Apache konfigurieren" finden Sie die Möglichkeit dazu. 
  </para>

<para>Nach der Installation finden Sie im Startmenü eine Programmgruppe
  namens "Apache HTTP Server" mit den Konfigurationsmöglichkeiten,
  den Server zu starten, stoppen, neuzustarten.
</para>

<para>Geben Sie nun in Ihrem Browser http://localhost/ oder
  http://ihren_pc_namen/ (den Namen, den Sie bei der Installation
  vergeben haben). Sie sollten nun eine Testseite sehen, die über
  die erfolgreiche Installation des Webservers informiert.
</para>

<para>Einige Änderungen in der Konfiguration des Webservers werden
  wir später vornehmen, jetzt installieren wir erst einmal PHP.
</para>

</section>

<section id="appendix_wamp_php">
<title>Installieren von PHP</title>

<itemizedlist>
<listitem>
<para>Entpacken Sie das PHP Archiv nach C:\php.
  Dazu benötigen Sie <ulink url="http://www.powerarchiver.com/">
  Powerarchiver </ulink> oder <ulink url="http://www.winzip.com/">
  Winzip</ulink> oder ein ähnliches Programm.
</para>
</listitem>
<listitem>
<para>Wechseln Sie im Windows Explorer in das Verzeichnis
  <filename>C:\php</filename>
</para>
</listitem>
<listitem>
<para>Benennen Sie die Datei <filename>php.ini-dist</filename>
  nach <filename>php.ini</filename> um und öffnen Sie sie in
  einem Editor, zum Beispiel im Windows Editor.
</para>
</listitem>
<listitem>
<para>
  Erstellen Sie den Ordner <filename>C:\web</filename>,
  der das Dokumentenverzeichnis des Webservers wird.
</para>
</listitem>
<listitem>
<para>Sie müssen zwei Änderungen in dieser Datei durchführen:
  <literal>doc_root</literal> müssen Sie in 
  <literal>doc_root = "c:\web" </literal>
  und <literal>extension_dir</literal> in
  <literal>extension_dir = "c:\php\extensions" </literal>
  ändern.
</para>
</listitem>
<listitem>
<para>Speichern Sie die Änderungen.</para>
</listitem>
</itemizedlist>

<para>Sollten Probleme mit der Integration von PHP in Apache
  auftauchen, kopieren Sie die 
  <filename>php.ini</filename> und <filename>php4ts.dll</filename>
  in Ihr Windows Verzeichnis (<filename>C:\winnt</filename> oder
  <filename>C:\windows</filename>).
</para>

<para>Oder Sie müssen den "Include Path" von Windows in der
  <filename>php.ini</filename> von <literal>
  ;include_path = ".;c:\php\includes"</literal>
  zu <literal>include_path = "."</literal>
  (Entfernen Sie das Semikolon (;) und fügen Sie zumindest einen Punkt 
  (.) als include_path ein) ändern.
</para>

<para>Ebenso müssen an der Konfiguration von Apache Änderungen
  vorgenommen werden, dass PHP funktioniert.
  Öffnen Sie die Datei <filename>C:\web\Apache\conf\httpd.conf</filename>
  in einem Editor und führen Sie folgenden Änderungen durch:
<programlisting><![CDATA[
DocumentRoot "C:/web"

<Directory "C:/web">]]>
      </programlisting>
    Verwenden Sie / (forward slash) und nicht \ (backslash)!</para>
    
    <para>Suchen Sie die Zeile <literal>AddType application/x-tar .tgz</literal>
      und fügen Sie darunter
      <programlisting>
        ScriptAlias /php4/ "c:/php/"
        AddType application/x-httpd-php .php
        AddType application/x-httpd-php .php3
        AddType application/x-httpd-php .php4
        Action application/x-httpd-php "/php4/php.exe"
      </programlisting>
      hinzu.
    </para>
    
    <para>Damit nicht der Verzeichnisinhalt gelistet, sondern die Datei
      <filename>index.php</filename> ausgeführt wird, fügen Sie
      <filename>index.php</filename> zum
      <literal>DirectoryIndex</literal> Parameter hinzu:
      <programlisting>
        DirectoryIndex index.html index.php
      </programlisting>
    </para>
    
    <para>Speichern Sie die Änderungen und starten Sie den Apache Webserver
      neu, um die Änderungen zu übernehmen.
    </para>
    
    <para>Nach dem Neustart des Apache Webservers können Sie eine Testdatei
      erstellen, um zu sehen, ob PHP richtig läuft.
      Legen Sie eine Datei mit dem Inhalt
      <programlisting><![CDATA[<?php phpinfo(); ?>]]>
</programlisting>
an und speichern Sie diese unter <filename>C:\web</filename> als
<filename>test.php</filename>.
</para>

<para>Öffnen Sie mit Ihrem Browser nun diese Datei unter
<literal>http://localhost/test.php</literal> oder
<literal>http://ihre_ip_adresse/test.php</literal>.
Es sollte nun eine Menge an Informationen über Ihre
Installation erscheinen.
</para>

<section id="appendix_wamp_php_module">
<title>Installieren von PHP als Apache Modul</title>

<para>Soeben haben wir PHP über CGI in den Server eingebunden.
Um zum Beispiel einen Geschwindigkeitsvorteil zu bekommen,
können wir PHP direkt in Apache einbinden.
Um dies zu tun müssen Sie wieder die http.conf öffnen und die unten
genannten Zeilen
<programlisting>
ScriptAlias /php4/ "c:/php/"
AddType application/x-httpd-php .php
AddType application/x-httpd-php .php3
AddType application/x-httpd-php .php4
Action application/x-httpd-php "/php4/php.exe"
</programlisting>
durch diese ersetzen:
<programlisting>
LoadModule php4_module c:/php/sapi/php4apache.dll
AddModule mod_php4.c
AddType application/x-httpd-php .php
</programlisting>
</para>

<para>
Sie müssen nun die Datei <filename>php4ts.dll</filename> von
<filename>C:\php</filename> nach
<filename>C:\windows\system32</filename> (oder
<filename>C:\winnt\system32</filename>) verschieben.
Ebenso sollte die Datei <filename>php.ini</filename>
nach <filename>C:\windows</filename> (oder
<filename>C:\winnt</filename>) verschoben werden. Starten
Sie den Apache Webserver neu um die Änderungen zu übernehmen.
</para>

</section>
</section>

<section id="appendix_wamp_mysql">
<title>Installieren von MySQL</title>

<para>Entpacken Sie das MySQL Archiv in ein temporäres Verzeichnis
und starten Sie den Installationsassistenten mit Setup.exe.
Belassen Sie die Standardeinstellungen so, wie sie sind und
führen die Installation durch.
</para>

<para>Der Datenbankserver wird normalerweise automatisch
mit dem Betriebssystem mitgeladen. Sie können ihn aber auch
mit dem Programm Winmysqladmin.exe aus dem \bin Verzeichnis
des Installationsverzeichnisses starten
</para>

<para>Wenn MySQL läuft, sehen Sie ein grünes Licht rechts unten bei
der Systemuhr. Wenn Sie sich zum ersten Mal mit Winmysqladmin
an der Datenbank anmelden, werden Sie nach einem Benutzernamen
und Passwort gefragt. Stimmen Sie zu, dieses zu speichern,
ansonsten werden Sie bei jedem Start von Windows danach gefragt.
</para>
</section>

<section id="appendix_wamp_mgw">
<title>Installieren von moregroupware</title>

<para>Entpacken Sie das moregroupware Archiv in den Ordner
<filename>C:\web\moregroupware</filename>. In diesem Ordner
finden Sie weitere Unterordner (docs, include, modules etc.) und ebenso
die Datei <filename>index.php</filename>.
</para>

<para>Nun ist es an der Zeit, eine neue Datenbank anzulegen,
wo moregroupware in Zukunft seine Daten abspeichern kann.
Starten Sie Winmysqladmin und Wählen Sie "Databases" aus.
Drücken Sie die rechte Maustaste im weißen Datenbankfenster
und wählen Sie "Create Database" aus. Benennen Sie Ihre
Datenbank (zum Beispiel MGW) und wählen Sie "Create Database".
Minimieren Sie das Programm Winmysqladmin.
</para>

<para>Öffnen Sie mit Ihrem Browser die Seite
<literal>http://ihre_ip_adresse/moregroupware/setup/index.php</literal>.
Wählen Sie die Sprache, in der Sie moregroupware installieren möchten
und klicken Sie auf weiter. Nun folgt eine Seite mit einigen Konfigurationsmöglichkeiten, hier finden Sie eine 
<link linkend="setup_setup">ausführlich Installationsanleitung</link>.
</para>
</section>

<section id="appendix_wamp_troubleshooting">
<title>Weiterführende Hilfe</title>

<para>Mehr über die Installation von Apache, PHP und MySQL erhalten Sie
unter <ulink url="http://www.net-language.com/workshops/Default.asp?Workshop=21&amp;step=1">
http://www.net-language.com/workshops/Default.asp?Workshop=21&amp;step=1
</ulink>
</para>

</section>

</chapter>
