FEB MAR Apr 29 2008 2010 2011 7 captures 20 Aug 07 - 29 Mar 10

Close Help

Installing VisiBroker on Red Hat Enterprise Linux 3.0
for MontaVista Linux CGE 4.0 cross platform development

This document describes procedures for installing visiBroker on Red Hat Enterprise Linux 3.0 operating system for MontaVista Linux CGE 4.0 cross platform development with supported target CPU architecture of x86_em64t.

You can install VisiBroker 7.0 from the CD or download VisiBroker from http://www.borland.com/downloads/download_visibroker.html

Note:

Preparing for installation

Before installing on Red Hat Enterprise Linux 3.0 you should:

• check Platform and system requirements
• check JDK requirements

Platform and system requirements

Before installing VisiBroker on Red Hat Enterprise Linux 3.0, check the latest platform information and system requirements.

In addition to platform-specific requirements, Borland VisiBroker components use TCP and UDP Broadcast services to communicate. Even if you are running the components on a single machine you must have TCP and UDP services available.

JDK requirements

The installation package for Red Hat Enterprise Linux 3.0 does not ship any version of the Java Development Kit (JDK). You need a JDK with version 1.4.2 and above to run the installer (both CD image and web downloaded installer). Currently, both IBM and Sun provide JDK for 64-bit platforms. For information on platform support for JDK from Sun, go to Java Platform, Standard Edition. For information on Java products for IBM as well as the system requirements for installation of the JDK, go to http://www.ibm.com/developerworks/java/jdk.

Important: Before installing on Red Hat Linux, you must have an existing JDK installed. 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
/opt/local/bin/java
java version "1.5.0_06"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05)
Java HotSpot(TM) 64-Bit Server VM (build 1.5.0_06-b05, mixed mode)

Mounting the VisiBroker CD on Red Hat Enterprise Linux 3.0

The Borland VisiBroker CD includes installation software for the Red Hat Linux operating systems. This section describes how to prepare to install VisiBroker on Red Hat Enterprise Linux 3.0 from CD.

1. Log in as a user with root authority.
2. Insert the CD-ROM in the drive and enter the following command:

    # mount -t iso9660 -o ro /dev/cdrom /cdrom 

   where /cdrom represents the mount point of the CD-ROM.

If you are using auto-mounting software, the CD-ROM is mounted automatically to the directory specified in your auto-mount configuration when you insert it into the CD-ROM drive. You can proceed with instructions given in Installing Borland VisiBroker .

To check if you have auto-mounting software, use the following command:

$ ps aux | grep automount

root 628 0.0 0.2 1148 588 ? S 17:32 0:00 /usr/sbin/automount

Go to root and enter the following command:

umount /cdrom (if you have manually mounted the CD-ROM)

eject cdrom (if you have used auto-mounting software to mount the CD-ROM)

Installing VisiBroker on Red Hat Enterprise Linux 3.0

You can install VisiBroker from the CD or download the software from the Borland web site: http://www.borland.com/products/downloads/download_visibroker.html

Before you install VisiBroker, select the installation method:

• If you want to download a version of the product from the Borland web site, go to the web site mentioned above.
• If you are installing from CD, place the CD in your CD-ROM drive.
• If you want to perform a silent installation using definitions from a properties file, see Invoking silent installation.

To install VisiBroker from a CD:
1. Mount the CD-ROM.
2. Enter the following command to launch the installer:

   install_linux

   The installation wizard launches a separate window.

3. Select the product you want to install.
4. Follow the installation wizard's onscreen instructions. For most options, defaults offered by the installation wizard are acceptable. You can use the Previous button to return to earlier screens and change any information that is incorrect.

If installing from a downloaded file:

1. Invoke the appropriate command to launch the installer.

java -cp <installer file>-<release number>-CROSS-linux-montavista-x64.jar install

For console mode installation, use -i console option.

