Installing BBj - UNIX/Mac OS X


Follow these instructions for installing on UNIX/Mac OS X versions 5.x-9.x. For BBj versions earlier than 5x, click here.

In addition, find details below on the BASIS Product Suite components and requirements, and installation steps from a Web download and CD-ROM. See also Silent Installation - BBj.

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.

 

BASIS Product Suite System Requirements (return to top)

UNIX requirements

  • 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.

 

Mac OS X requirements

  • 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:

java -jar 2120501.jar -is:javahome /System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/

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:

<cdrom drive>/bbj/rev501/mac.command -is:javahome /System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/

Uninstall BBj on UNIX

The InstallShield-based installation includes a full-blown, cross-platform, GUI/CUI componentized uninstaller. Launch the uninstaller under Windows from the normal "Add Remove Programs" Control Panel applet. Under other operating systems, the uninstaller is located in the "<BBj-Install-Dir>/_uninst" directory and should be named "uninstaller.bin". This is the preferred method of removing the product for maintaining the InstallShield registry's entries of which products are installed at what revision and where. Although an 'rm -rf" will remove the product, it results in an out of synch vpd.properties file which may cause future installation complications.



______________________________________________________________________________________

Copyright BASIS International Ltd. BBj®, Visual PRO/5®, PRO/5®, and BBx® are registered trademarks.