2
Installing

This chapter describes installing Oracle Message Broker using the Oracle Universal Installer. Some Oracle Message Broker installations use Oracle Internet Directory to store configuration information; these installations need Oracle Internet Directory installed either locally, or on a remote system. If you install both Oracle Message Broker and Oracle Internet Directory on the same system, the order of installation is not important. See Chapter 3 for information on installing Oracle Internet Directory.

Contents

• Pre-Installation Tasks

• Installation Restrictions

• Migrating Directory Data between Releases

• Running the Universal Installer

• Interactive Installation Process

• Deinstallation Procedure

Pre-Installation Tasks

You need to perform the following tasks before you install Oracle Message Broker:

1. If an Oracle Message Broker running on one system uses an Oracle8i on another system, the NLS_LANG environment variable should be set to the same value on each machine, or to compatible values.

2. If you are running the Installer on a system where Oracle Internet Directory is installed and running, then the Oracle Internet Directory processes and the Oracle 8i Database Server need to be shutdown before installing Oracle Message Broker. Refer to the section "Oracle Advanced Queuing Configuration (Optional)" for information on shutting down these components.

Installation Restrictions

1. NLS_LANG Limitation. If an Oracle Message Broker running on a system uses the Oracle8i Database Server on a different system to support Oracle AQ, the NLS_LANG environment variable should have the same value on both systems. In the case where the values of NLS_LANG are different on the different systems, they should be set to compatible values.

2. Selecting the value of the Oracle Home environment variable. If you are installing for JDK 1.2, and you are installing into an ORACLE_HOME that had a previous release of the Oracle Message Broker installed that used JDK 1.1.8, the installer does not deinstall the pre-existing JDK 1.1.8 release of the ORB. The workaround for this problem is to install Oracle Message Broker in a different $ORACLE_HOME.

3. When catalog.sh needs to be run using Oracle Internet Directory on Windows NT, the MKS or cygwin tools, or similar tools providing a Unix-like shell need to be available on the Windows NT system. The OID command catalog.sh should only need to be run when LDAPSchema requests that you run this command (see "Directory Configuration").

Migrating Directory Data between Releases

Migrating to Release 2.0.1.0

If you are installing Oracle Message Broker and you are migrating from Release 2.0.0.0 to Release 2.0.1.0, running the command InitDir with the same options used when installing Release 2.0.0.0 updates the LDAP schema, as required for Release 2.0.1.0. See "Directory Configuration" for more information on InitDir.

Migrating Between Releases 1.0 to 2.0

If you are installing Oracle Message Broker and you need to migrate existing LDAP Directory entries created for an older version of Oracle Message Broker, you can use the Migrate10To20 utility. Refer to the Oracle Message Broker Administration Guide for information on using Migrate10To20.

Running the Universal Installer

To start the Oracle Message Broker installation, run the Oracle Universal Installer:

1. Log on to your Windows NT system as a member of the Administrator's group.

2. Use Windows NT Explorer to navigate to your CD-ROM drive.

3. Navigate to the win32 directory on the CD-ROM drive under the directory Oracle_MsgBroker.

4. Double click on setup.exe.

Interactive Installation Process

The Oracle Universal Installer guides you through the installation process. Each screen is clearly labeled. Therefore, this section describes the screens only briefly.

To navigate through the installer, select Next to move to the next screen. Select Previous to go back to a previous screen. Select Help to get additional information about each specific screen.

This section covers the following aspects of the installation process:

• Initial Screens

• Custom Installation

• Complete Installation

Initial Screens

The initial screens provide information to the Oracle Universal Installer about the Oracle products you plan to install, the location where you are installing products, and about your system.

Note: If you have previously run the Oracle Universal Installer for this product, or for another Oracle product, some of the initial screens may not appear. After the Oracle Universal Installer runs, it saves certain information about the system. The Oracle Universal Installer uses this information for new product installations.

Welcome Screen

From this screen you can view currently installed products, and you can choose to deinstall installed products. Click Next, and continue with the installation.

File Locations

The fields in this screen are already filled in with default values by the Installer.

Under Destination, the Name field identifies the program group associated with a particular Oracle home.

The Path field specifies where the Oracle Message Broker is to be installed. Use the default value, or change the path to the location where you want to put the Oracle Message Broker.

Click Next.

Available Products

The fields in this screen allow you to select from the available products.

Select one of the two possible Oracle Message Broker product versions, Oracle Message Broker for JDK Release 1.2, or Oracle Message Broker for JDK Release 1.1.8.

Click Next.

Installation Types

In this screen you choose the type of the installation you want for Oracle Message Broker. The choices are:

• Complete (default)

  This installs Oracle Message Broker and all required components to run the Message Broker.

• Custom

  This option allows you to custom select components when installing the Oracle Message Broker. After completing the Custom Installation options, you must continue to navigate through the Complete Installation screens to successfully finish the Oracle Message Broker installation.

Select the installation type and click Next.

The screens for each of these installation types are described in the Custom Installation and Complete Installation sections.

Custom Installation

Available Product Components

This screen shows the set of components that you can select as part of the Oracle Message Broker installation, and the Install Status of each (New Install or Not Installed). Component options include:

Samples	Select this option to include installation of the Oracle Message Broker samples.
Documentation	Select this option to include installation of documentation for the Oracle Message Broker.
Installer	Installs or upgrades the Oracle Universal Installer, used to install Oracle products.

Component Locations