Follow the installation wizard's onscreen instructions. For most options, defaults offered by the installation wizard are acceptable. You can use the Previous button to return to earlier screens and change any information that is incorrect.

2. Introduction: Read the Introduction and click Next.
3. License agreement: Installation and use of VisiBroker requires acceptance of the license agreement.
4. Choose the Install Folder:

   This creates a new installation of VisiBroker, or adds components to an existing installation.

   To create a new installation, either accept the default location or choose another location.

   Important: You cannot install this version of VisiBroker on top of previous releases.

5. Choose Product Components.

   Depending on the Borland Deployment Platform product you are installing, select from the following product components for each feature set:

   VisiBroker Console: GUI and tools for managing VisiBroker ORB and services.

   VisiBroker Core: VisiBroker for Java and C++ development tools and server components.

   Documentation: Suite of online documentation.

   Examples: Example applications for Borland Enterprise Server.

   VisiBroker Extended Services: Optional components you purchase for extended VisiBroker functionality.

6. Choose VisiBroker Extended Services: If you chose the option to install the VisiBroker Extended Services you purchased, select from the following extended services:

   VisiNotify: An industrial strength, ORB-level implementation of the OMG Event/Notification Service.

   VisiSecure: A framework for establishing secure connections between clients and servers.

   VisiTime: A complete implementation of the OMG Time Service Specification, Version 1.1.

   VisiTransact: A complete implementation of the OMG transaction management solution for transactions with CORBA applications over the Internet or intranets.

   VisiTelcoLog: An OMG compliant implementation of the OMG Telecom Log Service specification version 1.1.2

7. Choose Install Type: There are two types of install: Typical install type and Custom install type
   • Typical install type is the express install and uses default settings.

   • In Custom Install type, you can specify the Smart Agent port.
   • Smart Agent port is also known as the osagent. This port is used by the ORB to communicate with the server. You can choose any value between 5000 and 65535. The default is 14000.
   • You can choose the default JDK. If you don't want to use the default JDK, select the JDK home path by clicking the choose button.
8. Pre-Installation Summary: Review the displayed information before proceeding with the installation. You can click the Previous button to revisit and change any selections you made except your choice for which product to install. To approve your choices and start installing, click the Install button.
9. When the installation completes, to dismiss the installer, click Done.

Install log

The installer generates an install log that is written to the root of the installation directory if you installed VisiBroker from CD, or to the folder where the installer file resides if you used a downloaded file to install VisiBroker.

The VisiBroker install log file is:

<install_dir>/Borland_VisiBroker_InstallLog.xml

The file is an XML formatted log with installation-specific information, such as errors.

Running the installer without a GUI

The installer is capable of running in a text only mode for UNIX systems. You can invoke the installer with a parameter which specifies the UI mode.

To run the installer in text-only mode:

1. Change directories to the folder where the installation executable file is and enter the following command:

   java -cp <install_file>.jar install -i console 

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

   The installer will write to stdout and read from stdin. This allows you to telnet from one system to another and run the installer remotely.

Configuring VisiBroker for C++ server, VisiTransact, or VisiNotify license variables

Before running VisiBroker C++ server, VisiTransact, or VisiNotify, you need to set two license environment variables (BES_LIC_DIR and BES_LIC_DEFAULT_DIR). During installation, a shell script is created for you to use for setting these environment variables.

To set the variables:

1. Open a command window.
2. Change directory to <install_dir>/bin.
3. Determine the appropriate script for your shell.

   If you are using the Korn or Bourne shell, use the following script to set environment variables:

   vbroker.sh

   If you are using the C shell, use the following script to set environment variables:

   vbroker.csh

4. To run the script automatically when you log in, add a command to your .profile, .cshrc, or .login file.

Using silent installation

You cannot reinstall VisiBroker over a previous installation in the same VisiBroker 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. 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. Each property must be listed on its own line, terminated by a carriage return, with no blank spaces at the end of each line and no blank lines at the end of the file. See the Properties file for silent installation section for more information.

