Hinweis: Wir setzen im Folgenden eine funktionierende Web-Server-Installation mit php-Modul sowie mysql-Datenbank voraus. Die entsprechenden Informationen sind leicht im Internet zu finden.

Schritt 1: Archiv entpacken und Rechte setzen

Erstellen Sie ein Verzeichnis, in dem Sie das Tool installieren möchten. Dies kann zum Beispiel "/usr/local/conftool" sein, oder "/home/conftool".

Eine weitere Möglichkeit besteht unter Unix darin, einen eigenen User für das ConfTool einzurichten und für die Installation "~/conftool/" zu nehmen.

Gehen Sie nun in  das entsprechende Verzeichnis und entpacken Sie dort das Archiv, das die Dateien des Tools enthält, mit tar:

 > tar xvzf conftool-x.y.tgz

(Windows: Bitte verwenden Sie Winzip, Winrar oder ein ähnliches Werkzeug.

          Als Verzeichnis bietet sich z.B. C:\conftool\ an.)

Es werden dabei sieben Unterverzeichnisse erzeugt. Diese sind:

 install/ enthält Installations-Support
 etc/     enthält Konfigurationsdateien
 htdocs/  enthält über den Browser zugängliche Dateien
 lib/     enthält die Bibliotheken des ConfTools
 classes/ enthält die Klassen des ConfTools
 pages/   enthält die Webseiten
 uploads/ wird zur Speicherung von Beiträgen verwendet

Geben Sie bitte dem Webserver alle Dateirechte auf das Upload-Verzeichnis,

damit er dort von Benutzern übertragene Dokumente ablegen kann! Läuft der Webserver z.B. unter dem Benutzernamen "nobody", führen Sie folgende Befehle aus:

 > chown nobody uploads/
 > chmod u+rwx uploads/

(Wenn sie keine root-Rechte haben, verwenden Sie statt dessen "chmod a+rwx uploads/")

Außerdem benötigt der Webserver auf alle anderen Verzeichnisse (bis auf install/) Leseberechtigung.

Schritt 2: Webserver anpassen

Passen Sie die Konfiguration Ihres Webservers so an, dass das htdocs/-Verzeichnis von Webbrowsern aus erreichbar ist. Fügen Sie außerdem das etc/-Verzeichnis dem Suchpfad von PHP (php_include_path) hinzu.

Für den Apache-Server können die folgenden Anweisungen in der "httpd.conf"-Datei die benötigten Einstellungen setzen (die Datei kann beispielsweise in "/etc/apache2/httpd.conf" gefunden werden, dies hängt aber von Ihrer Server-Installation ab):

Alias /conftool "/home/conftool/htdocs/"

<Directory "/home/conftool/htdocs">

    Order deny,allow
    Allow from all
    Options Includes FollowSymLinks
    DirectoryIndex index.php
    php_value include_path ".:/home/conftool/etc"

# Einige PHP-Parameter, die entweder hier oder in der php.ini gesetzt werden müssen.
# Die Änderungen hier sind nur bei Apache 2 möglich!

    # Werte um den Upload großer Dateien zu ermöglichen:
    # Bis 10MB - etwas Luft lassen...
    php_value upload_max_filesize 11M

    # post_max_size muss auch entsprechend erhöht werden, da die Datei per POST übermittelt wird.
    php_value post_max_size 12M

    # Da PHP die Dateien entgegennimmt braucht es mehr Platz.
    php_value memory_limit 15M

    # 15min sollten in der Regel reichen. Ansonsten wird der Upload mit einem Timeout abgebrochen!
    php_value max_execution_time 900

    # Set the session timeout to 2 hours (7200s).
    php_value session.gc_maxlifetime 7200

    # Aus Sicherheitsgründen:
    php_value register_globals off

    # Wenn Sie Probleme mit dem Download von Dateien mit dem IE und SSL haben,
    # kann folgendes helfen:
    php_value session.cache_limiter public
    php_value session.cache_expire 5

</Directory>

Windows: Statt "/home/conftool/..." heißt es bei Ihnen "C:/conftool/...", z.B. Alias /conftool "C:/conftool/htdocs/"

<Directory "C:/conftool/htdocs">
    Order deny,allow
    Allow from all
    Options Includes FollowSymLinks
    DirectoryIndex index.php
    php_value include_path ".;C:/conftool/etc/"
(...siehe oben...)
</Directory>

Und last but not least muß der Webserver noch Dateien mit der Endung ".php" an den PHP-Interpreter übergeben, bevor er sie an den Browser ausliefert.

 AddType application/x-httpd-php .php

Wir empfehlen aus Sicherheitsgründen zudem die Erweiterungen .inc, .conf, .page, .lib und .ctcls hinzuzufpügen, aber dies ist nicht unbedingt notwendig. Wichtiger ist es, dass Sie den Zugriff auf Backup-Dateien sperren, wie z.B. "*.bak", "*.BAK" und "*~".

Es ist auch sinnvoll, die PHP-Konfiguration anzupassen, wenn beim Upload der Beiträge auch größere Dateien erlaubt sein sollen. Der Default hierfür ist je nach PHP-Version offensichtlich unterschiedlich.

Folgender Parameter in der php.ini-Datei (meistens in "/usr/local/lib/php.ini", "/etc/php.ini" oder "C:\windows\php.ini" zu finden) ist hierfür verantwortlich:

    upload_max_filesize 11M
    post_max_size 12M
    memory_limit 15M
    max_execution_time 900
    session.gc_maxlifetime 7200

