Installationsanleitung fr Cross-Desktop auf Unix basierten Systemen

Diese Installationsanleitung ist fr die Single-User-Version von Cross-Desktop gltig.

Inhalt

I. Installationskonzepte
II. Beschreibung der Installationsparameter
III. Installation von Cross-Desktop
IV. Informationen fr den Betrieb



I. Installationskonzepte

Zum Betrieb von Cross-Desktop gibt es zwei Betriebskonzepte. Diese Konzepte unterscheiden sich in dem Punkt, ob die Benutzerdaten vom Webserver gesehen werden knnen, also prinzipiell von Dritten ber das Internet direkt angesprochen werden knnen, oder ob die Benutzerdaten auerhalb der Sicht des Webservers, irgendwo im System, liegen und somit in keinem Fall direkt ber den Webserver angesprochen werden knnen.

Konzept 1: User-Daten im Root-Bereich des Webservers

Wird Cross-Desktop so konfiguriert, das die Benutzerdaten im Sichtbereich des Webservers liegen, so wird es notwendig sein diese Daten vor unbefugten Zugriff zu schtzen. blicherweise wird hierzu eine Konfiguration des Webservers mittels .htaccess Datei vorgenommen. Das Installationsprogramm von Cross-Desktop untersttzt diese Konfigurationsmglichkeit mit der Option Protection of the secure path am Ende des Konfigurationsformulars. Diese Felder sind nur dann auszufllen, wenn Cross-Desktop nach diesem Betriebskonzept arbeiten soll.

Beispiel:
Website: /home/www/website/html
Secure Path:/home/www/website/html/xddata/store
Protection of the secure path:
    Username: SiteAdmin
    Password: <secure-pwd>

Konzept 2: User-Daten auerhalb des Root-Bereichs des Webservers

Um die Benutzerdaten sicher auf dem Server aufzubewahren, sollten die Daten in der Weise auf dem Server abgelegt werden, so das sie von keiner auf dem Server definierten Website durch Eingabe einer einfachen URL erreichbar sind. Viele Server verwenden zur Verwaltung der Websites ein Stamm-Verzeichnis, z.B. /home/www. Um diesem Verzeichnis fern zu bleiben bietet es sich an, die Konfigurationsdaten in einen anderen Pfad unter zu bringen.

Beispiel:
***Stammverzeichnis: /home/xddata
Secure Path:/home/xddata/store

Im folgenden werden die beispielhaften Pfadangaben gem dem Konzept User-Daten auerhalb des Root-Bereichs des Webservers beschrieben.


II. Beschreibung der Installationsparameter

Secure Path:
Pfad zur Verwaltung von Passwrtern und SessionIDs des Benutzers. Das Verzeichnis wird bei der Installation automatisch erzeugt, wenn es nicht bereits existiert. Der System-User der das setup.cgi ausfhrenden Website muss dazu Schreibrechte besitzen. In diesem Verzeichnis wird von Cross-Desktop ein Verzeichnis fr Benutzerdaten angelegt. Bei entsprechenden Schreibrechten (ausfhrender User des setup.cgi) wird das Verzeichnis automatisch angelegt.
Beispiel: 
Konzept 1: /home/www/website/html/xddata/store
Konzept 2: /home/xddata/store

URL
URL zu den Programmdateien von Cross-Desktop. In dem Pfad muss es mglich sein cgi-Scripte auszufhren. Bei entsprechenden Schreibrechten (ausfhrender User des setup.cgi) wird das Verzeichnis automatisch angelegt.
Beispiel: http://www.website.de/cgi-bin/crossDesktop 

HTML URL
URL zu den Html- und Javascript-Dateien von Cross-Desktop. Bei entsprechenden Schreibrechten (ausfhrender User des setup.cgi) wird das Verzeichnis automatisch angelegt.
Beispiel: http://www.website.de/crossDesktop/html 

Image URL
URL zu den Bilddateien von Cross-Desktop. Bei entsprechenden Schreibrechten (ausfhrender User des setup.cgi) wird das Verzeichnis automatisch angelegt.
Beispiel: http://www.website.de/crossDesktop/images 

Perl path
Verzeichnis in dem sich die Perl-Installation befindet. Normalerweise /usr/bin/perl. Sie finden die Information in der Dokumentation Ihres ISP.

