How to run multiple instances of BES 6.x (Visibroker Edition) from a single installation (footprint)?

Problem:

• Product Name: VisiBroker
• Product Version: 6.0 and later
• Product Component: runtime
• Platform/OS Version: Solaris/Windows

How to run multiple instances of BES 6.x (Visibroker Edition) from a single installation (footprint)?

Resolution:

Overview

You can start multiple instances of BES 6.x (Visibroker Edition) from a single installation (footprint) so as to allow you to manage future upgrades more easily.

However, this is only possible if you have enough Network Concurrent licenses for the instances you are going to start.

Details

As this is a Networked license, you will need to set up Borland License Server (Belise) as per instructions in license certificate e-mail. (Remember to grant all users access to the concurrent_????.slip file you have placed into the BES license directory. e.g. /BES65/license)

Note: refer to article Where do we have to copy the floating license to? for more information on where to place the network license files.

Specific to Unix:

1. Create a "var" directory for each user starting an instance (e.g. /home/user1/BES65/var) and copy license.ini from /BES65/var to the new directory.
2. Make the following change to vbj.config file found in the bin directory of the installation (e.g. /BES65/bin/vbj.config):
   • vmprop borland.enterrpise.licenseDir=$env(BES_LIC_DIR)
3. Modify your start script to set BES_LIC_DIR to the directory created in step 1:
   • For Borne or Korn shell (vbroker.sh), change:
     • BES_LIC_DIR=/home/user1/BES65/var
   • For C shell (vbroker.csh), change:
     • setenv BES_LIC_DIR=/home/user1/BES65/var

By default, the Visibroker will check out a license and store it to $VBROKER/var. Modifying BES_LIC_DIR as above will cause the checked out license to be stored into /home/user1/BES/var instead.

To check that the set up is correct, start the Visibroker as follows:

$ vbj -VBJdebug Server

Lookout for the following from among the output:

 option[ x] = '-Dborland.enterprise.licenseDir=/home/user1/BES6.5/var'

 option[ x] = '-Dborland.enterprise.licenseDefaultDir=/BES65/license'

the "-VBJdebug" option allows you to show the Visibroker environment for troubleshooting purposes.