University of Bremen

Manual

Main->General Information->Installation on UNIX/Linux

Installation on UNIX® and Linux®

Installation Overview
1. Get uDraw(Graph) by ftp.
2. Install the distribution.
3. Specify installation directory in $UDG_HOME.
4. Be sure to have a browser for the help system (Mozilla® preferred).
5. Start executable file "uDrawGraph" in the "bin" directory.
6. Read and accept the license conditions.

Installation in detail:

1. Get uDraw(Graph) Distribution

First you have to download a uDraw(Graph) distribution by ftp, see http://www.informatik.uni-bremen.de/uDrawGraph/en/download/.

Additional informations can be found in the README file, that is also contained in every distribution.

2. Install Distribution

From tar file: If your distribution comes as a *.tar.gz file, you have to open a shell (commandline), use "gunzip *.tar.gz" and then "tar -xf *.tar" to install the distribution. For distributions in *.tar.bz2 format, use "bunzip2 *.tar.bz2" instead. This creates the directory "uDrawGraph-<Version>", where <Version> is the version number of the release. uDraw(Graph) can be placed in any directory. To move the software to another location, you need to move this directory completely to some other directory.

From rpm file: For Linux® you can alternatively download the distribution in RPM file format. To install, just issue "rpm -i *.rpm" as user root. This places uDraw(Graph) in the directory "/opt/uDrawGraph". To install it, for example, in directory "/usr/local/uDrawGraph", you have to issue "rpm --prefix /usr/local -i *.rpm".

3. Specify Installation Directory

(This step is not neccessary if you install the *.rpm distribution on Linux®.)

Before starting uDraw(Graph), you have to set the environment variable UDG_HOME to the absolute file name of the directory where the system is installed on your computer. The Linux RPM sets this environment variable automatically. Be careful with changing the location of the distribution after users have saved their options and read this note about environment variable $UDG_HOME for details.

For example, if you have installed uDraw(Graph) in your home directory "/home/me", then the environment variable has to be set using the following command (try "echo $SHELL" to see the kind of shell you currently use):

For (t)csh shell users:

setenv UDG_HOME /home/me/uDrawGraph-<Version>

For (ba)sh shell users:

export UDG_HOME=/home/me/uDrawGraph-<Version>

You should make these settings permanent by putting this command into file ~/.cshrc (for (t)csh users) or ~/.profile (for (ba)sh users).

4. Browser for Help System

Finally, make sure that you have installed a web browser to work with the online documentation and help system directly from the uDraw(Graph) user interface. Netscape® Navigator®, Mozilla® or Firefox® are preferred in order to reuse an already open browser when consecutive calls to the help system are invoked by the user. If you have to use another browser like KDE Konqueror or Opera, then uDraw(Graph) must open a new browser window for each consecutive call to the help system.

5. Start

The command you have to start is "uDrawGraph" in the "bin" directory.

6. Accept License Conditions

A window for license agreement appears when the user starts uDraw(Graph) for the first time. Please read the terms of the agreement carefully. You can get the full text of this license with the Show License button. The license text is also available in file "LICENSE.txt" in the installation directory. By confirming the license window, you accept and agree to become bound by all terms of this license. Please press the "Quit" button in the license agreement window if you do not agree to this license.