This document includes some instructions how to install and run the
LRZ Sync+Share client on your LINUX operating system.


===============================================================================
Installing the client
===============================================================================

The .tar.gz packages includes a script to perform a system-wide installation.
System-wide means that all users of the machine can use the client. Furthermore
they should be able to find it using the desktop/dashboard search function
integrated in Gnome or KDE. To install the client you have to run the install
script with root privileges from the directory, where you've extracted the
.tar.gz package.

On most Linux distributions you need to change to root first:

  su -
  /home/username/LRZ_Sync_Share/LRZ_Sync_Share-Install.sh install
  exit
  
On Ubuntu and Ubuntu-based distributions you have to use sudo:

  sudo su
  cd /home/username/LRZ_Sync_Share/
  ./LRZ_Sync_Share-Install.sh install
  exit
  
Installing on 64-bit systems  
****************************

If you are using a pure 64-bit systems (means without Multiarch support), which
doesn't support running 32-bit applications you have to install the 32-bit
compatibility libraries, before starting the client.

Installing 32-bit libraries using apt-get:

  apt-get install ia32-libs

Installing 32-bit libraries using yum:

  yum install compat-libstdc++-296.i686 libXext.i686 libXrender.i686 libXtst.i686

  
Another possible way is to replace the 32-bit Java Runtime Environment (JRE) we
deliver with the client with a 64-bit version:

  1) Download the lastest Linux 64-bit JRE 7 .tar.gz packages from Oracle:
     http://www.oracle.com/technetwork/java/javase/downloads/index.html

  2) Extract the package.
  
  3) Replace the jre/ folder we deliver in our package with the one in the
     Oracle JRE package you've just downloaded and extracted. If you have
	 already used the install script to install the client, you will find the
	 jre/ folder here:
	 /usr/share/LRZ_Sync_Share/

===============================================================================
Running the client
===============================================================================

Running the client is easy:

  - Using the desktop / dashboard search function in Gnome and KDE
    
	Please note: You will only find the client there, if you used the install
	script described above.
	
  - Clicking on the LRZ_Sync_Share-Client.sh file in your favorite
    file manager
  
  - Executing the LRZ_Sync_Share-Client.sh from a terminal session
  
===============================================================================
Uninstalling the client
===============================================================================

Removing the client can be accomplished with the install script, just
providing another parameter to it.

On most Linux distributions you need to change to root first:

  su -
  /home/username/LRZ_Sync_Share/LRZ_Sync_Share-Install.sh uninstall
  exit
  
On Ubuntu and Ubuntu-based distributions you have to use sudo:
  
  sudo /home/username/LRZ_Sync_Share/LRZ_Sync_Share-Install.sh uninstall