1. Decide where you want to keep UVLayout, usually /usr/local/, then add these lines to ~/.login for csh/tcsh shell users ...

setenv HEADUS_HOME /usr/local/uvlayout-pro
set path = ( $HEADUS_HOME/bin $path )

... and these lines to ~/.bashrc for bash shell users ...

export HEADUS_HOME=/usr/local/uvlayout-pro
export PATH=$HEADUS_HOME/bin:$PATH

2. Open up a new shell window so that the new variable and path are used, and create the install directory ...

mkdir -p $HEADUS_HOME  

3. Run the following command to extract the supplied software (Note: replace XXXXXX below with the build number of the file):

tar xvfoz uvlayout-pro-XXXXXX-rh9.tgz --directory=$HEADUS_HOME/..

4. If this is the first time you have installed UVLayout, you will need to activate it by cut'n'pasting your license key into the keys file. Instructions on that are here.

OpenMotif

Linux versions of the headus tools use OpenMotif for their GUI interfaces. The version of OpenMotif that's on your system is used by default, but if this is missing or incompatible, the required OpenMotif shared libs are included in the headus installation. See the OpenMotif page for further details.

Wrapper Script

Instead of modifying the user's login scripts, you may want to create a wrapper script that sets all the required variables, and then the users run that script. And example script would look like this:

#!/bin/csh -f

# change this to where UVLayout has been installed
setenv HEADUS_HOME /usr/local/uvlayout-pro

set path = ( $HEADUS_HOME/bin $path)
setenv LD_LIBRARY_PATH $HEADUS_HOME/lib

uvlayout $*

Known Problems

• Plugin mode doesn't work. If you are using a wrapper script to set up the various environment variables, make sure you pass all command line args to the 'uvlayout' binary.

Additional Steps For Different Distos

• Ubuntu 12.04LTS