After creating the text properties file, save it as <propertiesfile>.txt, where <propertiesfile> is the filename prefix for your properties file. Now you can invoke the silent installation process using the values specified in the properties file(s).

Note: All properties and values are case-sensitive. When specifying directory and file paths, always use a forward slash.

Properties file for silent installation

The properties file is a plain text file, with each property listed on its own line, terminated by a carriage return, with no blank spaces at the end of each line and no blank lines at the end of the file. The properties can appear in any order in the file.

Properties File Contents for Silent Installation

Variable	Value
INSTALLER_UI	silent (required). The mode of installation.
USER_INSTALL_DIR	<install_dir> (required). The full path name for the VisiBroker. The default installation directory is /opt/Borland/VisiBroker.
OSAGENT_PORT	(optional). Default is 14000.
USER_SHORTCUTS	The required value is /dev/null.
INSTALL_DOCS	Installs the suite of online documentation. Default is YES.
INSTALL_EXAMPLES	Installs the example applications for VisiBroker. Default is YES.
INSTALL_TYPE	(Required) VisiBroker Installs VisiBroker
JVM_JDK_HOME	(optional). Sets the JDK path for VisiBroker components that host user application code. The default is set to the location where the JDK included with VisiBroker is installed.
INSTALL_VBCONSOLE	Installs the GUI and tools for managing VisiBroker ORB and services. Default is YES.
INSTALL_VISICORE	Installs the VisiBroker for Java and C++ development tools and server components. Default is YES.
VISI_SERVICES	When INSTALL_TYPE is VisiBroker, installs any optional VisiBroker Extended Services you purchased. The value is a comma-delimited list that contains one or more of the following entries: VisiNotify VisiSecure VisiTime VisiTransact VisiTelcoLog For example, if you purchased VisiBroker Edition with VisiNotify and VisiTransact, include the following line in your silent installation <properties> file to install those additional services: VISI_SERVICES=VisiNotify,VisiTransact For a description of each optional Extended Service, see the Choose VisiBroker Extended Services section in VisiBroker Installation Guide.
CONFIGURATION_SETUP	Installs the VisiBroker example configuration. Default is YES.
VISICORE_FEATURES	{Java|.NET} This will determine whether you get Visi for Java/C++, Visi for .NET, or both Default is Visi for Java/C++. This is ignored if you specified INSTALL_VISICORE=NO

Sample silent installation properties for VisiBroker

This example installs VisiBroker on non-default agent port, and installs several VisiBroker Extended Services.

 INSTALLER_UI=silent
 USER_INSTALL_DIR=/opt/Borland/VisiBroker
 USER_SHORTCUTS=/dev/null
 OSAGENT_PORT=14925
 INSTALL_TYPE=VisiBroker
 VISI_SERVICES=VisiNotify,VisiSecure,VisiTime,VisiTransact,VisiTelcoLog

Invoking silent installation

To invoke the silent installation process using the values specified in the properties file:

1. Open a command-line shell.
2. Go to http://www.borland.com/downloads/download_visibroker.html and download VisiBroker for Red Hat Linux.
3. Extract the installer executable from the tar file you downloaded.
4. Go to the directory where you extracted the installer and obtain all permissions, or chmod all, where 777 indicates all, to run the installer.
5. Invoke the silent installation process by entering the following command. Make sure to specify the full path name of the <propertiesfile> file:

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

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

Uninstalling VisiBroker

To uninstall VisiBroker:

1. Make sure there are no background processes (such as osagent) running during the uninstall.
2. Change directories to <install_root>/UninstallerData directory.
3. If you are installing using a web download, enter the command:

   java -cp uninstaller.jar uninstall

4. If you are installing using CD, enter the uninstall command:

   uninstall
   

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

5. After you run the uninstall command, check the installation directory and remove any unnecessary files and subdirectories.