Installing Oracle Tuxedo Message Queue Using GUI-Mode Installation

The following sections describe how to install Oracle Tuxedo Message Queue 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 both Windows and 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. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX systems do.

Note:

To install Oracle Tuxedo Message Queue on a UNIX system with a non-graphics console, use silent install mode.

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 Release 2 (12.1.3) 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 for standalone installation mode on a Windows system; however, if you are going to install on top of existing Oracle Tuxedo Installation, you do not need administrative privileges.

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

For disk space requirements, see “Oracle Tuxedo Message Queue 12c Release 2 (12.1.3) Platform Data Sheets”.

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

a.	Go to http://www.oracle.com/technology/software/index.html and download the Oracle Tuxedo Message Queue 12c Release 2 (12.1.3) installation file specific to your platform.

b.	Go to the directory where you downloaded the Oracle Tuxedo Message Queue installer, unzip the installer file, and then go to the Disk1\install directory, run the setup.exe to start the installation.

5.	Proceed to “Running GUI-Mode Installation”.

6.	Re-login to the system after Oracle Tuxedo Message Queue 12c Release 2 (12.1.3) 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 “Oracle Tuxedo Message Queue 12c Release 2 (12.1.3) 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 “Oracle Tuxedo Message Queue 12c Release 2 (12.1.3) Platform Data Sheets”.

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

a.	Go to http://www.oracle.com/technology/software/index.html and download the Oracle Tuxedo Message Queue 12c Release 2 (12.1.3) installation file specific to your platform.

b.	Go to the directory where you downloaded the installer, unzip the installer file, and then go to the Disk1\install directory, run the runInstaller to invoke the installation procedure.

Note:

GUI mode is the default for Oracle Tuxedo Message Queue 12c Release 2 (12.1.3) 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 mode installation. For more information, see What Is Silent Installation?

5.	Proceed to “Running GUI-Mode Installation”.

Running GUI-Mode Installation

