Linux Installation Instructions

    This procedure uses the "unzip" utility to extract the TrueGrid files
from the given archive file. The files extracted will reside in the TrueGrid
directory (typically /usr/TrueGrid). If you are not using RedHat or Suse,
you need to pick the kernel level which best matches the kernel levels below:

    RedHat 7.2 to RedHat 8.0(Kernel version 2.4.7 to 2.4.18): tg<ver#>_RH8.ZIP
    RedHat 9.0:                     (Kernel version 2.4.20 ): tg<ver#>_RH9.ZIP
    32 bit RedHat Enterprise 4.0 and SUSe 9.3
                            (Kernel version 2.6.5 to 2.6.11): tg<ver#>_RHEN.ZIP
    64 bit SUSe 9.3                  (Kernel version 2.6.11): tg<ver#>_RHSU.ZIP
               
    No effort is made to create the TrueGrid directory or set permissions on
it. Rather, the user is responsible for this. The environment variable TGHOME
must be set to this directory.(e.g., in csh and tcsh use "setenv TGHOME
/usr/TrueGrid", in sh and bash use "set TGHOME=/usr/TrueGrid; export
TGHOME=/usr/TrueGrid" .) The setting of the environment variable, TGHOME
should be put in the .cshrc (for csh and tcsh)  and .bashrc (for sh and bash)
of each Truegrid user.
    The Sentinel Rainbow Drivers required for the license manager to run
properly. Without them the license manager may lock up the system requiring
a manual powering down. (Note: USB dongles are not supported for RedHat
Linux 7.2 to 8.0 and parallel port driver are not available for RedHat
Linux Enterprise 4.0 or SUSe.) To check to see if the parallel port drivers
are installed, type "ls /dev/rnbodrv*". If nothing is listed, the drivers need
to be installed and root privileges will be required.
  These drivers are provided by Rainbow in "rpm" format so the RPM Package
Manager is also needed. (This is already available in most Linux (all RedHat
Linux) installations.)
    Different Rainbow drivers are needed depending on the version of RedHat (or
comparable) Linux. The drivers for the Redhat Linux version you have selected
are located in the SafeNet sub-directory of the TrueGrid directory. In the case
of SuSE 9.1, the script for starting the USB daemon is flawed and the
installation will tell you to start /opt/sentinel/sud/usb/load_daemon.sh
manually. This script will need minor editing by changing line 80 from
     daemon $USBDAEMON_INSTALL_DIR/usbdaemon
to
     start_daemon $USBDAEMON_INSTALL_DIR/usbdaemon
. To start the script you type
      /opt/sentinel/sud/usb/load_daemon.sh start
.
    Once the TrueGrid software is unpacked and the Rainbow drivers are
installed, run tgauth in the TrueGrid directory to turn on the authorization.

Steps:

0. Make sure the dongle is plugged into the USB port on the machine.

1. Create the TrueGrid directory (usually /usr/TrueGrid) with the mkdir command.
   Set the environment variable TGHOME to this value.

2. Copy the .ZIP file to the TrueGrid directory (cp <tg file>.ZIP $TGHOME)

3. Change directory to the TrueGrid directory (cd $TGHOME).

4. Unpack the .ZIP file (unzip <tg file>.ZIP).

5. If the Rainbow drivers are not installed, go to the appropriate Rainbow
   sub-directory (cd SafeNet) and follow the instructions in the
   README file found there. Return to the TrueGrid directory (cd ..).
   Remember, Rainbow installation requires root privileges. Once the drivers
   are installed, root privileges should no longer be required.

6. Run the authorization program (./tgauth). The dialog should be like this
   
               Opened log file for current session: tgauth.log
   
   
               LOCATION OF AUTHORIZATION FILES
   
               Enter the directory where the authorization will be kept
               (Default is "/usr/TrueGrid")
                        Directory:
   
   Note 1: (Default is "<tg directory>") points to the current directory
           (in this case /usr/TrueGrid). You may hit the <enter> (<return>)
           key if this is acceptable or may type in a directory name. Whatever
           is used for the directory must be put into the TGHOME environment
           variable.

                HOST NAME OF DESIGNATED TrueGrid SERVER
   
                Enter the host name (or IP address) of the machine
                on which the TrueGrid License Manager will reside.  (Default is "dumcomputer")
                Host Name:

   Note 2: (Default is "<hostname>") hostname is the name for the current
           machine in the /etc/hosts file (e.g. dumcomputer). You probably
           want to take the default (just hit <enter> (<return>) key).  
                NAME OF COMPANY
   
                Enter the name of your company or organization
                      Company Name:
   
   Note 3: Enter a name for your company (e.g. XYZ Scientific App.) and include
           it in the information for authorization. Case and punctuation is
           important.
           ("XYZ Scientific App." is different from "Xyz Scientific App.",
           "XYZ Scientific App", and "xyz scientific app.".)
           Shorter names provide less possibilities for problems (e.g. "XYZSA"
           rather than "XYZ Scientific App.").
   
                OBTAIN AN AUTHORIZATION CODE FROM:
   
                     XYZ Scientific Applications, Inc.
                     1324 Concannon Boulevard
                     Livermore, CA  94550
                     PHONE (925) 373-0628
                     FAX   (925) 373-6326
                     EMAIL info@truegrid.com
   
                REPORT THIS INFORMATION TO XYZ
                        Company Name: <company>
                        Machine ID: <id number>-1
                          Checksum: <check number:
                     Number of Users
                 Authorization Type (perpetual, trial or special)
   
   Note 4: <company> above will be replaced with whatever you typed in for your
                     company name above (see Note 3). 
           <id number> should be a long (around 10 digits) number which
                       identifies your machine. If it is not followed by a "-1"
                       then the dongle is not properly installed or is not
                       working correctly.
           <check number> is typically the letter "B" followed by a long
                       (usually about 10 digits) number.
   
                ENTER YOUR AUTHORIZATION CODE
                Authorization Code:
                          Checksum:
   
   
   Note 5: We will then provide you with an authorization code and checksum to
           fill in here. Typically, the authorization code is a groups of 5
           upper case letters separated by spaces. There sometimes is an
           additional upper case letter at the end; e.g.:
                TTHIS WWILL BEAAA LLONG SSSET OFBIG LETTE RSSSS D   .
           The Checksum is another long number. This changes every time you 
           These must be entered exactly. If there is a checksum error,
	   you will get another opportunity to enter the correct authorization
	   code and checksum. Once the authorization code and checksum are
	   accepted, DO NOT RE-ENTER THEM. This will unauthorize your
	   machine.

                AUTHORIZATION ENTRY SAVED TO <tg directory>/.tgauth
   
                UPDATED STARUP FILE "start_tg" IN "<tg directory>"

   Note 6: <tg directory> is the directory name you entered above (see Note 1).
           .tgauth contains the authorization code plus the host name and
           company name entered above (Notes 2 an 3, respectively), plus a
           number which will change from time to time. start_tg is a script
           which starts up the license manager. If TrueGrid gives you the
           message:
   
               TrueGrid : License Manager does not respond.
   
                 TrueGrid License Manager is probably not running.
                 Run "start_tg" to restart the license manager.
   
           you will need to run the file found here.
    
                START THE LICENSE MANAGER DAEMON NOW (y or n)?
   
   Note 7: If the response is "y", the start_tg file will be executed.
           Otherwise, start_tg will need to be run before Truegrid will work

7. Check to see if everything works (./tg).  

The start_tg files is a script that needs to be run each time the machine is
rebooted. Alternatively, a line can be added to the /etc/inittab file so that
the license manager is restarted automatically when the system boots up. For
example,

tglm:23:once:/usr/TrueGrid/LM/tglm /usr/TrueGrid

The latter part of this line is found in the start_tg file. You will need to
be root to make these modifications to the inittab file and you should know
what you are doing.

You may also wish to include $TGHOME in the path so that the system knows
where to find tg.

Also see: Install_UNIX.txt
