Planning your Installation

This guide describes installation and installation-related tasks for installing VisiBroker on Windows and on supported UNIX platforms.

Some recommendations:

•	Typically, you install VisiBroker on a large, shared UNIX or Windows machine.

•	Installing the examples is optional, however Micro Focus recommends you do install them.

Package contents

If you have received a physical installation package, it contains the VisiBroker DVD. Your package may include additional products that ship with VisiBroker.

You may alternatively have downloaded the installation.

Note

You can also obtain a trial version of the VisiBroker software from the Micro Focus web site:
https://www.microfocus.com/en-us/products/visibroker/overview.

System requirements

For the latest information on platforms supported by VisiBroker and for JDK requirements, refer to the Micro Focus web site:

https://supportline.microfocus.com/prodavail.aspx

In addition to platform-specific requirements, 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

For information on the JDK versions that are supported for running VisiBroker, see https://supportline.microfocus.com/prodavail.aspx

•	A JDK is no longer redistributed with VisiBroker.

•	A JRE is not sufficient for installing VisiBroker.

If your VisiBroker installation binary is 64-bit, then your JDK must be 64-bit as well.

Note

If you choose a 32-bit version of VisiBroker 8.5.n, then you would normally need a 32-bit JDK. If however you wish to use a 32-bit VisiBroker installer (because for example you need to compile and run 32-bit C++ CORBA applications) but you wish to use a 64-bit JDK then you can do so.

Run the 32-bit installer but select your 64-bit JDK during the installation process. After installation has completed you will need to patch your installation with a VisiBroker 64-bit Service Overlay.

This overlay is provided as a .zip or .tar file that is unpacked over the installation. Contact Micro Focus SupportLine (https://supportline.microfocus.com/) for further information.

Note that you can run java -version to make sure that you have installed the intended version of JDK (that is, 32 or 64-bit).

Licensing

All VisiBroker licenses are locked to the system on which they are applied and activated. You cannot copy these licenses to another system, and they cannot be accessed from a VisiBroker product running on another system. If you reinstall the software on the same system, you will need to reactivate the license.

VisiBroker node-locked licenses must be registered and activated before using the product. To apply the licenses you will need the following:

•	The Serial Number and Key, or the activation file for each license. These will arrive in an email from Micro Focus.

•	A username and password

This is needed for product registration. Note that the main bdn.borland.com address is no longer in use. However:

•	If you have an existing Borland Developer Network account, you can use the credentials for that account.

•	If you have a Borland Developer Network login, but have forgotten your password, go to https://my.embarcadero.com/ and select the Reset my password link.

•	If you do not have an account, for example because you are a new VisiBroker user, you can create one at https://visireg.microfocus.com/srs5/new_user.jsp.

•	You can alternatively create an account using the VisiBroker Product Registration Wizard, during the registration/activation process described in Product Registration.

Make sure that you record the user name and password that you create.

•

Internet access. This is required if you want to use the Direct or Web page methods for activating your license. For web activation, your internet access can be from any system, but for direct activation you need internet access from the system on which your product is installed. If you choose the Web option, you must be able to access https://visireg.microfocus.com/srs5/new_user.jsp and be able to receive emails to the address that you specified when creating the BDN account.

If you are applying a license to a remote system, you must have Telnet access to that system and some way to copy (that is, FTP) the activation file to that system.

Replacing an earlier version of VisiBroker

You cannot install this version of VisiBroker in the same location as a previous version. Either:

•	Uninstall the previous version, or

•	Install the new version in a different location from any other existing versions

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. See “Cleaning up and re-registering a license” for information on how to remove your evaluation license, then add and activate your new, permanent license. For information on activating your new license, see “Product Registration”.

Installing the Service Pack

If you install VisiBroker as a new customer, you do not need to install this Service Pack separately; it is included in your installation package.

Existing users of VisiBroker 8.5 who wish to upgrade to this Service Pack should follow the instructions in its accompanying Release Notes to install the Service Pack on top of their existing installation.

What's next?

Once you have planned your network installations, you are ready to install VisiBroker.

The installation sections give platform-specific details.