Zip path
Verzeichnis in dem sich das Zip-Programm befindet. Normalerweise /usr/bin/zip. Auf manchen Systemen muss Zip nachinstalliert werden. Dies kann whrend der Installation mit der Markierung Install zip later bercksichtigt werden. Sie finden die Information in der Dokumentation Ihres ISP.

Unzip path
Verzeichnis in dem sich das Unzip-Program befindet. Normalerweise /usr/bin/unzip. Auf manchen System muss Unzip nachinstalliert werden. Dies kann whrend der Installation mit der Markierung Install unzip later bercksichtigt werden. Sie finden die Information in der Dokumentation Ihres ISP.

Redirect
URL zur Umleitung des Benutzers nach Abmelden aus Cross-Desktop.
Beispiel: http://www.website.de/

Session Timeout
Periode fr die Laufzeit einer Benutzer-Session. Die Zeit kann in der Form 4h fr vier Stunden oder 3h4m30s fr drei Stunden, vier Minuten und 30 Sekunden angegeben werden. Es mssen immer ganze Zahlen angegeben werden.

Maximum Quota
Speicherbegrenzung im Datei-Explorer. Angabe in KB, MB oder GB. Bitte nur ganze Zahlen verwenden. 
Beispiel: 100MB.

Showed basename
Bezeichnung fr das Wurzelverzeichnisses im Datei-Explorer von Cross-Desktop.
Beispiel: Start

Password
Password des Benutzers. Das Password muss wiederholt eingegeben werden.

Protection of the secure path
Diese Option dient der Erstellung einer .htaccess Datei zum Sch\&uuml;tzen der Benutzerdaten f\&uuml;r den Fall, das die Benutzerdaten im Sichtbereich des Webservers gespeichert werden (siehe Installations-Konzept 1). Diese Option erlaubt einen Benutzer f\&uuml;r den kontrollierten Zugriff auf diesen Dateibereich zu definieren oder eine bereits bestehende Benutzerliste zu verwenden. Achtung: Mit dieser Benutzergruppe sind Administratoren gemeint und nicht alle Benutzer des Cross-Desktop. Fr weiterfhrende Informationen zur Verwendung von .htaccess Dateien verweisen wir auf die Dokumentation ihres Web-Servers.

Username: Name eines zugelassenen Benutzers fr diesen Bereich.
Password: Pawort fr den zugelassenen Benutzer fr diesen Bereich.
Passwordfile: (Optional, f&uuml;r Experten!) Mit dieser Option kann eine bestehende Passwort-Datei verwendet werden. Die Parameter Username und Password sind dann nicht auszuf&uuml;llen.


III. Installation von Cross-Desktop

Vor der Installation:
Fr die Installation wird eine genaue Kenntnis der tatschlichen Pfade auf dem Zielserver bentigt. Die Information kann der Dokumentation Ihres ISP entnommen werden. Meistens steht die Information in den Kapiteln, in denen die Verwendung von cgi beschrieben wird.

Fr die Ausfhrung des Installationsscripts wird ein cgi-Verzeichnis bentigt. Es wird empfohlen, fr die Installation ein eigenes Verzeichnis anzulegen, z.B. cgi-bin/xdsetup.

Whrend der Installation fragt das Installationsscript nach Pfaden zum Kopieren der Programm-, Html, und Bilddateien. Fr diese Pfade bentigt das Installationsscript Schreibrechte mit der Benutzer- und Gruppen-Id des Scripts whrend der Ausfhrung.

Beachten Sie, das der Pfad zu Ihrem document- oder root-directory, z.B. 
/home/www/sites/myrootdir, der Ort ist, an dem Ihre Domain http://www.website.de/ die Web-Dateien wie index.html erwartet.

Installationsprozess:
1. Kopieren Sie das Installationsscript setup.cgi und das Archiv files.tar.gz in das Installationsverzeichnis.

2. ndern Sie die Rechte des Installationsscripts auf 755 (chmod 755 setu.cgi) und die des Archivs auf 666 (chmod 666 files.tar.gz).