Diese Einstellung bietet genügend Platz für Uploads von ca. 10MByte oder 15 Minuten Dauer und erhöhen das Timeout auf 2 Stunden. Wir empfehlen zudem, die zlib-compression zu aktivieren:

    zlib.output_compression = On

Schritt 3: Testen der Installation

Nach dem Neustart des Apache-Servers sollten Sie testen, ob die Einstellungen erfolgreich waren. Bitte geben Sie hierzu folgende Adresse im Browser ein:

http://www.yourdomain.org/conftool/info.php

Wichtige Hinweise:

• Aus Sicherheitsgründen müssen Sie die Datei "info.ph_" erst in "info.php" umbenennen. Sie finde die Datei im Verzeichnis "conftool/htdocs/".
• Bitte LÖSCHEN Sie die Datei htdocs/info.php nach Beendigung der Installation aus Sicherheitsgründen wieder.
• "www.yourdomain.org" ist natürlich der Domain Name Ihres Web-Servers und "conftool" ist der Directory-Alias, den Sie in der httpd.conf-Datei angegeben haben.

Sie sollten eine Übersichtsseite erhalten, anhand der Sie erkennen können, ob die Konfiguration erfolgreich war. Sollten einige php-Parameter nicht korrekt gesetzt sein (da Sie beispielsweise keinen Zugriff auf die Datei php.ini haben), so können Sie auch versuchen, diese in den Dateien "htdocs/.htaccess" und "htdocs/settings.php" einzustellen.

Schritt 4: Datenbank initialisieren

Für das ConfTool wird eine Datenbank benötigt sowie ein Datenbank-Benutzer, der alle Rechte für diese Datenbank hat. In der weiteren Beschreibung gehen wir davon aus, dass der Benutzername "confuser" und der Name der Datenbank "conference" lautet. Sie können diese Namen natürlich ändern, dafür ist es allerdings notwendig, das Installations-Skript für die Datenbank anzupassen.

Die folgende Beschreibung bezieht sich auf die Installation unter MySQL.

Zum Anlegen der Datenbank werden in der Regel Administrator-Rechte für das Datenbank-System benötigt.

Erzeugen Sie zuerst die neue Datenbank, und legen Sie einen neuen Benutzer in der Datenbank an. Dieser Benutzer benötigt alle Rechte für die neue Datenbank. Wir gehen davon aus, dass Webserver und MySQL auf dem gleichen System installiert sind, so dass Zugriff vom Rechner "localhost" aus gewährt wird. Falls der Web-Server auf einem anderen Rechner als die Datenbank läuft, sollten Sie hier statt "localhost" die IP-Adresse des Web-Servers angeben. Sie sollten auch ein entsprechendes Passwort wählen.

Die entsprechenden Kommandos sind in der Datei install/createDBUser.sql

zu finden. Nach dem Anpassen dieser Datei können Sie die Befehle folgendermaßen an die Datenbank übergeben:

> mysql -u root -p < install/createDBUser.sql

(Sie werden nach dem Passwort des root users der mysql-Datenbank gefragt.)

Anschließend führen Sie das beiliegende Initialisierungs-Skript auf der Datenbank aus (sie müssen das neue Passwort eingeben):

> mysql conference -u confuser -pconfpass < install/initdb.sql

Nun sollten sie die Default-Daten in die Datenbank einfügen:

> mysql conference -u confuser -pconfpass < install/defaultdata.sql

Die Datenbank ist jetzt fertig eingerichtet.

Schritt 5: ConfTool Basiskonfiguration

Der nächste Schritt ist die Konfiguration des ConfTools selbst, um es an ihre Gegebenheiten anzupassen. Alle Einstellungen werden in der Datei "etc/conftool.conf.php" vorgenommen und sind dort gut dokumentiert.

Hier muss beispielsweise der Installationspfad des ConfTools eingetragen werden.

Es ist vergleichsweise einfach, die Ausgabetexte anzupassen. Sie alle sind in einer Sprachdatei enthalten, die im Verzeichnis "etc/" liegt. Wurde etwa "german" als Sprache ausgewählt, heißt die entsprechende Datei "german.lang".

VORSICHT: Unsachgemäße Änderungen der Texte können leicht zu Problemen führen. Bitte ändern Sie daran nur in dringenden Fällen etwas, und testen sie die Änderungen gut.

Schritt 6: Seitenkopf und -fuss anpassen

Das ConfTool bietet Ihnen die Möglichkeit, einen Seitenkopf und einen Seitenfuss einzubinden, die auf allen Seiten eingefügt werden. Dies kann einfaches HTML, aber auch PHP-Code sein. Die beiden Dateien, die dazu erändert werden können, liegen im "etc/"-Verzeichnis und heissen siteheader.inc" und "sitefooter.inc". Passen Sie diese Dateien an, um das Tool designerisch in Ihre Webseite einzufügen.

Zudem sollten Sie die Bild-Datei "logo.gif" im "htdocs/"-Verzeichnis durch das Logo Ihrer Konferenz ersetzen. Empfohlene Breite: ca. 50-150 Pixel, Höhe: 30-60 Pixel. Die Datei "logo-invoice.gif" sollte ebenfalls angepasst werden; sie erscheint auf den Rechnungen rechts oben und ist in der Regel das Logo des verantwortlichen Veranstalters.

Es ist möglich, die Farbgebung des Tools zu verändern. Für die Darstellung werden ausschließlich Cascading Style Sheets verwendet, deren Definition sich in "htdocs/conftool.css" findet. Allerdings ist eine solche Anpassung sicherlich komplexer als es zuerst erscheinen mag.