Installation Guide: Linux
From UVLayout Docs
(Difference between revisions)
| Revision as of 10:14, 9 August 2012 (edit) Headus (Talk | contribs) (→OpenMotif) ← Previous diff |
Current revision (01:18, 16 January 2020) (edit) (undo) Headus (Talk | contribs) (→Known Problems) |
||
| (21 intermediate revisions not shown.) | |||
| Line 1: | Line 1: | ||
| - | {{:Installation Guide: Menu}} 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-rh9.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 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: | + | == Missing Shared Libraries == |
| - | + | ||
| - | #!/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. | + | 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. |
| - | == Additional Steps For Different Distos == | + | == Steps For Different Distros == |
| - | * [[Installation Guide: Ubuntu 12-04LTS|Ubuntu 12.04LTS]] | + | * [[Installation Guide: Ubuntu|Ubuntu]] |
| + | * [[Installation Guide: Fedora|Fedora]] | ||
Current revision
|
tar xvfoz uvlayout-XXXXXX.tgz --directory=/usr/local
/usr/local/uvlayout-pro/uvlayout-run ... or this command for the Demo version ... /usr/local/uvlayout-demo/uvlayout-run
Known Problems
Missing Shared LibrariesCurrent 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 |