Installing BES/BDOC on Windows Itanium

This document describes procedures for installing either BES or the Borland Deployment Op-Center (BDOC) Windows Itanium.

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 Windows Itanium 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 on CD includes a bundled version of the Java Development Kit (JDK). However, if you are downloading BES/BDOC from the web, you need an existing JRE 1.3, or above in your environment in order to run the installer.

Important: If you are downloading BES/BDOC from the web, you need a 64-bit version JRE 1.3 or above. An x86 version can not be used to run the installer.

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:

prompt>java -version

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 Windows Itanium

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

Important: No icons or shortcuts will be created in the Windows interface. All commands must be executed from the command-line.

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

To install BES/BDOC on Windows Itanium:

1. If you are downloading BES/BDOC from the web site, unzip the .zip file to access either the BDOC JAR file (BDOC60_Windows_ia.jar or the BES JAR file (BDP60_Windows_ia.jar), depending on what you chose to download.
2. To run the install file, invoke the following:

   
   prompt>java -cp <jar-file-name> install
   
   

3. If you're installing from CD, use the following to launch the installer if autorun is disabled:

   
   cdrom/install_windows.exe
   
   

   where cdrom is the directory where CD-ROM is mounted.
4. When the installer launches, follow the onscreen installation panels.

Installing BES/BDOC on Windows Itanium 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=c:/BDP

USER_SHORTCUTS=/dev/null

OSAGENT_PORT=14000

MANAGEMENT_PORT=42424

SERVER_NAME=beswinia

JVM_JDK_HOME=c:/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 the following command. Make sure to specify the full path name of the propertiesfile file:

   
   prompt>java -cp installer.jar install -f <path-to-properties-file>
   
   

   for BES, or

   
   prompt>java -cp installer.jar install -f <path-to-properties-file>
   
   

   for BDOC, where <path-to-properties-file> is the full path of the propertiesfile file.

If installing from CD-ROM, insert the CD into the CD-ROM drive.

1. Open a command-line shell.
2. Go to the CD-ROM directory and navigate to cdrom\windows\windows\installer.jar.
3. Invoke the silent installation process by entering the following command. Make sure to specify the full path name of the propertiesfile file:

   
   prompt>java -cp installer.jar install -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 Windows Itanium. 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. Navigate to <install_root>/UninstallerData/.
3. Invoke the uninstaller by entering the command:

   java -cp <install_dir>/UninstallerData/uninstaller.jar uninstall