Nachdem Sie die Welcompose-Distribution vom Download-Server heruntergeladen haben, müssen Sie sie mit dem jeweiligen Kompressionsprogramm entpacken.

Nach dem Entpacken finden Sie einen Ordner mit dem Namen welcompose-x.x.x auf der Festplatte. Dort drin sind die beiden verschiedenen Installer Packages enthalten. Die Datei install-zlib.php ist der komprimierte Package Installer, die Datei install.php ist der unkomprimierte Package Installer. Verwenden Sie nun ein FTP-Programm (oder eine ähnliche Software), um den gewünschten Installer auf Ihren Webserver zu verschieben.

Nun muss noch das Verzeichnis vorbereitet werden, in das Welcompose installiert werden soll. Legen Sie dazu mit dem FTP-Programm (oder einer ähnlichen Software) ein Verzeichnis auf dem Webserver an, sofern Sie nicht ein bereits vorhandenes Verzeichnis verwenden wollen.

Damit der Package Installer (und damit der Webserver) die Dateien auf dem Server extrahieren kann, müssen die Schreibrechte des Installationsordners angepasst werden. Um die Schreibrechte des Installationsordners zu verändern, reicht bei den meisten Dateitransferprogrammen ein Rechtsklick auf den jeweiligen Ordner. Der Dialog um die Schreibrechte zu verändern, verbirgt sich meist hinter einem Kontekt-Menüeintrag wie Information, Eigenschaften oder chmod.

Welche Schreibrechte genau gesetzt werden müssen, kann von Server zu Server relativ stark variieren. Auf der sicheren Seite sind Sie, wenn Sie alle verfügbaren Rechte an den Ordner vergeben. Bei den meisten Datentransferprogrammen erfolgt dies, indem Sie Checkboxen anklicken – und zwar alle (siehe Abbildung 2.1, „Schreibrechte ändern“). Ist die Eingabe eines oktalen Werts (Zahl) möglich, müssen Sie entweder 777 angeben (wenn nur drei Ziffern akzeptiert werden) respektive 0777 (wenn vier Ziffern akzeptiert werden).

Ist es nicht möglich, die Schreibrechte des Installationsordners von Welcompose zu verändern, weil Sie beispielsweise nicht über die nötigen Rechte verfügen, müssen Sie die manuelle Installation verwenden.

Rufen Sie nun den Package Installer mit dem Webbrowser auf, indem Sie die Adresse zur install-zlib.php (für den komprimierten Installer) oder zur install.php (für den unkomprimierten Installer) in die Adresszeile Ihres Browsers eingeben. Es sollte nun ein Formular mit der Überschrift Package Installation erscheinen.

Sehen Sie statt eines Formulars eine Meldung wie This a compressed install package, but the zlib extension is not installed. Please download a uncompressed install package., dann verfügt Ihr Webserver nicht über die zlib-Erweiterung und kann das Installer Package nicht lesen. Entfernen Sie die install-zlib.php und ersetzen Sie sie durch die Datei install.php, bevor Sie den Package Installer wieder aufrufen. Sie verwenden dann den unkomprimierten Package Installer.

Das Formular des Package Installer ist in zwei Abschnitte aufgeteilt. Einmal in Path setup und einmal in Expert options.

Beim Path setup geht es darum, den Installationsordner, in den die Welcompose-Dateien kopiert werden sollen, im Feld Install directory anzugeben. Die Eingabe wird dabei vom Installer Package aus interpretiert. Wollen Sie Welcompose in den Ordner cms installieren, der sich unterhalb des Installer Package befindet, müssen Sie /cms als Pfad eingeben. Möchten Sie dagegen Welcompose in demselben Ordner wie das Installer Package installieren, ist / die richtige Eingabe.

Im Rahmen der Expert options kann beeinflusst werden, mit welchen Rechten der Package Installer die Dateien auf dem Webserver ablegt. Wenn Sie nicht genau wissen, was Sie tun, sollten Sie die Voreinstellungen belassen und zum nächsten Schritt übergehen, indem Sie auf Go to next step klicken! Der Package Installer entpackt alle Dateien und leitet Sie dann zum Setup weiter.