3. Geben Sie im Browser die URL des Installationsscripts ein und fhren das Script aus
(http://www.website.de/cgi-bin/xdsetup/setup.cgi).

4. Fllen Sie das Formular mit den vorbereiteten Daten aus (siehe Kapitel 2. Beschreibung der Installationsparameter) und folgen Sie der Installation.

5. An dieser Stelle ist die Installation bereits abgeschlossen.

6. Sollte die Installation nicht erfolgreich verlaufen, so knnen Sie mit Zurck am Browser einen Schritt zurck gehen und die Parameter korrigieren. Bei fehlenden Rechten seitens des Installationsscripts knnen Sie die notwendigen Verzeichnisse auch von Hand erzeugen und deren Rechte einstellen.

Problemflle
1. Rechteprobleme: Dies ist der am meisten auftretende Fall, weshalb Cross-Desktop nicht richtig luft. Damit Cross-Desktop vollumfnglich luft, ist es notwendig, das der Webserver in einigen Verzeichnissen Lese-, Schreib- und Ausfhrungsrechte besitzt. Wenn der Webserver luft, dann wird der Domain ein in der httpd.conf spezifizierter Benutzer zugeordnet. Dieser Benutzer ist der Scripte ausfhrende Benutzer fr die Domain. Smtliche Verzeichnisse und Dateien, die ber die Domain direkt oder ber Scripte in der Domain erreichbar sind, mssen diesem Benutzer zugeordnet sein. Ist dies nicht der Fall, dann mssen Sie sich mit dem Benutzer root an das System anmelden und mit dem Befehl chown die Rechter an den Dateien und Verzeichnissen einstellen. Verzeichnisse und Scripte werden allgemein mit den Rechten 755 und allgemeine Dateien  mit 666 eingestellt.

2. Das Installationsverzeichnis kann keine Scripte ausfhren: Der Webserver muss in der Lage sein Scripte im Installationsverzeichnis ausfhren zu knnen. Um das Installationsverzeichnis auf die Ausfhrung von Scripten zu testen, kopieren Sie einfach ein bestehendes Script in das Verzeichnis und starten es mit der entsprechenden URL ber den Browser. Wird das Script nicht ausgefhrt, so bekommen Sie im allgemeinen den Programmcode des Scripts im Browser angezeigt.

Es gibt verschiedene Wege, um die Ausfhrung von Scripten im Webserver zu konfigurieren. In einem Fall mssen Sie an geeigneter Stelle eine hnlich geartete Zeile in der httpd.conf eintragen:
ScriptAlias /crossdesktop/ "/home/www/sites/myrootdir/cgi-bin/xdsetup"

Mit dieser Zeile wird zum einen die Ausfhrung von Scripten im angegebenen Verzeichnis gestattet und zum anderen die Mglichkeit gegeben Cross-Desktop ber diese URL aufzurufen:
http://www.website.de/crossdesktop/setup.cgi

3. Verzeichnisse knnen nicht mit .htaccess geschtzt werden: Der Webserver muss wissen, wo nach .htaccess Dateien gesucht werden muss. Die folgenden Zeilen, in der Datei httpd.conf definiert, sagen dem Webserver, das die .htaccess Datei definiert, wem es gestattet ist auf das Verzeichnis und dessen Unterverzeichnisse zuzugreifen.
<Directory "/home/www/sites/myrootdir/crossdesktop/xddata">
    AllowOverride All
    Options ExecCGI
    Order allow,deny
    Allow from all
</Directory>


IV. Informationen fr den Betrieb

Wartung von XD durch XD
Das System und die komplette Website der Domain kann durch geeignete Konfiguration mit Cross-Desktop gewartet und konfiguriert werden. Hierzu wird das Arbeitsverzeichnis auf den Pfad /home/www/sites/myrootdir eingestellt. Bei Anmeldung wird nun das Wurzelverzeichnis der Domain eingeblendet. Mit dem in Cross-Desktop integrierten Editor lassen sich Html- und Script-Dateien direkt editieren. Grafiken knnen hoch- oder heruntergeladen werden. Durch einen symbolischen Link auf der Unix Systemebene knnen Sie die Konfigurations- und Benutzerdaten ebenfalls einblenden. 
Aber Vorsicht! Die nderungen sind sofort wirksam. Sie knnen die Installation unbrauchbar machen.



Copyright 2004, Cross Development 