Installing BES/BDOC on IBM AIX

This document describes procedures for installing either BES or the Borland Deployment Op-Center (BDOC) on IBM AIX (32 and 64 bit).

Important: For BES/BDOC 6.0 Release Notes, go to http://info.borland.com/devsupport/bes/relnotes/6_0.html.

Preparing for installation

Before installing either BES or BDOC on IBM AIX you should:

• check platform requirements
• check system requirements
• check JDK requirements

Platform and system requirements

For the latest platform information and system requirements go to http://www.borland.com/techpubs/bes/platforms.

JDK requirements

The installation package for IBM AIX does not ship any version of the Java Development Kit (JDK). For information on Java products for IBM AIX go to http://www.ibm.com/developerworks/java/jdk.

Before installing on IBM AIX, you must have the following:

• an existing JDK 1.4

Important: Make sure to put the JDK bin directory into the path variable.

To check the location of your JDK and the version, use the following syntax:

$which java

/usr/local/bin/java

$java -version

java version "1.4.1"

Licensing and Registration

BES and BDOC MUST be licensed before they will run. For information on how to license your product, go to http://www.borland.com/devsupport/bes/faq/6.0/licensing/index.html.

Installing BES/BDOC on IBM AIX

BDOC: A BDOC installation creates a new installation of BDOC or upgrades an existing BES installation.

Important: Please read the following section, File ownership and the iaschangeowner script on changing file permissions using the iaschangeowner script.

You can install BES or BDOC from either CD or download it from the web.

To install BES/BDOC on IBM AIX:

1. If you are downloading BES/BDOC from the web site, untar the installer .bin file from the archive.

   BES archives:

   • BDP60_AIX32.tar
   • BDP60_AIX64.tar

   BDOC archives:

   • BDOC_AIX32.tar
   • BDOC_AIX64.tar
2. Obtain all permissions, or chmod to run the install script.
3. To run the install file, invoke the following command:

   sh <installer>.bin

   where <installer>.bin is one of the following:

   BES install files:

   • BDP60_AIX32.bin
   • BDP60_AIX64.bin

   BDOC install files:

   • BDOC_AIX32.bin
   • BDOC_AIX64.bin
4. If you are installing from CD, enter one of the following commands to launch the installer:

   $ /cdrom/aix32/Install_aix32.bin

   or

   $ /cdrom/aix64/Install_aix64.bin

   where /cdrom is the directory where CD-ROM is mounted.

Note: To run in console mode execute this command:

<install file.bin> -i

5. When the installer launches, follow the onscreen installation panels.

File ownership and the iaschangeowner script

Some files and directories, such as log files, properties, sessionSwap, realms, etc., are not created at installation. Instead, they are created at runtime, the first time the server is started. Permissions on these files and directories are granted based on the user running the server at this initial time. For example, if you run the server for the first time as usernameA, some files or directories will be owned by usernameA. Any subsequent running of the server by any other user (including root) will result in error due to permission problems. File ownership must be changed in order to allow any other users to write to these files.

Changing ownership of a server instance

To change ownership use the iaschangeowner script (UNIX only) in the .bin directory of your installed BES or BDOC.

The following directories (and their contents) are affected by the iaschangeowner script:

• <install_dir>/var/templates/configurations/examples
• <install_dir>/var/domains/base/configurations
• <install_dir>/var/domains/base/adm
• <install_dir>/var/repository
• <install_dir>/var/templates

Usage

Below are usage parameters for iaschangeowner.