Der Package Installer unterscheidet zwischen zwei Typen von Dateien respektive Verzeichnissen: beschreibbaren und nicht beschreibbaren. Beschreibbare Dateien respektive Verzeichnisse müssen nach der Extraktion der Dateien für den Webserver beschreibbar bleiben, damit beispielsweise Bilder auf dem Webserver abgelegt werden können. Alle anderen Dateien und Verzeichnisse müssen nur lesbar sein. Dies muss beachtet werden, wenn Sie die Rechte anpassen, mit denen die Dateien auf dem Webserver abgelegt werden sollen.

Weiter müssen Sie darauf aufpassen, dass Sie sich nicht selber den Zugriff auf die Dateien respektive Verzeichnisse verwehren. Dies kann passieren, wenn Sie die Rechte beispielsweise so definieren, dass nur der Webserver, aber kein anderer Benutzer die Dateien oder Verzeichnisse lesen darf, und der Webserver die Dateien nicht mit dem Benutzer respektive der Gruppe Ihres Benutzer-Accounts anlegt.

Die Rechte für die nicht beschreibbaren Dateien respektive Verzeichnisse werden über die beiden Felder Default file mask (für Dateien) respektive Default directory mask (für Verzeichnisse) gesteuert. Die Rechte für die beschreibbaren Dateien über die Felder Writable file mask (für Dateien) respektive Writable directory mask (für Verzeichnisse) geregelt. Achten Sie darauf, einen oktalen chmod-Wert mit führender Null anzugeben (z.B. 0777).

Nachdem Sie Rechte angepasst haben, können Sie auf Go to next step klicken! Der Package Installer entpackt dann alle Dateien und leitet Sie zum Setup weiter.

Bei der manuellen Installation müssen im Gegensatz zum Package Installer die Programm-Dateien von Welcompose manuell auf den Webserver übertragen und auch die Schreibrechte von Hand vergeben werden. Für die manuelle Installation benötigen Sie eine Welcompose-Distribution mit dem Kürzel -src im Namen, beispielsweise welcompose-x.x.x-src.tar.gz. Nachdem Sie die Datei heruntergeladen haben, muss sie entpackt werden.

Verwenden Sie nun ein Dateitransfer-Programm, um die Dateien von Welcompose auf den Webserver zu transferieren. Verschieben Sie die Dateien in das von Ihnen gewünschte Installationsverzeichnis. Sofern dieses noch nicht existiert, legen Sie es vorher an.

Damit Welcompose Dateien wie Bilder auf dem Server ablegen kann, müssen die Schreibrechte diverser Verzeichnisse und Dateien angepasst werden. Um die Schreibrechte zu verändern, reicht bei den meisten Dateitransferprogrammen ein Rechtsklick auf den jeweiligen Ordner respektive Datei. Der Dialog um die Schreibrechte zu verändern, verbirgt sich meist hinter einem Kontekt-Menüeintrag wie Information, Eigenschaften oder chmod.

Welche Schreibrechte genau gesetzt werden müssen, kann von Server zu Server relativ stark variieren. Auf der sicheren Seite sind Sie, wenn Sie alle verfügbaren Rechte an Ordner respektive Dateien vergeben. Bei den meisten Datentransferprogrammen erfolgt dies, indem Sie Checkboxen anklicken – siehe Abbildung 2.3, „Schreibrechte von Dateien ändern“ und Abbildung 2.4, „Schreibrechte von Verzeichnissen ändern“. Ist die Eingabe eines oktalen Werts (Zahl) möglich, müssen Sie für Verzeichnisse entweder 777 angeben (wenn nur drei Ziffern akzeptiert werden) respektive 0777 (wenn vier Ziffern akzeptiert werden). Bei Dateien reicht 666 respektive 0666.

Geändert werden müssen die Schreibrechte von folgenden Verzeichnissen:

Ebenfalls angepasst werden müssen folgende Dateien:

Nachdem dies erledigt ist, können Sie die Setup-Prozedur aufrufen und mit der Konfiguration von Welcompose fortfahren.