Installing BBj 5.x-9.x — UNIX/macOS

Follow these instructions for installing BBj versions 5.x-9.x on UNIX/macOS. For BBj versions earlier than 5.x, 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/macOSrequirements

  • 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 (UNIX) or an admin user (macOS) prior to installing the BASIS Product Suite.

Web Download Installation Steps(return to top)

  1. Recommended: Log in asroot (UNIX) or an admin user (macOS).

  2. Download the self-extracting .jar file from:
    https://www.basis.cloud/bbj-download

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

    1. If the Java file associations on your operating system are set up to run an executable jar file, double-click (in GUI) or execute (CUI) the downloaded jar file. The installation proceeds automatically.
      Example:
      ./2145501.jar

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

      UNIX Example:

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

      macOS Example:

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

CD-ROM Installation Steps (return to top)

  1. Recommended: Log in as root (UNIX) or an admin user (macOS).

  2. Insert the BASIS Product CD.

    UNIX:

    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. Execute the appropriate script for your platform.

    UNIX:

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

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

    macOS:

    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. 

    UNIX example:

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

    macOS example:

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

See Also

Uninstalling BBj