Installationsanleitung

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. Dies sind:

install/  enthält Installations-Hinweise und Skripte

etc/      enthält Konfigurationsdateien

uploads/  wird zur Speicherung von Beiträgen verwendet

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

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 sind _hier_ aber nur bei Apache 2 möglich!

    # 15min sollten in der Regel reichen. Ansonsten werden z.B. Bulk-Mails mit einem Timeout abgebrochen.
    php_value max_execution_time 900

    # Aus Sicherheitsgründen:
    php_value register_globals off

    # Bei Problemen mit dem IE und Downloads unter SSL
    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

Zudem sollten Sie den Zugriff auf Backup-Dateien sperren, wie z.B. "*.bak", "*.BAK" und "*~" (siehe "Security Tips").

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 32M
    max_execution_time 900
    session.gc_maxlifetime 18000

Diese Einstellung bietet genügend Platz für Uploads von ca. 10MByte oder 15 Minuten Dauer und erhöhen das Timeout auf 5 Stunden. Achtung: Diese Werte können für gewöhnlich nicht lokal (in der .htaccess oder settings.php) wirksam hochgesetzt werden (auch wenn es erst so scheint).

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:

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.php" und "sitefooter.inc.php". Passen Sie diese Dateien an, um das Tool designerisch in Ihre Webseite einzufügen.

Zudem sollten Sie die Bild-Dateien "logo-left.gif" und "logo-right.gif" im "htdocs/"-Verzeichnis durch das Logo Ihrer Konferenz bzw. Organisation ersetzen. Empfohlene Breite: ca. 120-150 Pixel, Höhe: 60-80 Pixel. Die Datei "logo-invoice.gif" muss ebenfalls ersetzt 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 ConfTools zu verändern: Für die Darstellung werden Cascading Style Sheets verwendet, deren Definition Sie in "htdocs/conftool.css" finden. Für Änderungen kopieren Sie bitte die anzupassenden Definitionen in die Datei "conftool-custom.css". Allerdings ist die Anpassung nicht so einfach, wie sie zuerst erscheinen mag: Bitte testen Sie Ihr neues Farbschema, um sicher zu stellen, dass das System durch die Änderungen nicht unbenutzbar wird.