This document describes procedures for installing VisiBroker on Installing VisiBroker on SuSE Linux 10 x86, x64 bit operating system.
You can download VisiBroker from http://www.borland.com/downloads/download_visibroker.html
Note:
We recommend uninstalling any previous versions of VisiBroker, or installing the new version to a different location; on a different install path. If you have already installed an evaluation version and have since purchased a license to use VisiBroker on a permanent basis, you do not need to reinstall the version of the software you evaluated. For information on activating your new license, see Borland Product Registration Wizard.Before installing on SuSE Linux you should:
Before installing VisiBroker on SuSE Linux, 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.The installation package for SuSE ships Sun JDK 1.5. 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 SuSE, you must have an existing JDK installed. Make sure to put the JDK 1.5 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 java version "1.5"
The Borland VisiBroker CD includes installation software for the Suse operating systems. This section describes how to prepare to install VisiBroker on Suse from CD.
# mount -t iso9660 -o ro /dev/cdrom /cdromwhere
/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 automountIf you have auto-mounting software, the output should be similar to the following:
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)
To install VisiBroker from a CD:
$ /cdrom/install_linuxwhere
/cdrom
is the directory where CD-ROM is mounted. Important: Make sure the Mozilla /usr/bin
is in your path in order to use the default browser.
Note: To view Readme and installation documentation on the CD, or to browse the contents of the CD, click the appropriate entries on the splash screen.
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.
To install VisiBroker from Web
You can install VisiBroker from http://www.borland.com/downloads/download_visibroker.html
Before you install VisiBroker, select the installation method:
java -cp vb8-<release number>-linux-suse-<arch>.jar installwhere arch is x86/x64
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.
Next
.This creates a new installation of VisiBroker, or adds components to an existing installation.
Important: You cannot install this version of VisiBroker on top of previous releases.
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 andservices.
VisiBroker Core: VisiBroker for Java and C++ development tools andserver components.
Documentation: Suite of online documentation.
Examples: Example applications for Borland VisiBroker.
VisiBroker Extended Services: Optional components you purchase for extended VisiBroker functionality.
VisiNotify: An industrial strength, ORB-level implementation of the OMG Event/Notification Service.
VisiSecure: A framework for establishing secure connections betweenclients and servers.
VisiTime: A complete implementation of the OMG Time ServiceSpecification, Version 1.1.
VisiTransact: A complete implementation of the OMG transactionmanagement solution for transactions with CORBA applications over the Internet orintranets.
VisiTelcoLog: An OMG compliant implementation of the OMG TelecomLog Service specification version 1.1.2
Note: The typical installation does not add the VisiBroker bin
folder to your PATH. To add it,choose the Custom install type.
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
.Note: If you select the default, you may have to manually add certain components to your environment path. If you choose the Custom install type to add the VisiBroker environment variables, the installation sets the BES_LIC_DIR
to <install_dir>/var
and BES_LIC_DEFAULT_DIR
to <install_dir>/license
.
Previous
button to revisit andchange any selections you made except your choice for which product toinstall. To approve your choices and start installing, click the Install
button.Next
. The Registration Wizard launches in a separate window. After you dismiss the Registration Wizard, the installer completion panel displays.<install_dir>/license
directory. If you did not receive a license activation key file, or if you are reinstalling the software, go to http://www.borland.com/downloads/download_visibroker and download a new license key.Important: You must register and activate your license in order to use the product.
Note: If you want to register and activate your license later by running the lmadm
executable found in the <install_dir>/bin
directory. choose"No" and click Next
.
Make a Selection
screen, click on any of the options:Have a serial Number
: Enter the Serial number.
Have Activation file
: Enter the path for the activation file.
Done
.Note: You can register and activate your license later, either by running the lmadm
executable found in the<install_dir>/bin
directory.
On some hosts, license registration wizard (lmadm) might take a long time to start during installation. This behavior is specifically observed when the system is configured to use IPv6 stack. The connection attempts can be slow if the machine's configurations or network settings are incorrect. To resolve this, you must skip the license registration phase during installation and perform licence registration separately after the installation.
Note:
When VisiBroker is installed in NFS mounted directories and if there is insufficient disk space for the system temp directory, post installation cleanup process may not remove all the temporary files as the NFS server periodically locks files in the directories. To resolve this, you must manually clean the temp directories/files after installation.
The installer generates an install log that is written 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.
The installer is capable of running in a text only mode for UNIX systems. You can invokethe installer with a parameter which specifies the UI mode.
To run the installer in text-only mode:
java -cp <install_file>.jar install -i console
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.
Before running VisiBroker C++ server, VisiTransact, or VisiNotify, you need to set twolicense 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:
<install dir>/bin
.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
.profile
, .cshrc
, or .login
file.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 file name 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.
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 | VisiBroker Installs Borland 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:
For example, if you purchased VisiBroker Edition with VisiNotify and VisiTransact, include the following line in your silent installation For a description of each optional Extended Service, see the Choose VisiBroker Extended Services section. |
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 bothDefault is Visi for Java/C++. This is ignored if you specified INSTALL_VISICORE=NO |
This example installs VisiBroker Edition on agent ports, 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
To invoke the silent installation process using the values specified in the properties file:
chmod
777 <installer file>, where 777
indicates all, to run the installer.<propertiesfile>
file:java -cp <installer file>.jar install -f <path to properties file>
Note: After silent installation is completed, you need to register and activate the license you received for your product. The license may be in the form of an email from Borland listing one or more serial numbers and license keys, or it may be a license key file sent to you in an email from Borland. You can also register and activate your license by running the lmadm
executable found in the <install_dir>/bin
directory.
Before using VisiBroker, you need to register and activate the license you received for yourproduct. The license may be in the form of an email from Borland listing one or moreserial numbers and license keys, or it may be a license key file sent to you in an email from Borland.
If you have a valid, node-locked license for previous version of the VisiBroker installed on the same machineas the newly-installed VisiBroker, use the lmadm
command-line tool to migrate your previous license for use with the newly-installed VisiBroker software.
If you have already received a key file in an email from Borland for a product youpurchased online or downloaded for evaluation, or if you downloaded a free version of the product, you can use the registration wizard to apply the key file, or you can copy it to the <install_dir>/license
directory and it will be applied automatically when you restart your product.
If you have a serial number and key, you can register and activate your VisiBroker product using one of the following registration methods:
Depending on which method you choose, you may be asked to indicate whether you have a Borland Developer Network (BDN) account. If you do not have an account, you will be prompted to create one in the product registration wizard.
If you do not choose the Direct registration method, you will receive an activation file. Simply copy this file into the <install_dir>/license
directory and it will be applied automatically when you start your product.
To use the Borland product registration wizard for Direct registration:
Next
.Next
. If you do not have an account you are prompted to create one in this wizard.Next
. The wizard monitors and displays the progress of your registration.Next
. Then click Finish
to close the Wizard.To use the Borland product registration wizard for Email registration:
Next
.Next
. If you do not have an account you are prompted to create one in this wizard.Next
.Next
. Finish
. You will receive a product activation file by email.<install_dir>/license
directory,and it will be applied automatically when you start your product.To use the Borland product registration wizard for Web page registration:
Next
. Finish
to close the Wizard.Login
. If you do not have an account, click the Create account
link (http://reg.borland.com/srs5/new_user.jsp).Continue
.<install_dir>/license
directory,and it will be applied automatically when you start your product.To use the Borland product registration wizard for Telephone registration:
Next
.Next
, then click Finish
to close the Wizard.<install_dir>/license
directory, and it will be applied automatically when you start your product.To uninstall VisiBroker:
osagent
) running during the uninstall.<install_root>/UninstallerData
directory.java -cp uninstaller.jar uninstall
uninstall
command, check the installation directory and remove any unnecessary files and subdirectories.