Installing BES VisiBroker on SUSE Linux Enterprise Server (SLES) 8 for IBM zSeries

This document describes procedures for installing BES VisiBroker on SLES 8 for IBM zSeries.

Important: For the Borland Enterprise Server 6.0 VisiBroker Edition Release Notes, go to: http://info.borland.com/devsupport/bes/relnotes/6_0/VBE60_Tier2_Release_Notes.html.

Preparing for installation

Before installing on zSeries you should:

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

JDK requirements

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

Before installing BES VisiBroker on zSeries, you must have the following:

• an existing Java Development Kit (JDK) 1.4.1 in your environment
• Java 2 Runtime Environment (JRE), Standard Edition (build 1.4.1)
• Classic VM (build 1.4.1, J2RE 1.4.1 IBM build cx3901411-20030930 (JIT enabled: jitc))

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.

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"

Platform and system requirements

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

Browsers

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

• Netscape Navigator, version 4.6 or later
• Microsoft Internet Explorer, version 5.0 or later

Licensing and Registration

Before installing BES VisiBroker, make sure you have the correct license key. If you have not received a license, contact your Borland sales representative.

Installing BES VisiBroker on zSeries

To install BES VisiBroker on zSeries:

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

1. The installation must be installed as root.
2. If you are downloading from the web site, obtain all permissions, or chmod to run the install script.
3. After saving the .bin file, you can then run it to launch the installer.
4. To run the install file, invoke the following:

   $ sh s390/Install_s390.bin

   or

   $ sh s390x/Install_s390x.bin

   To run in console mode, execute:

   sh s390/Install_s390.bin  -i console

   or

   s390x/Install_s390x.bin -i console

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

   Important: You may get the following disk space warning message when BES VisiBroker prepares to install. The message instructs you to set the IATEMPDIR environment variable to a directory with enough disk space:

   Preparing to install...
   
   WARNING: /tmp does not have enough disk space!
   
            Attempting to use /home/usr for install base and tmp dir.
   
    
   
   WARNING! The amount of /tmp disk space required to perform
   
   this installation is greater than what is available.  Please
   
   free up at least 227157 kilobytes in /tmp and attempt this
   
   installation again.  You may also set the IATEMPDIR environment
   
   variable to a directory on a disk partition with enough free
   
   disk space.  To set the variable enter one of the following
   
   commands at the UNIX command line prompt before running this
   
   installer again:
   
    
   
   - for Bourne shell (sh), ksh, bash and zsh:
   
    
   
        $ IATEMPDIR=/your/free/space/directory
   
        $ export IATEMPDIR
   
    
   
   - for C shell (csh) and tcsh:
   
    
   
        $ setenv IATEMPDIR /your/free/space/directory

Installing BES VisiBroker on zSeries 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:

INSTALLER_UI=silent

USER_INSTALL_DIR=/vol1/BES/s390/VisiSilent/

USER_SHORTCUTS=/dev/null

OSAGENT_PORT=14000

SERVER_NAME=beslinux

JVM_JDK_HOME=/jdk/jdk1.4.2

INSTALL_TYPE_2=Borland VisiBroker Standalone

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:

   s390/Install_s390.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.
   • Go to s390/Install_s390.bin or s390x/Install_s390x.bin.
   • Invoke the silent installation process by entering the following command. Make sure to specify the full path name of the propertiesfile file:

     s390/Install_s390.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 VisiBroker on zSeries. The property file is a plain text file.

Properties file for silent installation

Uninstalling BES VisiBroker

To uninstall BES VisiBroker:

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. It is safe to delete all remaining files in <install_root>.