-------------------------------------------- | xfriend Linux installation help | | (c)2009 x-dot GmbH | | www.xfriend.de | www.xdot.de | | | Update: Mar. 30, 2010 | -------------------------------------------- Please carefully read the following information with regard to the installation of xfriend under Linux / Unix. The installation may be done with or without a graphics system. Installation with graphics system: 1. The installation script (e.g.: xfriend_2_9_unix_de.sh) needs to have execution rights (rights may be changed e.g. with "chmod 755 xfriend_2_9_unix_de.sh" on a console). 2. Please run the installer under your user ID (not under ROOT, only if necessary!) After starting the installation script a graphical installer will lead you through the installation process. 3. xfriend will suggest "/opt/xfriend" as the standard installation folder. Within this file, you as a User will usually not be allowed to create files. To avoid this, you may a) change the installation folder to e.g. a folder under your home folder (recommended) or b) manually create the folder with all necessary rights. To do this, you need to run the following on a console under ROOT: "mkdir /opt/xfriend" "chown USER NAME /opt/xfriend" (USER NAME in this case is your personal User ID) 4. To make xfriend start automatically, you need to create a connection to the autostart folder of your graphical platform. During the installation process you will be asked, whether you wish to create symbolic links for xfriend. Use this feature to create a symbolic link between xfriend and your autostart folder. (With KDE this folder is located at "~/.kde/Autostart" in your home folder.) 5. After successful installation you have the option of starting xfriend automatically. But you can also start xfriend at any time either via a) the start script "xfriend" in the xfriend installation folder or b) via an icon on your desktop. If you have not created the icons automatically during the installation process, you may do so now by copying all files ending on ".desktop" from the installation folder to your desktop. Then you can start or deinstall xfriend from your desktop with a click on the corresponding icon. 6. Exit xfriend You can exit xfriend by a) "killing" the Java processes of xfriend. To do so, execute the following on the console: "killall ~USERNAME/xfriend/jre/bin/java" ("USERNAME" is your personal User ID). If you installed xfriend under "/opt/xfriend" the command is: "killall /opt/xfriend/jre/bin/java" b) using the URL "stop" via xfriend's web mask (e.g.: http://127.0.0.1:8888/stop). c) executing the command "./xfriend_service stop" in the xfriend installation folder if xfriend has previously been started with "./xfriend_service start" (only for xfriend server) Installation without graphical platform by commands: 1. The installation script (e.g.: xfriend_2_9_unix_de.sh) needs to have execution rights. (Rights may be changed e.g. with "chmod 755 xfriend_2_9_unix_de.sh" on a console) 2. Please run the installer under your User ID (not under ROOT, only if necessary!) with the following parameters: xfriend_2_9_unix_de.sh -c Optionally you can start a quiet installation with: xfriend_2_9_unix.sh -q -dir "/home/username/xfriend" The installation process will run automatically and the files will be installed in the respective folders, e.g. "/home/username/xfriend" 3. For the activation of a purchased version you now need the license key. When starting xfriend for the first time, start it from the installation folder: xfriend -server -customer "1234-1234" -pass "password1234" -key "longlongkey" Further parameters for xfriend server versions: -remote xfriend will then activate the webmask on Port 8888 for http and Port 8889 for HTTPS. You can then access the URL http://serverip:8888 with your browser and log in with the user name "system" and the password "system". -http 8080 Setting http port to "8080". -https 8443 Setting https port to "8443" Every parameter is saved in the xfriend configuration database and will be used at every restart. As an example you can register xfriend the following way: xfriend -server -customer "1234-1234" -pass "password1234" -key "longlongkey" -remote -http 8080 -https 8443 Note: If you try to install a business client with an existing xfriend server in your network, you can use the following parameters to activate the xfriend client: xfriend -server -keyserver "http://a.b.c.d:8888" -keypool "poolname" -keypoolpass "poolpassword" 4. For the next starts of xfriend you can start xfriend without license parameters. a) For xfriend personal or business client use: xfriend -server (Parameter -server disables any communication with an graphical frontend.) b) For xfriend server use: xfriend_service start 5. With xfriend server you also have the script "xfriend_service" in your installation folder. You can use this to start xfriend as a demon and link it with "/etc/init.d". When starting "xfriend_service", it automatically sets the start parameter "–server". xfriend will then not show any more native windows or popup dialogs. 5. Exit xfriend You can exit xfriend by a) "killing" the Java processes of xfriend. To do so, execute the following on the console: "killall ~USERNAME/xfriend/jre/bin/java" ("USERNAME" is your personal User ID). If you installed xfriend under "/opt/xfriend" the command is: "killall /opt/xfriend/jre/bin/java" b) using the URL "stop" via xfriend's web mask (e.g.: http://127.0.0.1:8888/stop). c) executing the command "./xfriend_service stop" in the xfriend installation folder if xfriend has previously been started with "./xfriend_service start" (only for xfriend server)