# Installieren von more.groupware

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.

## Systemvoraussetzungen

Um more.groupware zu installieren benötigen Sie mindestens folgende Software, unabhängig vom Betriebssystem.

- Einen Webserver (wir empfehlen Apache)

- PHP 4.1 oder neuer mit XML Unterstützung

- Einen Datenbankserver (MySQL oder PostgreSQL 7.x)

- "session.auto_start" muss in PHP deaktiviert sein

Stellen Sie sicher, dass ein . (Punkt) im PHP include_path steht. Prüfen und ändern Sie dies in `php.ini` falls nötig.

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 `extension=php_gd.dll` in der `php.ini` auskommentieren.

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.

Versuchen Sie more.groupware mit den Einstellungen `register_globals = Off` laufen zu lassen, selbiges gilt für `magic_quotes_gpc` und `magic_quotes_runtime`, beides sollte deaktiviert sein. Diese Einschränkungen sind aber nicht sehr restriktiv.

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.

Setup prüft all diese und weitere Punkte und meldet eventuelle Fehler.

## Update

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.

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.

Wenn Sie dennoch ein Update versuchen wollen, finden Sie im Anhang weitere Informationen dazu.

## So kommen Sie zu more.groupware

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.

### Herunterladen einer freigegebenen Version

Dies ist die empfohlene Vorgehensweise für die meisten Benutzer. Sie können entweder über die Downloadseite von moregroupware.org oder über die Dateiauswahl von sourceforge.net die letzte freigegebene Version beziehen.

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).

### Herunterladen von more.groupware Schnappschüssen

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 Schnappschuss Seite von more.groupware.org. Seien Sie vorsichtig damit, es sei denn wir empfehlen es Ihnen, mit auftretenden Problemen könnten Sie alleine dastehen.

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

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

### Herunterladen von more.groupware über CVS

Sie können more.groupware direkt über CVS (Concurrent Versions System, www.cvshome.org 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 die CVS-Seite von more.groupware bei SourceForge.net.

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 Vorbereitungen auf das Setup von more.groupware weiter.

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:

- Installieren von Apache, MySQL, PHP und more.groupware unter Linux

- Installieren von more.groupware unter MacOS X Server (externe Site!)

- Installieren von Apache, MySQL, PHP und more.groupware unter Windows

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 Installationsvorgang.

## Vorbereitungen auf das Setup von more.groupware

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

Fahren Sie fort mit der Installationsroutine.

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 Absichern der more.groupware Installation!

## Fehlerbehebung

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

Sie können eine der Mailinglisten abonnieren und über den more.groupware IRC Channel (irc.freenode.net, #moregroupware) oder über die Sourceforge Projektseite Fehler melden und Anfragen bezüglich Fehlern stellen.

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.

## Bekannte Fehler

### Webmail 2

Wenn Sie versuchen, E-Mails mit großen Anhängen zu empfangen, könnten Sie eine Zeitüberschreitung wie folgt hervorrufen:

    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

Eine unschöne Methode, um diesen Fehler zu beheben ist, die Datei `/modules/webmail2/inc/class.pop3.inc` zu öffnen. Um die Zeile 14 herum finden Sie folgende Einstellung:

      var $TIMEOUT    = 60; // Default timeout before giving up on a network operation.

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

Wenn Sie eine Fehlermeldung bezüglich des Arbeitsspeichers ähnlich

      Fatal error: Allowed memory size of 8388608 bytes exhauste (tried to allocate 8192
      bytes) in ...

bekommen, müssen Sie den Wert für das Limit für den Arbeitsspeicher in der php.ini die Höhe setzen.

      memory_limit = 8M ; Maximum amount of memory a script may consume (8MB)

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.

### Ungewöhnliches Verhalten von more.groupware

Überprüfen Sie in der Konfigurationsdatei `php.ini`, ob folgende Einstellungen, wie schon vorher beschrieben, in Ordnung sind:

    include_path = "."
    register_globals = On

Wenn Sie gerade die Datei `php.ini` bearbeiten, sollten Sie gleich weitere Einstellungen vornehmen:

      	 display_errors = Off
      	 error_reporting = E_ALL ~ E_NOTICE
      	 log_errors = On
      	 error_log = /var/log/php.log

Stellen Sie sicher, dass der Webserver Schreibrechte für diese Datei besitzt. So werden alle Fehler und Warnungen in diese Datei geschrieben und nicht im Browser ausgegeben.

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.

Wenn Sie Probleme mit den Grafiken oder der Login Seite bekommen, kann es auch helfen, wenn Sie der Datei `config.inc.php`:

      $appconf["rooturl"] = "http://localhost/moregroupware";

auf

      $appconf["rooturl"]="http://".$_SERVER["HTTP_HOST"]."/moregroupware";

abändern.

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.

Lösung: Werfen Sie einen Blick auf die Datei `config.inc.php` im Installationsverzeichnis und kontrollieren Sie die Variablen:

    $appconf["rooturl"] = ...
    $appconf["rootpath"] = ...

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

Eine weitere Möglichkeit wäre, wenn Sie:

    $appconf["rooturl"] = "http://localhost/moregroupware";

auf

    $appconf["rooturl"]="http://".$_SERVER["HTTP_HOST"]."/moregroupware";

ändern.