Installing BBj 5.x - UNIX/Macintosh OS X

In BBj 9.0 introduced Wizard Scripting so developers can customize the BASIS administrative (admin) wizard and run the wizard via scripting.

In BBj 5.0 and higher, follow these instructions for installing the BASIS Product Suite for UNIX/Macintosh OS X. In addition, find details below on the Product Suite components and requirements, and installation steps from a Web download and CD-ROM.

BASIS Product Suite Components

The BASIS Product Suite includes the following components:

BBj

• BBjServices

• Thin Client

Admin Tools

• Admin

• Enterprise Manager

Utilities

• AutoLic

• BASIC Web Utility (BWU)

• C Library

• Extended Utility Programs (EXT)

• Grid Management Library (GML)

• J Library

• MKRECOVER

• Standard Utility Programs (STD)

Additional Development Tools

• Compiler/Lister

• Configurator

• DDBuilder (Windows only)

• Demos

• GUIBuilder

• Performance Analyzer

• ResBuilder (Windows only)

• ResConverter

BASIS License Manager*

• Admin

BASIS IDE (NetBeans)**

ODBC (Windows only)

JDBC

*Only one BASIS License Manager (BLM) can run on a single machine. If another BLM is running on your machine, uninstall it prior to installing the BLM included with the BASIS Product Suite. The BBj BLM can use any BASIS license, including licenses that the previous BLM handled. However, remember to install those licenses during the BLM installation wizard process.

**The BASIS IDE requires a J2SE Development Kit .The JRE installation will not provide the option of installing BASIS IDE.

BASIS Product Suite System Requirements (return to top)

UNIX requirements

• Java Runtime Edition (JRE) or Java Development Kit (JDK).

• A full installation of the BASIS Product Suite requires 205 MB of permanent disk space and an additional 290 MB of temporary disk space.

Note: BASIS recommends logging in as root prior to installing the BASIS Product Suite.

Macintosh OS X requirements

• Java Runtime Edition (JRE) or Java Development Kit (JDK).

• A full installation of the BASIS Product Suite requires 205 MB of permanent disk space and an additional 290 MB of temporary disk space.

Note: BASIS recommends logging in as an admin user prior to installing the BASIS Product Suite.

Web Download Installation Steps (return to top)

UNIX - GUI

1. Log in as root (recommended).

2. Download the self-extracting .jar file from:

https://www.basis.com/devtools/bbj/download.html

3. Initialize the installation in either of the following ways:

• If the Java file associations on your operating system are set up to run an executable jar file, double-click or execute the downloaded jar file. The installation proceeds automatically.

• If Java file associations differ and do not run the file automatically, execute the following so Java runs the file:

$JAVA_HOME/bin/java -jar <jar_file_name>

Note: It is possible to force the selection of the JVM via a command line parameter to the installation: -is:javahome <Java home directory>.

This additional parameter specifies the home directory location of the JVM used for the installation. The JVM that resides in the specified directory must be a BASIS-supported JVM for this command line option to take effect.

Example:

java -jar 2145501.jar -is:javahome /usr/local/java/jdk1.5.0_04

UNIX - CUI

1. Log in as root (recommended).

2. Download the self-extracting .jar file from:

https://www.basis.com/devtools/bbj/download.html

3. Initialize the installation in either of the following ways: 

• If the Java file associations on your operating system are set up to run an executable jar file, execute the downloaded jar file.

Example:

./2145501.jar

• If Java file associations differ and do not run the file automatically, execute the following so Java runs the file:

$JAVA_HOME/bin/java -jar <jar_file_name>

Note: It is possible to force the selection of the JVM via a command line parameter to the installation: -is:javahome <Java home directory>.

This additional parameter specifies the home directory location of the JVM used for the installation. The JVM that resides in the specified directory must be a BASIS-supported JVM for this command line option to take effect.

Example:

java -jar 2145501.jar -is:javahome /usr/local/java/jdk1.5.0_04

Mac OS X

1. Log in as an admin user (recommended).

2. Download the self-extracting .jar file from:

https://www.basis.com/devtools/bbj/download.html

3. Initialize the installation in either of the following ways: 

• If the Java file associations on your operating system are set up to run an executable jar file, double-click or execute the downloaded jar file. The installation proceeds automatically.

• If Java file associations differ and do not run the file automatically, execute the following so Java runs the file:

%JAVAHOME%/bin/java -jar <jar_file_name>

Note: It is possible to force the selection of the JVM via a command line parameter to the installation: -is:javahome <Java home directory>.

This additional parameter specifies the home directory location of the JVM used for the installation. The JVM that resides in the specified directory must be a BASIS-supported JVM for this command line option to take effect.

Example:

CD-ROM Installation Steps (return to top)

UNIX

1. Log in as root (recommended).

2. Insert the BASIS Product CD. Mounting commands and mount points vary among different UNIX platforms. For mounting instructions, consult the hardware documentation.

HP-UX example: 
/usr/sbin/mount -F -O ro,cdcase /dev/

AIX 4.x example: 
/etc/mount -o ro -v cdrfs /dev/cd0 /mnt

3. Navigate to the appropriate directory on the CD and execute unix.sh:

Example:

/media/cdrom/bbj/rev501/unix.sh

Note: It is possible to force the selection of the JVM via a command line parameter to the installation: -is:javahome <Java home directory>. 

This additional parameter specifies the home directory location of the JVM used for the installation. The JVM that resides in the specified directory must be a BASIS-supported JVM for this command line option to take effect. 

Example:

/media/cdrom/bbj/rev501/unix.sh -is:javahome /usr/local/java/jdk1.5.0_04

Mac OS X

1. Log in as an admin user (recommended).

2. Insert the BASIS Product CD.

3. Navigate to the appropriate directory on the CD and double-click mac.command:

Example:

<cdrom drive>/bbj/rev501/mac.command

Note: It is possible to force the selection of the JVM via a command line parameter to the installation: -is:javahome <Java home directory>. 

This additional parameter specifies the home directory location of the JVM used for the installation. The JVM that resides in the specified directory must be a BASIS-supported JVM for this command line option to take effect.

Example: