<?xml version="1.0" encoding="iso-8859-1"?>
<chapter id="setup_intro">
  <title>Installieren von more.groupware</title>
  
  <para>Die Installation von more.groupware wird in diesem und dem folgenden
    Kapitel beschrieben. Sie sollten dieses Kapitel lesen um über die
    Systemvoraussetzungen und benötigten Kenntnisse Bescheid zu wissen.
    Danach folgen Sie den Anweisungen abhängig Betriebssystem, auf dem
    Sie more.groupware installieren möchten.
  </para>
  
  <section id="setup_intro_requirements">
    <title>Systemvoraussetzungen</title>
    
    <para>Um more.groupware zu installieren benötigen Sie mindestens
      folgende Software, unabhängig vom Betriebssystem.
    </para>
    
    <itemizedlist>
      <listitem>
        <para>Einen Webserver (wir empfehlen Apache)</para>
      </listitem>
      <listitem>
        <para>PHP 4.1 oder neuer mit XML Unterst&uuml;tzung</para>
      </listitem>
      <listitem>
        <para>Einen Datenbankserver (MySQL oder PostgreSQL 7.x)</para>
      </listitem>
      <listitem>
        <para>"session.auto_start" muss in PHP deaktiviert sein</para>
      </listitem>
    </itemizedlist>
    
    <para>Stellen Sie sicher, dass ein . (Punkt) im PHP include_path steht. 
         Prüfen und ändern Sie dies in <filename>php.ini</filename> falls nötig. 
    </para> 
    
    <para>Wenn Sie GANTT Diagramme im Modul Projekte nutzen wollen, muss
      die GD Grafikbibliothek in PHP aktiviert sein. Unter Windows müssen
      Sie dazu nur den Eintrag <literal>extension=php_gd.dll</literal> in der
      <filename>php.ini</filename> auskommentieren.
    </para>
    
    <para>Wir beabsichtigen, in Zukunft weitere Datenbanken zu unterstützen.
      Derzeit sind Sie mit MySQL am besten aufgehoben, die Unterstützung für
      PostgreSQL wird laufend verbessert (die Kernmodule sollten funktionieren).
      Weitere Datenbanken folgen.
    </para>
    
    <para>Versuchen Sie more.groupware mit den Einstellungen
      <literal>register_globals = Off</literal> laufen zu lassen,
      selbiges gilt für <literal>magic_quotes_gpc</literal> und
      <literal>magic_quotes_runtime</literal>, beides sollte deaktiviert sein.
      Diese Einschränkungen sind aber nicht sehr restriktiv.
    </para>
    
    <para>Die Unterstützung für XML oder PDF muss nicht in PHP einkompiliert sein,
      auch nicht für IMAP. Diese Erweiterungen werden über PHP-eigene Bibliotheken
      angesprochen. Es schadet aber nicht, diese Bibliotheken in PHP einkompiliert
      zu haben.
    </para>

    <para>Setup prüft all diese und weitere Punkte und meldet eventuelle Fehler.</para>    
  </section>
  
  <section id="setup_intro_upgrade">
    <title>Update</title>
    
    <para>Wenn Sie auf eine neuere Version von more.groupware umsteigen möchten,
      ist es empfehlenswert, dies über eine Neuinstallation zu erledigen.
      Für ein Update benötigen Sie erweiterte Kenntnisse über SQL, um eventuell
      abgeänderte Datenbankstrukturen anzupassen.
    </para>
    
    <para>Wir arbeiten an einer automatischen Updatefunktion, die
      nach ihrer Fertigstellung zur Verfügung gestellt wird. Trotzdem empfehlen
      wir Ihnen wärmstens eine Neuinstallation in eine leere Datenbank.    
    </para>
    
    <para>Wenn Sie dennoch ein Update versuchen wollen, finden Sie im
      <link linkend="appendix_upgrade">Anhang</link> weitere
      Informationen dazu.
    </para>
    
  </section>
  
  <section id="setup_intro_download">
    <title>So kommen Sie zu more.groupware</title>
    
    <para>Ob Sie more.groupware unter Windows, Unix oder Mac installieren
      wollen - von irgendwo müssen Sie die Software bekommen.
      Es gibt mehrere Wege, more.groupware zu beziehen.
    </para>
    
    <section id="setup_intro_download_releases">
      <title>Herunterladen einer freigegebenen Version</title>
      
      <para>Dies ist die empfohlene Vorgehensweise für die meisten
        Benutzer. Sie können entweder über die
        <ulink url="http://www.moregroupware.org/downloads.php">
        Downloadseite von moregroupware.org</ulink> oder über die
      <ulink url="http://sourceforge.net/project/showfiles.php?group_id=32034">
      Dateiauswahl von sourceforge.net</ulink> die letzte
      freigegebene Version beziehen.
  </para>
  
  <para>Es stehen zwei verschiedene Archivtypen zur Auswahl: ZIP Archive
    und mit GZip komprimierte TAR Archive. Für eine Installation unter
    Windows sollten Sie das ZIP Archiv herunterladen, ansonsten
    das TAR Archiv. Normalerweise kann Windowssoftare (wie z.B. Winzip)
    auch mit TAR Archiven umgehen. Bis auf den persönlichen Vorzug
    unterscheiden sich die Archivformate nur im Zeilenumbruch
    (\n mit TAR, \r\n mit ZIP).</para>
