LSSS - Readme


Contact information

   Home page:    http://www.marec.no/
   Email:        support@marec.no

________________________________________________________________

Installing LSSS on Windows

1. Run the installation program.

2. See optional post-install steps in ReleaseNotes.txt.

________________________________________________________________

Installing LSSS on Linux

1. Unzip the LSSS installation zip file for linux.
   The resulting directory is referred to as LSSS_INSTALL_SRC.

2. Install Java
   a. Make sure Java 8 or newer is installed.
      An installation file for java is included in LSSS_INSTALL_SRC.
      The latest version of java can be downloaded from http://java.com/.
   b. Set the environment variable JAVA_HOME to the java installation directory.
      This is preferably done in a script performed at each login, such as .bashrc.

3. Install dongle driver
   a. Change directory to
         LSSS_INSTALL_SRC/sentinel_keys_protection_installer_*
      depending on your Linux distribution.
   b. Run skpi_install.sh as root.
   c. Select option 1. SUD - Sentinel USB Daemon.
   d. Rebooting might be necessary to start the daemon.

4. Install LSSS
   a. Unzip the LSSS zip-file in LSSS_INSTALL_SRC.
      The resulting directory is referred to as LSSS_HOME.

5. Start LSSS
   a. Insert a valid dongle in an USB port.
   b. Start LSSS by running LSSS_HOME/lsss/LSSS.sh.

6. Optional
   a. Create a shortcut to the startup script on the desktop using the icon LSSS_HOME/lsss/LSSS.png.
   b. See optional post-install steps in ReleaseNotes.txt.

________________________________________________________________

Notes for Linux users

1. /bin/bash is used in the start up scripts LSSS_HOME/{lsss,korona}/*.sh.
   These scripts may be modified to use another shell if /bin/bash is not available.

2. In order to achieve hardware graphics acceleration X might have to be configured to use 24 bit colors.

3. On 64-bit systems it might be necessary to install additional libraries in order to run
   the dongle driver that is a 32-bit application.
