Installing OTMQ Using GUI-Mode Installation

The following sections describe how to install Oracle Tuxedo Message Queue (OTMQ) using graphical user interface (GUI) mode installation on both Windows and UNIX systems:

•	What Is GUI-Mode Installation?

•	Starting GUI-Mode Installation on a Windows System

•	Starting GUI-Mode Installation on a UNIX System

•	Running GUI-Mode Installation

•	What Do I Do Next?

What Is GUI-Mode Installation?

The graphical user interface mode installation is the graphics-based method of executing the Oracle Installation program. It can be run on UNIX system.

To run GUI-mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI. Not all consoles for UNIX support Java-based GUIs.

Note:

To install Oracle Tuxedo Message Queue on a UNIX system with a non-graphics console, see“Installing OTMQ on UNIX Systems Using Console-Mode Installation” on page 3‑1.

Starting GUI-Mode Installation on a Windows System

To start the GUI-mode installation process on a Windows system, follow these steps:

1.	Select a Windows system that meets the hardware and software requirements described in "Oracle Tuxedo Message Queue 12c (12.1.1) Platform Data Sheets".

2.	Log in to the Windows system as the Administrator or as a member of the Administrator group.

You need administrative privileges to install Oracle Tuxedo Message Queue server components on a Windows system.

3.	Ensure that you have enough free space for the Oracle Tuxedo installation.

For disk space requirements, see "Oracle Tuxedo Message Queue 12c (12.1.1) Platform Data Sheets". For important disk space allocation information, see "File and Database Management and Disk Space Allocation" on <Oracle Tuxedo installation Guide>.

4.	Install Oracle Tuxedo Message Queue by downloading from the Oracle Web site:

a.	.Download the Oracle Tuxedo Message Queue 12c (12.1.1) installation file specific to your platform (Message Queue is an Oracle Tuxedo add-on product).

b.	Go to the directory where you downloaded the Oracle Tuxedo Message Queue installer and double-click the installer filename to start the installation.

5.	Proceed to Running GUI-Mode Installation.

6.	Re-login to the system after Oracle Tuxedo Message Queue 12c (12.1.1) installation has completed.

Starting GUI-Mode Installation on a UNIX System

To start the GUI-mode installation process on a UNIX system, follow these steps:

1.	Select a UNIX system that meets the hardware and software requirements described in OTMQ 12c Release 1 (12.1.1) Platform Data Sheets

2.	Log in to the UNIX system as the Oracle Tuxedo Message Queue administrator.

3.	Ensure that you have enough free space for the Oracle Tuxedo Message Queue installation.

For disk space requirements, see OTMQ 12c Release 1 (12.1.1) Platform Data Sheets. For important disk space allocation information, see File and Database Management and Disk Space Allocation

4.	Install Oracle Tuxedo Message Queue by downloading from the Oracle FTP site:

a.	Download the Oracle Tuxedo Message Queue 12c (12.1.1) installation file specific to your platform (Message Queue is an Oracle Tuxedo add-on product).

b.	Go to the directory where you downloaded the installer and invoke the installation procedure by entering the following command:

prompt> sh filename.bin

where filename is the name of the Oracle Tuxedo Message Queue installer file.

Note:

GUI mode is the default for Oracle Tuxedo Message Queue 12c (12.1.1) installation. If a GUI interface is not available on your Unix platform, you will receive an error message and the installation process is aborted.

If a GUI interface is not available on your Unix platform, you must use silent or console-mode installation. For more information, see What Is Silent Installation? and What Is Console-Mode Installation?

5.	Proceed to “Running GUI-Mode Installation” on page 2‑3.

Running GUI-Mode Installation

The Oracle Tuxedo Message Queue installer program is currently available in English. By checking the value of a certain language-related environment variable on the target platform, the installer program automatically determines (1) the language displayed during the installation and (2) the language-specific message catalog installed during the installation. If the language-related environment variable is not set or is set to a value unknown to the installer program, both the language displayed and the message catalog installed default to English.

The Oracle Tuxedo Message Queue installer program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see Table 2‑1.

 

Table 2‑1 Instructions