The Oracle Tuxedo Message Queue installer program is currently available in English and Japanese. 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 . . .
Welcome	Click Next to proceed with the installation. You may cancel the installation at any time by clicking Cancel.
Specify inventory directory (Unix only)	On UNIX operating systems, this screen appears if this is the first time you are installing any Oracle product on this host. Specify the location where you want to create your central inventory. Make sure that the operating system group name selected on this screen has write permissions to the central inventory location. This screen does not appear on Windows operating systems.
Choose install type	Select the install type that you want installed on your system. The following choices are available: • Install on top of existing Oracle Tuxedo Installation (the default) - only Oracle Tuxedo Message Queue files. • Standalone installation - all Oracle Tuxedo Message Queue files, and minimal Tuxedo files. For a detailed list of software components for each install type, see “Install Types”. Select an install type and then click Next to launch the Choose Oracle Home Directory window-your selection includes the appropriate encryption software for Link-Level Encryption (LLE) and/or Secure Sockets Layer (SSL).
Specify Oracle Home	Name: Enter a name for the Oracle home. This name identifies the program group associated with a particular home and the Oracle services installed on this home. The Oracle home name must be between 1 to 127 characters long, and can include only alphanumeric characters and underscores. Enter the full path to an Oracle home, or select an Oracle home from the drop-down list of existing Oracle homes. The Oracle home location is the directory where products are installed. Data files may or may not be installed within an Oracle home. You can use the Browse button to choose a directory to install your product. For Windows platforms, you must provide a valid path that is not in the Windows directory. Different homes cannot share the same location. It is recommended that you designate an Oracle home location that is an empty or non-existing directory. If you select a directory for the Oracle home location that is not empty or already exists, you will be warned and asked if you want to proceed. For silent installations, if a non-empty, existing directory is specified, an error is logged in the console and in the installActions<timestamp>.log file. Also, the OUI aborts. To override this condition, use the -force flag on the command line. The effect of using the -force flag is the same as selecting Yes while installing in interactive mode. You receive a warning message, but the installation continues. If you install on top of existing Oracle Tuxedo installation, Oracle Tuxedo Message Queue product will be installed on Tuxedo Product Installation Directory. If you choose standalone installation, Oracle Tuxedo Message Queue Product Installation Directory is "$ORACLE_HOME/otmq12.1.3.0.0" by default (UNIX) and cannot be changed after the ORACLE_HOME is determined. Oracle Tuxedo Message Queue installer does not allow to install two same version Oracle Tuxedo Message Queue products into the same ORACLE_HOME. If the selected ORACLE_HOME already installed the same version Oracle Tuxedo Message Queue, the installer will show a warning.
Check prerequisite (install on top of existing Oracle Tuxedo installation only)	If the certain Tuxedo component (published in Tuxedo12.1.3.0.0) is not installed on the target ORACLE_HOME, you cannot continue the installation until you specify a proper ORACLE_HOME. If the certain Tuxedo Server component (published in Tuxedo12.1.3.0.0) is not installed on the target ORACLE_HOME, you cannot continue the installation until you specify a proper ORACLE_HOME. Oracle Tuxedo 12c Release 2 (12.1.3) Rolling Patch 004 or above is required on UNIX platforms; if this requirement is not met, you will get an error message. For windows platforms, if the registry table for Tuxedo12.1.3.0.0 is missing, you will get an error message.
Check prerequisite (standalone installation only)	If the certain Tuxedo component (published in Tuxedo12.1.3.0.0) is installed on the target ORACLE_HOME, you cannot continue the installation until you specify a proper ORACLE_HOME. For windows platforms, if Oracle Tuxedo with this version is already installed on this machine, you will get an error message.
Select samples installation	This screen appears to confirm install the samples.
Configure tlisten choice (standalone installation only)	tlisten is needed for MP/clustered mode configuration and Oracle TSAM Plus. If you need to configure tlisten, select "Yes", and then input the parameters for tlisten configuration on the screens that follow. This window appears only if you have installed the Server Install.
Configure tlisten password (standalone installation only)	This window appears only if you select to configure tlisten. 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 Administration Console. Note: Machines on the same domain must have the same tlisten password defined. Oracle Tuxedo uses the tlisten password to protect the local machine from administrative requests and operations that are not authorized. Whenever administrative communication is received on the local machine through tlisten(1) or wlisten(1) gateway processes, Oracle Tuxedo authenticates using the tlisten password. Enter and re-enter a tlisten password and then click Next to continue.
Configure tlisten port (Windows platforms only)	Set the tlisten port value. Note: For Windows platforms, the default value is 3050. There is no default value for UNIX platforms
tlisten encryption method (Windows platforms only)	Specify the tlisten encryption method: LLE or SSL. The default is LLE.
Choose encryption min bit (Windows platforms only)	Specify tlisten minimum encryption bit. • SSL: 112, 128, 256 can be selected. The default minimum value is 112. • LLE: 0, 56, 128, 256 can be selected. The default minimum value is 0.
Choose encryption max bit (Windows platforms only)	Specify tlisten maximum encryption bit. • SSL: 112, 128, 256 can be selected. The default maximum value is 256. • LLE: 0, 56, 128, 256 can be selected. The default maximum value is 256.
SSL parameter input (standalone installation only)	If the SSL encryption method is chosen, you must enter Security Principal name, location, and password.
SSL installation choice (standalone installation only)	Oracle Tuxedo provides a Lightweight Directory Access Protocol (LDAP) based certificate retrieval mechanism that supports certificate-based authentication when using SSL. The Oracle Tuxedo 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; otherwise, 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 search base object in the LDAP server (for example, o=beasys.com)
LDAP filter file choice (standalone installation only)	LDAP filter file location is tux_prod_dir/udataobj/security/bea_ldap_filter.dat by default. tux_prod_dir represents the product directory, where you install Oracle Tuxedo Message Queue software; the default LDAP filter file is generated after installation is complete.
Summary	Click Install to start the installation
Installing	Nothing to do
Install End	Click Exit to exit the installation program.

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

What Do I Do Next?

To configure your Oracle Tuxedo Message Queue software, verify that your software is installed correctly, or to uninstall Oracle Tuxedo Message Queue software, see “Post-Installation”.