</section>

<section id="setup_intro_download_snaps">
  <title>Herunterladen von more.groupware Schnappschüssen</title>
  
  <para>Wenn Sie immer am neuesten Stand sein möchten, aber nicht über
    CVS auf den aktuellen Code zugreifen können oder möchten, haben Sie
    die Möglichkeit, die nächtlich erstellten Schnappschüsse herunterzuladen,
    diese finden Sie auf der <ulink url="http://www.moregroupware.org/snapshots.php">
    Schnappschuss Seite von more.groupware.org</ulink>.
    Seien Sie vorsichtig damit, es sei denn wir empfehlen es Ihnen, mit auftretenden
    Problemen könnten Sie alleine dastehen.
</para>

<note>
  <para>Wenn über längere Zeit keine neue Freigabe stattgefunden hat, sollten
    Sie zu einem Schnappschuss greifen. Aber Sie sollten wissen, was Sie tun.
  </para>
</note>

<para>Schnappschüsse sind nur als TAR Archive, komprimiert mit GZip, verfügbar.
  Normalerweise kann Windowssoftware wie Winzip problemlos damit umgeben. 
</para>
</section>

<section id="setup_intro_download_cvs">
<title>Herunterladen von more.groupware über CVS</title>

<para>Sie können more.groupware direkt über CVS (Concurrent Versions System,
  <ulink url="http://www.cvshome.org/">www.cvshome.org</ulink> für weitere Informationen)
  brandaktuell herunterladen. Sie müssen wissen, dass diese Versionen noch instabiler als
  die Schnappschüsse sein können. Sind Sie sich sicher? Lesen Sie <ulink url="http://sourceforge.net/cvs/?group_id=32034">die CVS-Seite von more.groupware bei SourceForge.net</ulink>.
</para>

</section>

</section>

<section id="setup_intro_lampwamp">

<para>Sie haben bereits einen Webserver, eine Datenbank und PHP lauffähig?
Sie trauen es sich zu, die Meldungen und Tipps der Setup-Routine zu verstehen?
Lesen Sie bei <link linkend="setup_intro_preparation">Vorbereitungen auf das Setup von more.groupware</link> weiter.</para>

<para>Sie benötigen eine  Webserver, eine Datenbank und PHP. Die meisten
Linux-Distributionen bringen alle nötigen Pakete mit, sie müssen lediglich
über den Paktmanager der Distribution installiert werden.
Darüber hinaus finden sich zahlreiche LAMP/WAMP-Installations-Tutorials
im Internet. Es geht sogar noch einfacher, lesen Sie bei Bedarf diese Anhänge:</para>

<para><itemizedlist>
<listitem>
<para>
  <link linkend="appendix_lamp">Installieren von Apache, MySQL, PHP und more.groupware unter Linux</link>
</para>
</listitem>
<listitem>
<para>
  <ulink url="http://www.afp548.com/Articles/Jaguar/moregroupware.html">Installieren von more.groupware unter MacOS X Server (externe Site!)
</ulink>

</para>
</listitem>
<listitem>
<para>
  <link linkend="appendix_wamp">Installieren von Apache, MySQL, PHP und more.groupware unter Windows</link>