• -r <install_dir>: the root directory of installation
• -o <new owner>: the user id of the new owner, such as nobody, root, etc.
• -g <new group>: the group id of the new group
• [+a|-a]: configures Apache Web Server to run suid root (a+ or to run as the user UID and group GUID (-a).

Usage example

The following is an example using the iaschangeowner script to change the user name and group:

% iaschangeowner -r /usr/BES -o jsmith -g admin

Failure to change permissions prior to changing server owners will result in errors similar to the following:

<install_root>/sk.txt: cannot create

Configuring Apache to run on a privileged port

Running Apache on a privileged port requires that the executable is owned by root and that the suid bit is set. Apache is dynamically linked and the dynamic loader must resolve and load dependencies. Unix loaders will not typically search libarary paths that are not secure and will not respect environment variables such as LD_LIBRARY__PATH or LIBPATH for setuid programs.

Note: Ownership is not changed on any files or directories when invoking $CMD with the a+ or a-, except on the Apache httpd daemon.

The iaschangeowner script has been modified to make privileged port access as simple as possible. The httpd daemon must be owned by root and must be associated with the root primary group. Consult your system documentation or your administrator for detailed information on these permissions. Typically you can identify the appropriate values using id:

## on Linux, AIX and HP-UX

/> id -n -g root

sys

## on Solaris /> id -a root

sys

The parameters passed to iaschangeowner must match these values. iaschangeowner is using this call internally and will fail if the values don't match.

Invoking CMD +a causes soft links to be created in $SECURE_DIR to appropriate libraries within the specified installation. httpd owner and group affiliation is assigned from the -o and -g parameters passed to $CMD. httpd will be configured to run suid.

Invoking $CMD -a causes soft links to be removed from $SECURE_DIR. httpd owner and group affiliation is assigned from the -o and -g parameters passed to $CMD. httpd permissions will be returned to the installation default.

Configuring Apache httpd.conf to listen on correct port

The file <inst_root>/var/domains/base/configurations/<configuration_name>/mos/apache/conf/httpd.conf must be edited to listen at the correct port (typically 80) and to indicate what UID and GID to run as. In the following example, elise and elgroup are used:

Listen 80

User elise

Group elgroup

To reverse the changes, give appropriate parameters to the UID and GID, and eidt httpd.conf back to its original state.

Installing BES/BDOC on IBM AIX 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 JDK home.

The text file looks like this (for a BES installation):

INSTALLER_UI=silent

USER_INSTALL_DIR=/opt/BES/AIX64/BES

USER_SHORTCUTS=/dev/null

OSAGENT_PORT=14000

MANAGEMENT_PORT=42424

SERVER_NAME=besaix

JVM_JDK_HOME=/jdk/jdk1.4.2

INSTALL_TYPE_1=Borland Enterprise Server (BES)

CONFIGURATION_SETUP=Yes

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.

Note: All properties and values are case-sensitive.

Note: ALWAYS use a forward slash (/).

To invoke the silent installation process:

1. Open a command-line shell.
2. Go to the directory where you downloaded the installer and invoke the silent installation process by entering one of the following commands. Make sure to specify the full path name of the propertiesfile file.

   BES:

   BDP60_AIX64.bin -f <path to properties file>

   or

   BDP60_AIX32.bin -f <path to properties file>

   BDOC:

   BDOC60_AIX64.bin -f <path to properties file>

   or

   BDOC60_AIX32.bin -f <path to properties file>

   where <path to properties file> is the full path of the propertiesfile file.

3. If installing from CD-ROM:
   • Insert the CD into the CD-ROM drive.
   • Open a command-line shell.
   • Go to the CD-ROM directory.
   • Invoke the silent installation process by entering one of the following commands. Make sure to specify the full path name of the propertiesfile file.

     BES:

     BDP60_AIX64.bin -f <path to properties file>

     or

     BDP60_AIX32.bin -f <path to properties file>

     BDOC:

     BDOC60_AIX64.bin -f <path to properties file>

     or

     BDOC60_AIX32.bin -f <path to properties file>

     where <path to properties file> is the full path of the propertiesfile file.

Silent install properties file

This properties file applies to silent installation of BES/BDOC on IBM AIX. The property file is a plain text file.

Properties file for silent installation

Uninstalling BES/BDOC

To uninstall BES/BDOC:

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.