Installing the Borland Enterprise Server on HP-UX

This document describes procedures for installing the Borland Enterprise Server on HP-UX.

Preparing for installation

Before installing on HP-UX you should:

System requirements

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

Browsers

To use the Web engine and Web Administration Tool included with the Borland Enterprise Server, you need one of the following Web browsers:

JDK requirements

The Borland Enterprise Server installation package for HP-UX does 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/.

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

Borland Enterprise Server 5.2.x supports both JDK 1.4 and JDK 1.3. During installation you can specify which default JDK version you want the Server to use after installation is complete. The default version you specify is used for components that host user application code, for example, in Partitions (including the Standard Partition), and the application client container, "VisiClient Container". You can change the JDK version each Partition runs on using the Borland Management Console. For more information, refer to Borland Enterprise Server User's Guide, online Help Topics, "The Server's View".

JAVA_HOME environment variable

Make sure to update the JAVA_HOME environment variable to reflect the JDK installation directory. Also, update the PATH environment variable to include your JAVA_HOME/bin.

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 on the Borland web site http://www.borland.com/techpubs/bes.

Important: The messaging core service product, SonicMQ, is bundled with the 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.

Other services included with Borland Enterprise Server

Apache Web Server 2.0

The Apache Web Server 2.0 is included with this version of Borland Enterprise Server.

For information about the Apache Web Server, refer to Borland Enterprise Server Developer's Guide online Help Topics or PDF. Also, refer to the Apache documentation in the <install_dir>\bin\apache2\ included with Borland Enterprise Server.

SonicMQ messaging service

The messaging core service product, SonicMQ, is bundled with the 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 included with the Borland Enterprise Server in <install_dir>\SonicMQ\sonicmq-docs\.

Licensing and Registration

Before installing the Borland Enterprise Server, make sure you have the license keys to run the Borland Enterprise Server edition you have purchased and its related components. If you have not received a license for the Borland Enterprise Server, contact your Borland sales representative.

If you do not provide license information during the installation process, you will be able to complete the installation. However, you are required to enter license information later using the Management Console.

For more information on using the Borland Management Console to license and register your server, go to the Borland Enterprise Server online Help Topics or PDF: Installation Guide "Licensing and registering using the Borland Management Console".

Note: If you are installing only a client, you must provide license information during the installation process.

Installing the Borland Enterprise Server on HP-UX

To install the Borland Enterprise Server on HP-UX:

  1. If installing Borland Enterprise Server by downloading from the Borland web site:

If installing Borland Enterprise Server from CD:

  1. Enter $ cd /mnt/cdrom
  2. $ /HP64/InstallHP_64.bin (for 64 bit installer) or $ /HP32/InstallHP_32.bin (for 32 bit installer).

When the installer launches, follow the onscreen installation panels.

Important: On the Java Development Kit panel you must enter the path of your JDK 1.4 and JDK 1.3. The installer will not let you proceed without this correct information.

Change user/group privileges from "nobody" to a valid non-priveleged user/group combination

If you are starting the Borland Enterprise Server as root user/group, the Server automatically switches root to "nobody". HP-UX does not support user/group=nobody. You must change nobody to another valid non-privileged user/group combination for your system. Note, you only need to do this if you are starting the Server from a privileged (root) account.

To change this property using the Borland Management Console:

  1. In the Installations view, select the server instance in the server tree.
  2. Go to the Property Files tab in the work pane.
  3. Select the server file in the structure pane.
  4. Change server.user=nobody to server.user=xxx where xxx is the user name.
  5. Change server.group=nobody to server.group=xxx where xxx is the group name.

To change this property directly in the server.properties file:

  1. Go to <install_dir>/var/servers/<servername>/adm/properties/server.properties.
  2. Change server.user=nobody to server.user=xxx where xxx is the user name.
  3. Change server.group=nobody to server.group=xxx where xxx is the group name.

Uninstalling the Borland Enterprise Server

To uninstall the Borland Enterprise Server:

  1. Make sure there are no background processes like osagent running during the uninstall.
  2. Invoke the uninstaller which is available in <install_root>/UninstallerData/uninstall.
  3. After you run the uninstall program, check the installation directory and remove any unnecessary files and sub directories.

    Note: Uninstalling does not remove files and folders that were created after the installation.

  4. It is not necessary to uninstall SonicMQ using the SonicMQ uninstaller. But, you can if you wish, access the SonicMQ uninstaller using the shell script <install_root>/SonicMQ/uninstall.sh.

    The SonicMQ uninstaller will ask you about deleting a large number of files. It is recommended you choose "yes" for these prompts.