</para>
</listitem>
</itemizedlist>
</para>

<para>Lesen Sie das folgende Kapitel, das Ihrem Betriebssystem entspricht.
  Die folgenden Kapitel beschreiben den Installationsvorgang verschieden detailliert.
  Verwenden Sie jene Ausführung, die Ihnen am meisten zusagt. Während der Installation
  kommen Sie zu einem Punkt, wo die eigentliche Installationsprozedur
  beginnt. Diese ist in einem eigenen Kapitel genau beschrieben, unter
  <link linkend="setup_setup">Installationsvorgang</link>.
</para>
</section>

<section id="setup_intro_preparation">
<title>Vorbereitungen auf das Setup von more.groupware</title>

<para>Nachdem Sie more.groupware nach den oben genannten Anleitungen
    heruntergeladen haben, geben Sie dem Webserver Schreibrechte f&uuml;r
    das Wurzelverzeichnis von und erstellen einen Datenbankbenutzer, &uuml;ber
    den more.groupware auf die Datenbank zugreift. Sie k&ouml;nnen sogleich
    eine neue Datenbank anlegen, oder die Installationsroutine erledigt dies
    f&uuml;r Sie - wie Sie m&ouml;chten.
</para>

<para>Fahren Sie fort mit der <link linkend="setup_setup">Installationsroutine</link>.</para>

<important>
<para>Nachdem Sie den Installationsvorgang abgeschlossen haben, folgen Sie
  wieder den betriebssystemspezifischen Anweisungen und versichern Sie sich,
  dass Sie keinen der Schritte übersehen haben. Danach gehen Sie über zum Schritt
  <link linkend="setup_security">Absichern der more.groupware Installation</link>!
</para>
</important>
</section>

<section id="setup_intro_troubleshooting">
<title>Fehlerbehebung</title>

<para>Wenn Sie während der Installation auf einen Fehler stoßen sollten,
  besuchen Sie die Hilfeseiten auf der Homepage von more.groupware.
  <ulink url="http://www.moregroupware.org/support.php">
  http://www.moregroupware.org/support.php
</ulink>
</para>

