Installing VisiBroker in console mode

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

This section describes how to run the installer in text-only mode.

Installing VisiBroker

Ensure that you have the prerequisites described in “System requirements”.

Start the VisiBroker installer

You can either download the VisiBroker installer from the web or install from a mounted DVD. The command that starts the installer depends on which UNIX platform you are installing on.

1	Log in as a non-root user. Make sure that the user name you select has read/write access to the folder where you intend to install VisiBroker.

2	Either mount the installation DVD or download the product from the Micro Focus web site at http://www.microfocus.com/products/corba/visibroker/index.aspx.

3	From the directory that contains the VisiBroker installer executable file, enter the appropriate command.

Start the installer in console mode on Solaris

Using an installation DVD:

install_solaris -i console

Using a downloaded installer:

<install_file>.bin -i console

where <install_file> is the name of the downloaded file.

Start the installer in console mode on Linux

Using an installation DVD:

install_Linux -i console

Using a downloaded installer:

vb85-<release number>-linux-<platform>-<arch>.bin -i console

where <platform> is either rh5 or suse10

and <arch> is either x86 or x86_64.

Start the installer in console mode on IBM AIX

Using an installation DVD:

install_aix -i console

Using a downloaded installer:

vb85-<release number>-aix-<arch>.bin -i console

where <arch> is one of ppc32 or ppc64

Start the installer in console mode on HP-UX

Using an installation DVD:

install_hp -i console

Using a downloaded installer:

vb85-<release number>-hp-<arch>.bin -i console

where <arch> is either ia32 or ia64.

Using the installer

Note

The installer writes to stdout and reads from stdin. This allows you to telnet from one system to another and run the installer remotely.

Follow the installer's onscreen instructions. For most options, defaults offered by the installer are acceptable.

1	License agreement: Read the licensing agreement carefully and enter Y to accept it in order to install and use VisiBroker.

2

Choose Install Folder: This creates a new installation of VisiBroker, or adds components to an existing installation. Either enter Y to accept the default /opt/MicroFocus/VisiBroker, or enter another location and enter Y to confirm. Ensure that the user name you are using has write access to the chosen folder.

Note that you cannot install this version of VisiBroker on top of previous releases; but you can specify an existing location in order to add components.

3	Choose Product Components: Depending on the VisiBroker product you are installing, you can select from the following product components. The options are:

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

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

Documentation: The suite of online documentation.

Examples: Example applications for VisiBroker.

VisiBroker Services: Optional components that you can purchase for extended VisiBroker functionality. You can select the specific services you have purchased later in the installation procedure.

By default, the components are all selected. You can choose to de-select any components which you do not need. For example, you could de-select the Examples option. Do this by entering a comma-separated list of the numbers for the features that you want to de-select. For example, enter 3,4 to de-select the documentation and the examples.

4	Choose VisiBroker Services: Select the services you have purchased. For example, enter 1,2 to select VisiNotify and VisiSecure:

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

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

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

5	Choose Installation Type: Choose:

1 - Typical: an express install using default settings, including:

Smart Agent port: Also known as the osagent. Client-side ORBs use this port to locate server objects before invoking their services. The default is 14000.

2 - Custom to customize your installation. If you select this, you can:

Set the Smart Agent port (osagent) to a value other than its default.

Enter 1 or 2 as required.

6	Configuration Settings: If you selected a Custom installation, specify the osagent port you require.

7	Java Development Kit: Specify the path of the JDK to be used for this installation (see “JDK”).

8	Pre-Installation Summary: Review the displayed information before proceeding with the installation. Verify in particular the install folder location and the product features that you have specified. To confirm your choices and start installing, press Enter.

9	Registration and Activation: You must register and activate your license before you can start to use VisiBroker. Enter Y to register now, or N to do so at a later date. You are recommended to register now.

(For registering later, see “Registering the license in console mode after installation”, or see “Product Registration”.)

10	License Administration Tool: A list of registration options appears.

11	If the machine on which you are installing has direct internet access, enter 0 for direct registration.

If the machine does not have direct internet access, enter 1 for web registration. Note down the registration key displayed in the console.

12	The installer connects to the licensing server and prompts you to enter your serial number. Enter your 20-character license serial number.

13	Next the installer prompts Enter the key:. Enter your 6-character license authorization key.

14	The installer prompts:

Do you have a Borland Developer Network (BDN) account from a previous Borland product registration (Y)/(N)?

Type Y.

15	The installer prompts you for your Developer Network login name or your email address. Enter your developer network user name (see “A Borland Developer Network (BDN) account”) and password.

16	The screen displays "Registering your information....", followed by "Registration completed successfully".

17	It then displays the license registration options previously seen in step 10. Choose option 7 to save the license.

18	Choose option 2 to list the licenses to make sure the installation is registered correctly and then choose option 8 to quit the installer.

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 temporary directories and files after installation.

Registering the license in console mode after installation

If you select N when prompted to register your VisiBroker license during installation, you can register and activate the license in console mode later. To do so:

1	Open a UNIX console and log in using the same non-root user name that installed VisiBroker.

2	Go to the <install_dir>/bin folder.

3	Set up the VisiBroker environment by running . ./vbroker.sh.

4	Run lmadm -i console. A list of registration options appears.

5	If the machine has direct internet access, go to step 6.

If the machine does not have direct internet access, please proceed to step 13.

6	Enter 0 to select direct registration.

7	The utility connects to the license server and prompts you to enter your serial number. Enter your 20=character license serial number.

8	Next the installer prompts Enter the key:. Enter your 6-character license authorization key.

9	The installer prompts:

Do you have a Borland Developer Network (BDN) account from a previous Borland product registration (Y)/(N)?

Type Y.

10	The installer prompts you for your Developer Network login name or your email address. Enter your developer network user name (see “A Borland Developer Network (BDN) account”) and password.

11	The screen displays "Registering your information....", followed by "Registration completed successfully".

12	It then displays the license registration options previously seen in step 4. Choose option 7 to save the license.

13	If the machine do not have direct internet access, then choose option 1 and note down the registration key displayed in the console.

14	You can then register the license as described in “Email registration”, “Web page registration”, or “Telephone registration” in the “Product Registration” section.