Installation Notes - Workspaces Desktop

Computer Requirements

Oracle's Java Runtime Environment (JRE) version 1.8 or better. This can be obtained from http://www.java.com On systems with multiple Java installations, you should specify and use the environment variable JAVA_HOME set to the directory of the proper Java jre directory.

Optional if encryption is to be used: Gnu Privacy Guard (gpg) which can be downloaded from http://www.gnupg.org/

Workspaces is normally provided as a .tar.gz file or an executable install file (Windows). Files are installed in the user's home directory. A directory, ".eightolives", established in the user's home directory contains a subdirectory, "Workspaces", which contains all required and created files.

The program is first downloaded by Registered Users logging in to the eightolives' User Login Page with Workspaces as the selected product.

You become a Registered User by purchasing an eightolives Workspaces subscription from the eightolives store.

Windows Installation:
When you log in to the User Login Page, your browser will prompt you to save the EightolivesInstall.exe file in your Downloads directory. When downloaded, execute it to install and respond to the prompts.

Starting the Program on Windows
The program is normally started by executing: user_home\.eightolives\Workspaces\Workspaces

Linux Installation: When you log in to the User Login Page, your browser will prompt you to save the EightolivesInstall.tar.gz file in your Downloads directory. When downloaded, use a shell window and execute the commands:
   tar -xvzf EightolivesInstall.tar.gz
   ./EightolivesInstall/EightolivesInstall

Starting the Program on Linux
The program is normally started by executing: user_home/.eightolives/Workspaces/Workspaces

Setting Preferences

The Workspaces Desktop menu bar has a Preferences option which allows you to set various parameters. The on-line versions default is to use Preferences as defined by eightolives. See the User Manual if you wish to specify your own preferences.

Three preferences which you may need to modify are the executable paths to your preferred web browser, your preferred PDF reader and to the Gnu Privacy Guard (gpg) program if you wish to use encryption. Use the menu options Preferences > Set Browser Path, Preferences > Set PDF Reader Path, and Preferences > Set GPG Path to specify the location of those external programs. and locate the appropriate executable files for each program.

You can also add an image or slide show to the background by using the Preferences > Set Background Image menu option. With that option you can select a .jpg, .gif or .png file. You can also select a .smi slide show file as created using the Bookmarks tool. See the Bookmarks tutorial on how to create .smi files from a given directory of images.

Inventory Setup

The Inventory tool requires you to specify the directory where you want the Inventory data directory to be established and to specify the inventory project name. You can create or change inventory projects using the Preferences > Inventory menu options. The Inventory tool's speadsheets are displayed as separate tabs and selected from the Workspaces menu options.

USB Interface Pod Setup

The Boundary Scan Tool interfaces to external hardware using an eightolives' USB Interface Pod. On Linux systems, you need to copy the file "98-eightolives.rules" found in the ".eightolives/Workspaces" directory to the "/lib/udev/rules.d" directory to gain user permission to access the pod. From the ".eightolives" directory, execute the command "sudo cp 98-eightolives.rules /lib/udev/rules.d".

Accessing USB devices also requires the file "javax.usb.properties" found in the ".eightolives/Workspaces" directory to be copied to the Java's "jre/lib" directory. On Linux if the environmental variable JAVA_HOME has been defined as pointing to the jre directory, from the ".eightolives/Workspaces" directory, execute the command "sudo cp javax.usb.properties $JAVA_HOME/lib".