Installing BBj 5.x - Windows

In BBj 5.0 and higher, follow these instructions for installing the BASIS Product Suite for Windows 98/Me/NT 4.0/2000/XP. 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

• Demos

• GUIBuilder

• Performance Analyzer

• ResBuilder

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

Windows 2000/XP requirements

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

• Password-protected local administrator account

Windows 98/ME requirements

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

o Install the Microsoft Data Access Components (MDAC) before installing BBj. Download the required files for Windows 98/ME directly from Microsoft at: http://www.microsoft.com/data/download.htm.

All operating system requirements

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

• Abstract Windowing Toolkit (AWT) requires a 256-color display for successful installation. If the system has a color resolution less than the required color depth, the installation will fail.

Web Download Installation Steps (return to top)

Windows 2000/XP

1. Log in as an admin user.

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

Windows 98/ME

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

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

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

Windows 2000/XP

1. Log in as an admin user.

2. Insert the BASIS Product CD.

• With AutoRun, the BASIS Product Installation menu displays automatically. To begin the installation, click the "Install BASIS Product Suite" button in the lower left-hand corner of the display.

• Without AutoRun, navigate to the appropriate directory on the CD. To start the installation, double-click the ‘Windows.exe’ executable. Example:

<cdrom drive>\bbj\rev501\windows.exe

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:

Windows 98/ME

1. Insert the BASIS Product CD.

• With AutoRun, the BASIS Product Installation menu displays automatically. To begin the installation, click the "Install BASIS Product Suite" button in the lower left-hand corner of the display.

• Without AutoRun, navigate to the appropriate directory on the CD. To start the installation, double-click the ‘Windows.exe’ executable. Example:

<cdrom drive>\bbj\rev501\windows.exe

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: