Installing Early Versions of BBj - UNIX

 

Follow these instructions for BBj 4.x and earlier.

Pre-Installation Checklist

Before starting the installation process:

  1. Log in as root.

  2. If this is a GUI install, start an Xterm session.

  3. Set an environment variable called BASIS_JAVAHOME to the directory that the java binary resides in. (The BBj Data Server uses this variable to locate the java executable so that it can run correctly.)

  4. If the BASIS License Manager (from a previous install) is running, shut it down. Use the grep command to determine if it is running. For example:

ps waux | grep blm

With the process ID, use the killprocess_id command to stop the BLM and BBj Data Server.

If this is a CUI install, set the environment variable TERM to the appropriate terminal type.

Move to the appropriate directory and run the .sh file. The following is an example of running the shell script for the Sun Solaris 7 (Intel) port:

sh ./2169xxx.sh

Note #1: The TERM type set in the emulator must be the same TERM type that is set in the UNIX environment prior to installation. This will ensure that graphics appear correctly.

Note #2: The minimum window size setting that is necessary for the install scripts is 80x24.

Note #3: Whatever font is selected must be supported by the terminal type and have upper order ASCII characters in order for the display to look correct. TERMINAL is the recommended font.

Troubleshooting Note:

If a there is a problem with the install in the /tmp directory, an environment variable can be set to point to another directory that will then be used as a temporary directory for the installation.

The environment variable is BASIS_TMPDIR. It should be set to a directory with sufficient space and permissions.

Examples

BASIS_TMPDIR="/var/tmp"
Export BASIS_TMPDIR

BASIS_TMPDIR="${HOME}/tempdir"
Export BASIS_TMPDIR

NOTE: The example provided above is only a sample. The syntax for setting environment variables may be different depending on the shell.

How to Run BBj in UNIX

After installing BBj there will be a <install_dir>/bin directory that contains the scripts for running BBj, the administration tool, and the other BBj components.