In This Window . . .	Perform the Following Action . . .
Introduction	Click Next to proceed with the installation. You may cancel the installation at any time by clicking Cancel.
Choose Install Set	Select the install set that you want installed on your system. The following seven choices are available: • Install on top of existing Tuxedo installation-This Install Set will install all of the OTMQ Server and Client files. • Standalone installation-This Install Set will install all of the OTMQ Server, Client files and minimal Oracle Tuxedo files. For a detailed list of software components for each install set, see “Install Sets” on page 1‑3. Select an install set and then click Next to launch the Choose Oracle Home Directory window. Note: On Windows, if there is an existing Oracle Tuxedo 12c (12.1.1) installation, the standalone installation is not allowed.
Choose Oracle Home Directory	Specify the Oracle Home directory that will serve as the central support directory for all Oracle products installed on the target system. If you already have an Oracle Home directory on your system, you can select that directory (recommended). Note: You can only create a new Oracle Home directory in Standalon Installation. The Oracle Tuxedo Message Queue installer program automatically creates the directory for you. For details about the Oracle Home directory, see “Oracle Home Directory” on page 1‑4. Choose an Oracle Home directory and then click Next to continue with the installation.
Choose Product Directory	Specify the directory in which you want to install the Oracle Tuxedo Message Queue software. You may select the default product directory (tuxedo12c UNIX) or create a new product directory. If you choose to create a new directory, the Oracle Tuxedo Message Queue installer automatically creates the directory for you. WARNING: Running a previous Oracle Tuxedo version in conjunction with Oracle Tuxedo Message Queue 12c (12.1.1) on a Windows system requires that the product directories for both versions do not have the same name. If you select Add-onIinstallation, OTMQ must be installed on an existing Oracle Tuxedo directory.
Install Samples	Click the check box to install samples. Click Next to proceed with the installation.
Pre-Installation Summary	Review your installation selections. Clicking Previous allows you to modify installation selections. Otherwise click Install to continue.
Installing . . .	No user input is required here. The installation program is installing Oracle Tuxedo Message Queue in the user-specified product directory. Note: It is normal for the installation progress bar to stop for several minutes, especially at the end. The Oracle Tuxedo Message Queue installer is still working when this occurs.
Configure tlisten Service (Standalone Installation only.)	This window appears only if you have installed the Server Install set. Set the tlisten port value. Enter a tlisten password of your choice. Your password must be a string of alphanumeric characters in clear-text format that is no more than 80 characters in length. You use this password to log in to the Oracle Tuxedo Message Queue Administration Console. Note: Machines on the same domain must have the same tlisten password defined. Oracle Tuxedo Message Queue uses the tlisten password to protect the local machine from administrative requests and operations that are not authorized. Whenever administrative communications arrive on the local machine through tlisten(1) or wlisten(1) gateway processes, Oracle Tuxedo Message Queue authenticates them by means of the tlisten password. Enter and re-enter a tlisten password and then click Next to continue.
Tlisten Encryption Method (Standalone Windows Installation only.)	Specify the tlisten encryption method: LLE or SSL. The default is LLE.
SSL Parameter Input (Standalone Windows Installation only.)	If the SSL encryption method is chosen, you must enter Security Principal name, location, and password.
Choose Encryption Bit (Standalone Windows Installation only.)	Specify tlisten minimum and maximum encryption bit. The default minimum value is 0. The default maximum value is 256.
SSL Installation Choice (Standalone Installation only.)	This window appears only if you have installed Server, ATMI and/or CORBA Client install set components. Oracle Tuxedo Message Queue provides a Lightweight Directory Access Protocol (LDAP) based certificate retrieval mechanism that supports certificate-based authentication when using SSL. The Oracle Tuxedo Message Queue certificate retrieval mechanism has been certified for use with the LDAP Directory server included with iPlanet Directory Server. Choose whether or not you want to install SSL support. If you intend to use SSL encryption in your application, select Yes and then click Next to launch the LDAP Configuration window. If you do not intend to use SSL encryption in your application, select No.
LDAP Configuration for SSL Support (Standalone Installation only.)	Enter the following LDAP configuration information and then click Next to continue: • LDAP Service Name: Fully qualified domain name of the LDAP server (for example, pcwiz.mydomain.com) • LDAP PortID: Port number through which the local machine communicates with the LDAP server (for example, 389) • LDAP BaseObject: Distinguished name of the base object for search in the LDAP server (for example, o=beasys.com) • LDAP Filter File Location: (tux_ prod_dir/udataobj/security/ bea_ldap_filter.dat by default, where tux_prod_dir represents the product directory in which you installed the Oracle Tuxedo Message Queue software)
Install Complete	Click Done to exit the installation program.

Congratulations! Your installation of the Oracle Tuxedo Message Queue software is complete!.

What Do I Do Next?

After the successful installation, you can run samples to verify if the software is installed correctly, or uninstall the software. For more information, see Post-Installation.