This screen shows the components that you can install, and provides selection of alternate locations for installing each component. For example:

Oracle Universal Installer

Select this component to view its current destination location. Click the Change Location button to access the Choose Directory dialog box and select a new location from the directory tree there.

After entering the options for the custom installation, click Next to continue navigating through the Complete Installation screens to finish the Oracle Message Broker installation.

Complete Installation

Suffix Information

This screen shows fields for the Lightweight Directory Access Protocol (LDAP) base naming context and suffix information that the Oracle Message Broker uses for directory entries. The following table describes the Suffix Information fields.

Field	Description
Directory Suffix	The full directory suffix. If you supply a directory suffix, make sure that it includes all the information for the LDAP Directory that the Oracle Message Broker is using. The directory suffix is appended as part of the initial context that the Oracle Message Broker uses when connecting to the LDAP Directory. This field is optional.
Country Code	The country code used in the directory base naming context. The value supplied for the country code is used in the initial context, with a "c=" added. This field is optional.
Organization	The organization used in the directory base naming context. The value supplied for the organization is used in the initial context, with a "o=" added. This field is optional.
Organizational Unit Name	The organizational unit used in the directory base naming context. The value supplied for the organizational unit is used in the initial context, with a "ou=" added.This field is optional.

Enter your choices for Suffix information and click Next.

The values you supply in this dialog depend on the directory installation and its DIT organization. Oracle Message Broker administrative components should be created below the initial context specified in the Suffix Information dialog.

For example, using a directory that was installed with an initial context of "o=us.oracle.com", you could supply the following values on the Suffix Information dialog:

Directory Suffix:  o=us.oracle.com
Country Code:
Organization:
Organizational Unit: sales

These values would create Oracle Message Broker scripts with the following initial context:

ou=sales,o=us.oracle.com

The following example uses a directory that is installed with the initial context, "ou=sales,o=oracle,c=us". For this initial context, you could supply the following values in the Suffix Information Dialog:

Directory Suffix:
Country Code: us
Organization: oracle
Organizational Unit: sales

These values would create Oracle Message Broker scripts with the following initial context:

ou=sales,o=oracle,c=us

Note: The values that you enter in the Directory Suffix information dialog depend on the organization of the LDAP Directory. The organization of the LDAP Directory is determined when it is installed.

LDAP Information

This screen shows the LDAP port and LDAP server that you want to select for the directory server. For example,

LDAP Port	389
LDAP Server	system1

Enter the choices for your LDAP server and click Next. The LDAP server does not have to be running, or reside on the system where you are installing Oracle Message Broker.

Summary

This screen shows the choices you have made, the space requirements, the products that are already installed on the system, and the products that will be installed if you press the Install button.

If you want to change any of the global settings, use the Previous button to go back and make changes, then use the Next button to return to this screen.

If you want to see what other Oracle products are installed in your Oracle Home, press the Installed Products button. If some of the components that this installation will install are already on your system, the Oracle Universal Installer will detect them and will not install replacements.

When you are satisfied with the choices you have made, press the Install button to start the installation process.

Configuration Tools

Verify the list of configuration tools and click Next.

Note: Depending on the system inventory, the Installer does not present this screen if the system has an existing Oracle 8i Database Server installed, or if other Oracle products are installed on the system.

The Configuration Tools screen lists the configuration tools for all installed components.

Scroll down the list to review configuration status of each tool. The status changes as each component is configured.

The installer performs the following functions in this screen:

• Executes a configuration tool for each component selected previously in the Available Product Component screen.

• Displays all the configuration settings in the display window below as it executes a configuration tool for each component.

• Enables you to view configuration settings after all configuration tools are executed. Click on each component to review all the changes made.

• Allows you to view data for failed executions in the display window. You can either fix the error and click Retry to execute the configuration tool again, or ignore the error and click Next to proceed to the next screen.

• Retry: To re-execute the configuration script if the configuration of a component fails.

• Stop: To quit the configuration process.

Net8 Configuration Tool

Note: Depending on the system inventory, the Installer does not present this screen if the system has an existing Oracle 8i Database Server installed, or if other Oracle products are installed on the system.

The installer automatically launches the Net8 Configuration Assistant. After configuration, return to the installer.The Net8 Configuration Assistant is a graphical user interface (GUI) tool that enables you to configure your Oracle client/server network environment.

Net8 Configuration Assistant is either:

• automatically started from within the installer for all installation types

• manually started as a stand-alone tool

The Net8 Configuration Assistant will automatically create a profile that is consistent with any selections made during installation. The installer will automatically run the Net8 Configuration Assistant to set up a net service in the Local Naming file.

Follow directions on the Net8 Configuration Assistant to configure Net8.

Configuring a complete Oracle network is beyond the scope of this manual and is covered in detail in the Net8 Administrator's Guide.

End of Installation

This screen shows a button to view the release information, and buttons to continue installing, or to exit.

Click Exit if you are done with the installation or Next Install if you want to install additional Oracle products.

Deinstallation Procedure

Before deinstalling Oracle Message Broker, be sure that there are no active Oracle Message Broker processes. If there are active Oracle Message Broker processes, stop them using the MsgBroker command.

Start the Oracle Universal Installer as described in "Running the Universal Installer".

Welcome Screen

From this screen you can view currently installed products, and you can choose to deinstall installed products. Click the Deinstall Products button on the Welcome screen. The Inventory window appears, listing all installed products.

In the Inventory window, select the Oracle Message Broker then click the Remove Button.