<para>Sie können eine der Mailinglisten abonnieren und über den
  more.groupware IRC Channel (irc.freenode.net, #moregroupware)
  oder über die <ulink url="https://sourceforge.net/projects/moregroupware/">
  Sourceforge Projektseite</ulink> Fehler melden und
  Anfragen bezüglich Fehlern stellen.
</para>

<para>Bedenken Sie, dass more.groupware ein Open Source Projekt ist
  und kein kommerzielles Produkt! Erwarten Sie keine allzu umfangreichen
  Hilfestellungen der Entwickler, die dies alles in ihrer Freizeit leisten.
</para>

</section>

<section id="setup_intro_known_bugs">
<title>Bekannte Fehler</title>

<section id="setup_intro_known_bugs_webmail2">
<title>Webmail 2</title>

<para>Wenn Sie versuchen, E-Mails mit großen Anhängen zu empfangen,
  könnten Sie eine Zeitüberschreitung wie folgt hervorrufen:
<programlisting>
Fatal error: Maximum execution time of 60 seconds exceeded in  c:\web\moregroupware\modules\webmail2\inc\class.pop3.inc on line 418
Fatal error: Maximum execution time of 60 seconds exceeded in c:\web\moregroupware\modules\webmail2\inc\pear.php on line 498
</programlisting>
</para>

<para>Eine unschöne Methode, um diesen Fehler zu beheben ist,
  die Datei <filename>/modules/webmail2/inc/class.pop3.inc</filename>
  zu öffnen.
  Um die Zeile 14 herum finden Sie folgende Einstellung:
  <programlisting>
  var $TIMEOUT    = 60; // Default timeout before giving up on a network operation.
  </programlisting>
</para>

<para>Wenn Sie einen Wert zwischen 60 und 250 wählen sollte
  diese Zeitüberschreitung nicht mehr so leicht auftreten.
</para>

<para>Wenn Sie eine Fehlermeldung bezüglich des Arbeitsspeichers ähnlich
  <programlisting>
  Fatal error: Allowed memory size of 8388608 bytes exhauste (tried to allocate 8192 
  bytes) in ...
  </programlisting>
  bekommen, müssen Sie den Wert für das Limit für den Arbeitsspeicher
  in der php.ini die Höhe setzen. 
  <programlisting>
  memory_limit = 8M ; Maximum amount of memory a script may consume (8MB)
  </programlisting>
</para>

<para>Erhöhen Sie diesen Wert auf 16MB oder mehr, abhängig von der Größe
  der E-Mails die Sie bekommen. Meistens ist die Größe sowieso vom Mailserver
  beschränkt, z.B. 10MB bei gmx.
  Dies ist notwendig, da das Webmail Modul die E-Mails zuerst komplett im
  Arbeitsspeicher zwischenspeichern muss, bevor es auf der Festplatte
  gespeichert werden kann. Ein E-Mail mit 5MB Größe belegt im Arbeitsspeicher
  etwa 10-15MB.
</para>
</section>

<section id="setup_intro_known_bugs_misc">
<title>Ungewöhnliches Verhalten von more.groupware</title>

<para>Überprüfen Sie in der Konfigurationsdatei <filename>php.ini</filename>,
  ob folgende Einstellungen, wie schon vorher beschrieben, in Ordnung sind:
<programlisting>
include_path = "."
register_globals = On
</programlisting>
</para>

<para>Wenn Sie gerade die Datei <filename>php.ini</filename> bearbeiten, 
    sollten Sie gleich weitere Einstellungen vornehmen: 
  	 <programlisting>
  	 display_errors = Off
  	 error_reporting = E_ALL ~ E_NOTICE
  	 log_errors = On
  	 error_log = /var/log/php.log
  	 </programlisting>
    Stellen Sie sicher, dass der Webserver Schreibrechte f&uuml;r diese Datei besitzt.
    So werden alle Fehler und Warnungen in diese Datei geschrieben und nicht im 
    Browser ausgegeben.
</para>

<para>Es erscheint die Login Seite anstatt der Daten, die Sie erwartet hätten:
  Der Internet Explorer 6 kann in Zusammenhang mit more.groupware ein seltsames
  Verhalten an den Tag bringen. Manchmal hilft es, einfach die temporären
  Internetdateien zu löschen. Nach einer solchen Aktion läuft more.groupware
  wieder für eine Weile.
</para>

<para>Wenn Sie Probleme mit den Grafiken oder der Login Seite bekommen,
  kann es auch helfen, wenn Sie der Datei
  <filename>config.inc.php</filename>:
  <programlisting>
  $appconf["rooturl"] = "http://localhost/moregroupware"; 
  </programlisting>
  auf 
  <programlisting>
  $appconf["rooturl"]="http://".$_SERVER["HTTP_HOST"]."/moregroupware"; 
  </programlisting>
  abändern.
</para>

<para>Sie haben eine falsche Adresse in der Datei config.inc.php:
  Sie haben more.groupware installiert und sich erfolgreich
  angemeldet. Ein anderer Benutzer im Netzwerk versucht sich anzumelden,
  bekommt aber beim Anmelden nicht die richtige Seite angezeigt und
  die Anmeldung schlägt fehl.
</para>

<para>Lösung: Werfen Sie einen Blick auf die Datei
  <filename>config.inc.php</filename> im Installationsverzeichnis
  und kontrollieren Sie die Variablen: 
 <programlisting>
$appconf["rooturl"] = ...
$appconf["rootpath"] = ...
</programlisting>
</para>

<para>
Wenn <literal>$appconf["rooturl"]</literal> in etwa
<literal>http://localhost/moregroupware/</literal> oder
<literal>http://127.0.0.1/moregroupware/</literal> lautet, müssen Sie
<literal>localhost</literal> oder <literal>127.0.0.1</literal> gegen
Ihren Servernamen oder Ihre IP Adresse ändern, damit more.groupware
im Netzwerk erreichbar ist.
</para>

<para>Eine weitere Möglichkeit wäre, wenn Sie:
<programlisting>
$appconf["rooturl"] = "http://localhost/moregroupware";
</programlisting>
auf
<programlisting>
$appconf["rooturl"]="http://".$_SERVER["HTTP_HOST"]."/moregroupware";
</programlisting>
ändern.
</para>

</section>

</section>

</chapter>
