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-fc6.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 your login scripts, you may want to create a wrapper script that sets all the required variables, and then run that script to start UVLayout. This is what we use here at headus:

#!/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

# remove comment below to run the licensing GUI
# headus 

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.

• Very poor drawing performance? See the OpenGL preference.

• Errors on UVLayout start-up when opening UID files? This sometimes occurs when the UVLayout installation is distributed to users via a networked file system, and appears to only affect the Fedora-6 32bit build of UVLayout. Use the Fedora-10 64bit build of UVLayout to solve this problem.

Additional Steps For Different Distos

• Ubuntu