Installation Guide: Linux

From UVLayout Docs

(Difference between revisions)
Jump to: navigation, search
Revision as of 07:15, 4 November 2013 (edit)
Headus (Talk | contribs)

← Previous diff		 Current revision (01:18, 16 January 2020) (edit) (undo)
Headus (Talk | contribs)
(→Known Problems)
 
(9 intermediate revisions not shown.)
Line 1: Line 1:
{{:Installation Guide: Menu}} {{TOC}} This page describes how to install or upgrade UVLayout onto a Linux system. {{:Installation Guide: Menu}} {{TOC}} This page describes how to install or upgrade UVLayout onto a Linux system.
-:1. Decide where you want to keep UVLayout, usually /usr/local/, then add these lines to ~/.login for csh/tcsh shell users ...+:1. Decide where you want to keep UVLayout, usually /usr/local/, but it can be in a normal user writable folder if you don't have root access (e.g. in your home folder). Run the following command to extract the supplied software (Note: replace XXXXXX below with the build version of the downloaded file).
- setenv HEADUS_HOME /usr/local/uvlayout-pro+ tar xvfoz uvlayout-XXXXXX.tgz --directory=/usr/local
- set path = ( $HEADUS_HOME/bin $path )+
-... and these lines to ~/.bashrc for bash shell users ...+:2. To launch UVLayout, run this command for the Professional version ...
- export HEADUS_HOME=/usr/local/uvlayout-pro+ /usr/local/uvlayout-pro/uvlayout-run
- 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 ...+... or this command for the Demo version ...
- mkdir -p $HEADUS_HOME + /usr/local/uvlayout-demo/uvlayout-run
-:3. Run the following command to extract the supplied software (Note: replace XXXXXX below with the build number of the file):+:3. 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 [[Installation_Guide:_Licensing#Running_the_licensing_GUI|here]].
- tar xvfoz uvlayout-pro-XXXXXX-fc6.tgz --directory=$HEADUS_HOME/..+== Known Problems ==
-: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 [[Installation_Guide:_Licensing#Running_the_licensing_GUI|here]].+* '''Plugin mode''' doesn't work? If you are using your own wrapper script to set up the various environment variables, make sure you pass all command line args to the 'uvlayout' binary.
-== OpenMotif ==+* Very poor drawing performance? See the [[User Guide: About UVLayout#OpenGL|OpenGL]] preference.
-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 [http://www.uvlayout.com/openmotif OpenMotif] page for further details.+* 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.
-== Wrapper Script ==+* '''USB Dongle''' not being detected? See additional instructions at [https://www.uvlayout.com/rockey https://www.uvlayout.com/rockey].
-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:+== Missing Shared Libraries ==
- #!/bin/csh -f+Current and recent releases of UVLayout are bundled with all the required shared libraries. If however you are trying to install an older release of UVLayout, and encounter errors caused by missing shared libraries, then you can find copies of these libraries on the [http://www.uvlayout.com/openmotif OpenMotif] page.
- +
- # 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 [[User Guide: About UVLayout#OpenGL|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 ==+== Steps For Different Distros ==
* [[Installation Guide: Ubuntu|Ubuntu]] * [[Installation Guide: Ubuntu|Ubuntu]]
 +* [[Installation Guide: Fedora|Fedora]]

Current revision

Cover Page
Introduction
Requirements
Windows
Linux
OS X
Licensing
Download PDF

Contents

This page describes how to install or upgrade UVLayout onto a Linux system.
1. Decide where you want to keep UVLayout, usually /usr/local/, but it can be in a normal user writable folder if you don't have root access (e.g. in your home folder). Run the following command to extract the supplied software (Note: replace XXXXXX below with the build version of the downloaded file). 
 tar xvfoz uvlayout-XXXXXX.tgz --directory=/usr/local
2. To launch UVLayout, run this command for the Professional version ... 
 /usr/local/uvlayout-pro/uvlayout-run

... or this command for the Demo version ... 

 /usr/local/uvlayout-demo/uvlayout-run
3. 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.

Known Problems

  • Plugin mode doesn't work? If you are using your own 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.

Missing Shared Libraries

Current and recent releases of UVLayout are bundled with all the required shared libraries. If however you are trying to install an older release of UVLayout, and encounter errors caused by missing shared libraries, then you can find copies of these libraries on the OpenMotif page.

Steps For Different Distros

Retrieved from "http://doc.uvlayout.com/Installation_Guide:_Linux"