Installing BES Using Silent Installation (HP-UX, IBM AIX)

This document describes procedures for installing the Borland Enterprise Server using silent installation for HP-UX and IBM AIX.

Note: For the latest platform information and system requirements for installing Borland Enterprise Server, go to http://www.borland.com/techpubs/bes/platforms.

What is silent installation?

Silent installation is recommended for use in medium to large scale deployments. It is used to set installation configurations, such as new license information, one time, using those configurations for installing on multiple machines. Once the configuration file is set up the silent installation runs without user interaction. The silent install process includes installation of the Java Development Kit (JDK).

Important: Using silent install implies your consent to the Borland Enterprise Server License Agreement.

Preparing for installation

Before using silent installation you should check disk space requirements, JDK requirements, and uninstall any previous versions of the full server. VisiBroker standalone versions do not require uninstalling.

Disk space requirements

The total amount of disk space required to install the Borland Enterprise Server depends on which components you install. For more information, see "Planning your network" in the Borland Enterprise Server Installation Guide and http://www.borland.com/techpubs/bes/platforms.

Note: Disk space includes JDK installation.

JDK

The Borland Enterprise Server installation packages for HP-UX and IBM AIX do not ship any version of the Java Development Kit (JDK). For information on Java products for HP-UX go to http://www.hp.com/products1/unix/java/. For information on Java products for IBM AIX go to http://www.ibm.com/develperworks/tools.

HP-UX

The Borland Enterprise Server infrastructure and tools use JDK 1.4. The messaging component, SonicMQ, is certified to work with JDK 1.3. You must have an existing HP-UX Java Development Kit (JDK) 1.3 and HP-UX JDK 1.4 in your environment before installing the Borland Enterprise Server. You need the full JDKs installed, not just the Java Runtime Environments (JRE).

There are two mandatory JDK parameters (JVM_JDK_HOME) for HP-UX that must be set to the two required JDK versions: JVM_JDK14_HOME=/opt/jdk1.4.1 and JVM_JDK13_HOME=/opt/jdk1.3.1. The values should be paths to the local JDKs.

IBM AIX

The Borland Enterprise Server infrastructure and tools use JDK 1.4. The messaging component, SonicMQ, is certified to work with JDK 1.3. You must have an existing AIX Java Development Kit (JDK) 1.3 and AIX JDK 1.4 in your environment before installing the Borland Enterprise Server. You need the full JDKs installed, not just the Java Runtime Environments (JRE).

There are two mandatory JDK parameters (JVM_JDK_HOME) for AIX that must be set to the two required JDK versions: JVM_JDK14_HOME=/opt/jdk1.4.1 and JVM_JDK13_HOME=/opt/jdk1.3.1. The values should be paths to the local JDKs.

Note: Borland Enterprise Server 5.2.x supports both JDK 1.4 and JDK 1.3. However, AIX does not support JDK 1.4 at this time. For components that host user code, such as Partitions or a client, the default version you specify must be JDK 1.3.x.

VisiBroker standalone installation: VisiBroker standalone versions do not require a JDK 1.4, therefore it is not necessary to have both JDKs 1.3 and 1.4 for VisiBroker standalone installations on AIX.

SonicMQ

The messaging core service product, SonicMQ, is bundled with the full Borland Enterprise Server installation. It installs automatically (requires no user intervention), and does not allow configuration. For more detailed information on the SonicMQ product, refer to the SonicMQ documentation in <install_dir>\SonicMQ\sonicmq-docs\ included with Borland Enterprise Server.

Uninstalling previous versions of Borland Enterprise Server

Note: It is not necessary to uninstall previous versions of VisiBroker standalone.

To uninstall the Borland Enterprise Server:

Shut down any servers that are running.
Make sure there are no background processes such as osagent, running during the uninstall.
Open the installation directory.
Double-click the Uninstall icon.
Click Uninstall to completely remove all components that were installed.
The Uninstall program does not remove any configuration or application files and folders that were created after the installation.

Reinstalling Borland Enterprise Server

You cannot reinstall Borland Enterprise Server over a previous installation in the same BES installation directory, or file location. You must first uninstall any previous version before reinstalling. If you do not uninstall first, you must reinstall to another file location.

Using silent installation

Before invoking the silent installation process, you must first create a text file that contains the properties for configuration settings, such as install directory, server name and serial number. See the Properties file below.

After you've created the text properties file, save it as propertiesfile.fil, where <propertiesfile> is the name of your file. Now you can invoke the silent installation process using the values specified in the properties file.

Invoking silent installation

To invoke the silent installation process:

Open a shell.
If installing Borland Enterprise Server by downloading from the web:
- Go to http://www.borland.com/products/downloads and download the Borland Enterprise Server for HP-UX or AIX.
- Extract the installer .bin file from BES52_HP64/32.tar or BES52_AIX64/32.tar .
- Go to the directory where you downloaded the installer and invoke the silent installation process by entering the following command. Make sure to specify the full path name of the propertiesfile file:
```
installer.bin -f <path to properties file>
```
  where installer is the name of the Borland Enterprise Server installer and <path to properties file> is the full path of the propertiesfile file.
  For example:
```
 BES52_HP64.bin -f /opt/myname/silentproperties.fil 
```
  or
```
 BES52_AIX32.bin -f /opt/home/myname/silentproperties.fil
```
If installing Borland Enterprise Server from CD-ROM:

Insert the Borland Enterprise Server CD into the CD-ROM drive.
Open a shell.
Go to the CD-ROM directory.
Invoke the silent installation process by entering the following command. Make sure to specify the full path name of the propertiesfile file:
```
installer.bin -f <path to properties file>
```
where installer is the name of the Borland Enterprise Server installer and <path to properties file> is the full path of the propertiesfile file.
For example:
```
 install_hpux64.bin -f /opt/myname/silentproperties.fil
```
or
```
 install_aix32.bin -f /opt/myname/silentproperties.fil
```

Properties file

This Windows properties file applies to silent installation of Borland Enterprise Server and/or Borland VisiBroker Standalone. The property file is a plain text file.

Silent installation properties file for HP-UX and AIX)

Variable	Value
INSTALLER_UI	silent (required). The mode of installation.
USER_INSTALL_DIR	<install_dir> (required). The full path name for the Borland Enterprise Server product directory of your choice.
USER_SHORTCUTS	/dev/null (required). Leave as is.
OSAGENT_PORT	(optional). Default is 14000.
SERVER_NAME	<server_name> (required). A server name of your choice.
JVM_JDK_HOME	<install_dir>\jdk\jdk1.4.1 (required) AND <install_dir>\jdk\jdk1.3.1 (required). See JDK section above. NOTE: JDK 1.4 is not necessary for VisiBroker Standalone installations.
BES_SERIAL	<serial_number> optional, required to install with a license.
BES_KEY	<key> optional, required to install with a license.
INSTALL_TYPE_1	Borland Enterprise Sever (required). Installs full Borland Enterprise Server. Use TYPE_1 or TYPE_2, NOT BOTH.
INSTALL_TYPE_2	Borland VisiBroker (optional). Installs Borland VisiBroker Standalone. Use TYPE_1 or TYPE_2, NOT BOTH.

Note: Leave out BES_SERIAL and BES_KEY if you are installing without a license.