-------------------------------------------- | xfriend Linux Installationshinweise | |(c)2009 x-dot GmbH | | www.xfriend.de | www.xdot.de | | | Stand: 30.03.2010 | -------------------------------------------- Beachten Sie bitte folgende Hinweise bei der Installation von xfriend unter Linux/Unix. Die Installation kann mit oder ohne grafischer Oberfläche erfolgen. Installation mit grafischer Oberfäche ------------------------------------- 1. Das Installationsscript (z.B. xfriend_2_9_unix.sh) muss Ausführrechte besitzen. (Rechte änderbar z.B. mit "chmod 755 xfriend_2_9_unix.sh" auf einer Konsole) 2. Führen Sie bitte den Installer unter Ihrer Benutzerkennung (nicht als ROOT, nur wenn erforderlich!) aus. Nach dem Starten des Installationsscriptes führt Sie ein grafischer Installer durch den Installationsvorgang. 3. xfriend schlägt als Installationsordner standardmäßig "/opt/xfriend" vor. In diesem Ordner haben Sie als User normalerweise keine Berechtigungen, Dateien zu erstellen. Abhilfe: a) ändern Sie den Installationsordner z.B. in einen Ordner unterhalb Ihres Home-Ordners (Empfohlen!) oder b) Erstellen Sie manuell den obigen Ordner mit den passenden Rechten. Führen Sie dazu auf einer Konsole als ROOT folgendes aus: "mkdir /opt/xfriend" "chown BENUTZERNAME /opt/xfriend" (BENUTZERNAME ist dabei Ihre persönliche Benutzerkennung) 4. Damit xfriend automatisch startet, muss eine Verknüpfung in den jeweiligen Autostartordners Ihrer grafischen Oberfläche erstellt werden. Während des Installationsvorganges werden Sie gefragt, ob symbolische Links für xfriend angelegt werden sollen. Nutzen Sie diese Funktion, um einen symbolischen Link zu xfriend in den jeweiligen Autostart-Ordner anzulegen. (Bei KDE befindet sich dieser z.B. unter: "~/.kde/Autostart" in Ihrem Homeordner.) 5. Nach erfolgreicher Installation wird xfriend optional automatisch gestartet. Sie können xfriend immer folgendermaßen starten: a) über das Startscript "xfriend" im xfriend Installationsverzeichnisses. b) über ein Icon auf dem Desktop. Die Icons installieren Sie (falls nicht automatisch bei der Installation angelegt), in dem Sie die Dateien mit der Endung ".desktop" axf us dem Installationsverzeichnis von xfriend auf Ihren Desktop ziehen. Dort können Sie dann mit Klick auf das jeweilige Icon xfriend starten oder deinstallieren. 6. xfriend stoppen Sie können xfriend stoppen, in dem Sie a) auf das xfriend Icon im Systemtray klicken und Beenden wählen b) Über die Webmaske von xfriend unter über die URL "stop" (z.B: http://127.0.0.1:8888/stop). c) den Befehl "./xfriend_service stop" im xfriend Installationsverzeichnisses ausführen, wenn xfriend vorher mit "./xfriend_service start" gestartet wurde. (nur bei xfriend server) d) die Java-Prozesse von xfriend "killen". Führen Sie dazu auf der Konsole einfach folgenden Befehl aus: "killall ~BENUTZERNAME/xfriend/jre/bin/java" ("BENUTZERNAME" ist dabei Ihre persönliche Benutzerkennung). Sollten Sie xfriend in "/opt/xfriend" installiert haben, lautet der Befehl: "killall /opt/xfriend/jre/bin/java" Installation ohne grafische Oberfäche per Kommandozeile ------------------------------------------------------- 1. Das Installationsscript (z.B.: xfriend_2_9_unix.sh) muss Ausführrechte besitzen. (Rechte änderbar z.B. mit "chmod 755 xfriend_2_9_unix.sh" auf einer Konsole) 2. Führen Sie bitte den Installer unter Ihrer Benutzerkennung (nicht als ROOT, nur wenn erforderlich!) aus mit den Parametern: xfriend_2_9_unix.sh -c Optional können Sie xfriend auch im quiet mode (ohne Rückfragen) ausführen mit: xfriend_2_9_unix.sh -q -dir "/home/benutzername/xfriend" Die Installation wird dann automatisch vorgenommen und die Dateien werden im angegeben Ordner installiert (z.B. "/home/benutzername/xfriend") 3. Für die Registrierung einer gekauften Version benötigen Sie jetzt den Lizenzkey. Rufen Sie xfriend beim ersten Start aus dem Installationsverzeichnis auf. xfriend -server -customer "1234-1234" -pass "password1234" -key "longlongkey" Tipp für xfriend server Versionen: Sie können zusätzlich folgende Parameter beim Starten verwenden: -remote xfriend aktiviert dann die Webmaske auf Port 8888 für http und Port 8889 für HTTPS. Sie können dann per Browser auf die URL http://serverip:8888 zugreifen und sich mit dem Benutzernamen "system" und Passwort "system" anmelden. -http 8080 Aktiviert die Webmaske für HTTP z.B. auf Port 8080 -https 8443 Aktiviert die Webmaske für HTTPS z.B. auf Port 8443 Sämtliche Parameter werden beim ersten Start in die xfriend DB eingetragen und können bei den weiteren Starts entfallen. Sie können einen xfriend server also folgendermaßen registrieren: xfriend -server -customer "1234-1234" -pass "password1234" -key "longlongkey" -remote -http 8080 -https 8443 Hinweis: Wenn Sie einen xfriend business client installieren und bereits ein xfriend server in Ihrem im Netzwerk installiert ist, können Sie den Client folgendermaßen über den xfriend server aktivieren: xfriend -server -keyserver "http://a.b.c.d:8888" -keypool "poolname" -keypoolpass "poolpassword" 4. Bei den weiteren Starts können Sie xfriend ohne Lizenzparameter starten. a) Für xfriend personal oder business client verwenden Sie: xfriend -server (Der Parameter -server bewirkt, dass xfriend keine nativen Fenster oder Popupdialoge anzeigt, damit es auch ohne grafische Oberfläche laufen kann.) b) Für xfriend server verwenden Sie: xfriend_service start 5. Bei einem xfriend server finden Sie das Skript "xfriend_service" im Installationsverzeichnis. Sie können dieses zum Starten von xfriend als Daemon verwenden und das Skript mit /etc/init.d verlinken. Beim Aufrufen von "xfriend_service" wird automatisch der Startparameter "-server" gesetzt. xfriend zeigt darauf hin keine nativen Fenster oder Popupdialoge mehr an. 6. xfriend stoppen Sie können xfriend stoppen, in dem Sie a) den Befehl "./xfriend_service stop" im xfriend Installationsverzeichnis ausführen, wenn xfriend vorher mit "./xfriend_service start" gestartet wurde. (nur bei xfriend server) b) Über die Webmaske von xfriend unter über die URL "stop" (z.B: http://127.0.0.1:8888/stop). c) die Java-Prozesse von xfriend "killen". Führen Sie dazu auf der Konsole einfach folgenden Befehl aus: "killall ~BENUTZERNAME/xfriend/jre/bin/java" ("BENUTZERNAME" ist dabei Ihre persönliche Benutzerkennung). Sollten Sie xfriend in "/opt/xfriend" installiert haben, lautet der Befehl: "killall /opt/xfriend/jre/bin/java"