Installing Oracle Tuxedo Using GUI-Mode Installation

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

•	What Is GUI-Mode Installation?

•	Before You Start

•	Starting GUI-Mode Installation on a Windows System

•	Starting GUI-Mode Installation on a UNIX System

•	Running GUI-Mode Installation

•	Assigning File Ownership on a UNIX System

•	Understanding the Oracle Tuxedo Shortcuts on a Windows System

•	Understanding the Oracle Administration Program on a Windows System

•	Reviewing the Windows Server Registry Content

•	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 on a UNIX system with a non-graphics console, see“Installing Oracle Tuxedo on UNIX Systems Using Console-Mode Installation” on page 3‑1.

Before You Start

If you are upgrading from Oracle WebLogic Enterprise or Oracle Tuxedo 9.1 or earlier software, see “Upgrading the Oracle Tuxedo System to 11g Release 1 (11.1.1.2.0)” on page 5‑1 and follow the instructions given there. Then return here to continue your Oracle Tuxedo installation.

On a Windows machine that has the Oracle WebLogic Enterprise software or an older version of the Oracle Tuxedo software installed, a window named “Previous Version Detected!” will display at the very beginning of the Oracle Tuxedo installation. This window contains a message that encourages you to exit the installation program and remove the older software before installing Oracle Tuxedo 11g Release 1 (11.1.1.2.0).

If you choose to remove the older software, refer to “Upgrading the Oracle Tuxedo System to 11g Release 1 (11.1.1.2.0)” on page 5‑1, follow the instructions to remove the older software from your machine, and then restart the installation.

If you choose not to remove the older software, install the Oracle Tuxedo 11g Release 1 (11.1.1.2.0) software to a different product directory than the product directory where the Oracle WebLogic Enterprise software or the older version of the Oracle Tuxedo software is installed. See also “Previous Tuxedo Versions” on page 1‑7

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 11g Release 1 (11.1.1.2.0) Platform Data Sheets” on page A‑1.

The Windows XP systems support only Oracle Tuxedo client components.

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 server components on a Windows system. If you are going to install only Oracle Tuxedo client components, you do not need administrative privileges.

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

For disk space requirements, see “Oracle Tuxedo 11g Release 1 (11.1.1.2.0) Platform Data Sheets” on page A‑1. For important disk space allocation information, see“File and Database Management and Disk Space Allocation” on page B‑1.

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

a.	Go to http://www.oracle.com/technology/software/index.html and download the Oracle Tuxedo 11g Release 1 (11.1.1.2.0) installation file specific to your platform.

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

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

6.	Re-login to the system after Tuxedo 11g Release 1 (11.1.1.2.0) 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 11g Release 1 (11.1.1.2.0) Platform Data Sheets” on page A‑1

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

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

For disk space requirements, see “Oracle Tuxedo 11g Release 1 (11.1.1.2.0) Platform Data Sheets” on page A‑1. For important disk space allocation information, see “File and Database Management and Disk Space Allocation” on page B‑1

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

a.	Go to http://www.oracle.com/technology/software/index.html and download the Oracle Tuxedo 11g Release 1 (11.1.1.2.0) installation file specific to your platform.

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 installer file.

Note:

GUI mode is the default for Tuxedo 11g Release 1 (11.1.1.2.0) 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‑4.

Running GUI-Mode Installation

The Oracle Tuxedo 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 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 (.NET Client Install set in not available on UNIX platforms)	Select the install set that you want installed on your system. The following seven choices are available: • Full Install (the default)—all Tuxedo server and client software components • Server Install—Tuxedo server software components only • Full Client Install—Tuxedo client software components only • Jolt Client Install—Jolt client software components only • ATMI (/WS) Client Install—Tuxedo ATMI client software components only • CORBA Client Install—Tuxedo CORBA client software components only • .NET Client Install—Tuxedo .NET client software and ATMI client components only. The .NET Client Install set installs the Tuxedo Workstation Client on your system. For more information on the Tuxedo .Net Workstation Client, see Creating Tuxedo .NET Workstation Client Applications in Using the Tuxedo .NET Workstation Client • Custom Install—select specific Tuxedo server and client software components. The following table entry provides a summary of options for the Custom Install. For a detailed list of software components for each install set, see “Install Sets” on page 1‑9. Note: A Windows XP system cannot be used as a Oracle Tuxedo server machine. On a Windows XP system, select Full Client Install, Jolt Client Install, ATMI Client Install, or CORBA Client Install from the installation menu. Select an install set 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). Or select an install set and then click Customize to launch the Customize Install window.
Customize Install	Select (add) or deselect (clear) one or more software components from the selected install set, or choose one of the other five install sets or Custom Set from the drop-down list menu and customize its software components. For a description of the JRLY component, see “Jolt Internet Relay” on page A‑5. Observe the following software component mappings: • Server—contains ATMI server software; CORBA C++ server software; Oracle Jolt server software; Oracle SNMP Agent software, and Oracle Tuxedo Administration Console software • ATMI Client—contains Oracle ATMI Workstation (/WS) client software • CORBA Client—contains Oracle CORBA C++ client software (C++ client ORB) including environmental objects • Jolt JRLY—contains Oracle Jolt Relay software • Jolt Client—contains Oracle Jolt client software • . NET Client—contains Oracle .Net client software After selecting or deselecting one or more software components from the selected install set, click Next to continue with the installation. The appropriate encryption software for LLE and/or SSL is automatically included.
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 a Oracle Home directory on your system, you can select that directory (recommended) or create a new Oracle Home directory. If you choose to create a new directory, the Oracle Tuxedo installer program automatically creates the directory for you. For details about the Oracle Home directory, see “Oracle Home Directory” on page 1‑10. Choose a 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 software. You may select the default product directory (tuxedo11gR1_VS2005 Windows or tuxedo11gR1 UNIX) or create a new product directory. If you choose to create a new directory, the Oracle Tuxedo installer automatically creates the directory for you. WARNING: Running a previous Tuxedo version in conjunction with Tuxedo 11g Release 1 (11.1.1.2.0) on a Windows system requires that the product directories for both versions do not have the same name. Choose a product directory and then click Install to start the Oracle Tuxedo software installation.
Install Samples	Click the check box to install samples. Click Next to proceed with the installation.
Confirm .Net Client Installation (Windows Platforms only)	Click Next to proceed with the installation. Will only display if .NET Client set is selected and .Net Framework is not installed on your system.
Choose Shortcut Folder (Windows Platforms only)	Specify where you want to place Tuxedo 11g Release 1 (11.1.1.2.0) shortcut icons.
Pre-Installation Summary	Review your installation selections. Clicking Previous allows you to modify installation selections. Otherwise click Install to continue.
Installing Tuxedo. . .	No user input is required here. The installation program is installing Oracle Tuxedo 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 installer is still working when this occurs.
Configure tlisten Service	This window appears only if you have installed the Server Install set. Set the tlisten port value. Note: For Windows platforms, the default value is 3050. There is no default value for UNIX platforms. 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 communications arrive on the local machine through tlisten(1) or wlisten(1) gateway processes, Oracle Tuxedo authenticates them by means of the tlisten password. Enter and re-enter a tlisten password and then click Next to continue.
Tlisten Encryption Method	Specify the tlisten encryption method: LLE or SSL. The default is LLE.
SSL Parameter Input	If the SSL encryption method is chosen, you must enter Security Principal name, location, and password.
Choose Encryption Bit	Specify tlisten minimum and maximum encryption bit. The default minimum value is 0. The default maximum value is 256.
SSL Installation Choice	This window appears only if you have installed Server, ATMI and/or CORBA Client install set components. 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. If you do not intend to use SSL encryption in your application, select No.
LDAP Configuration for SSL Support	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 software)
Install Complete	Click Done to exit the installation program.

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

Assigning File Ownership on a UNIX System

If you installed the Oracle Tuxedo software on a UNIX system, Oracle strongly recommends that you create a separate user account for the Oracle Tuxedo administrator and give ownership of the Oracle Tuxedo files to that account. To change ownership of the Oracle Tuxedo software on a UNIX machine, enter the following command:

chown -R adm_account full_path_of_tux_prod_dir
chgrp -R adm_group full_path_of_tux_prod_dir

Replace adm_account with the Oracle Tuxedo administrator account, replace adm_group with the Oracle Tuxedo administrator group ID, and replace full_path_of_tux_prod_dir with the full pathname of the product directory in which you installed the Oracle Tuxedo software.

Understanding the Oracle Tuxedo Shortcuts on a Windows System

When installing the Oracle Tuxedo software on a Windows system, the installer program automatically uses Oracle WebLogic E-Business Platform as the parent folder for Oracle Tuxedo. As additional Oracle Home directories are added to the system, the installer program continues to create new Oracle WebLogic E-Business Platform folders using the convention shown in Figure 2‑1.

Figure 2‑1 Tracking Multiple Oracle Home Directories on the Same Windows System

Each Oracle Home directory has an associated Oracle WebLogic E-Business Platform folder. Each Oracle WebLogic E-Business Platform folder contains one or more Oracle product folders (see note) and two files: OracleHOME Location and Install History.

Note:

Because a Oracle Home directory may be the home directory for a Oracle Tuxedo installation, a Oracle WebLogic Server installation, or other Oracle product installations, an Oracle WebLogic E-Business Platform folder may contain multiple Oracle product folders.

For a given Oracle Home directory and Oracle WebLogic E-Business Platform folder, the ORACLEHOME file contains the pathname of the Oracle Home directory, and the View History file contains a history of installation and uninstallation for the Oracle Home directory. Double-clicking the text icon associated with either file displays its content. The ORACLEHOME and history files contain information extracted from the logs/log.txt file located in the Oracle Home directory.

The Tuxedo 11g Release 1 (11.1.1.2.0) folder (Start →  Programs →  Oracle WebLogic E-Business Platform →  Tuxedo 11g Release 1 (11.1.1.2.0)) contains the following shortcuts:

•	Uninstall Tuxedo—choosing uninstall enables you to uninstall the Oracle Tuxedo 11g Release 1 (11.1.1.2.0) software. For more information about uninstalling Oracle Tuxedo, see “Uninstalling Oracle Tuxedo” on page 6‑31.

Understanding the Oracle Administration Program on a Windows System

In addition to the Oracle Tuxedo Administration Console, the Oracle Tuxedo 11g Release 1 (11.1.1.2.0) software for Windows provides an Oracle Administration program and two Windows services (Tlisten and Oracle procMGR) for configuring the Oracle Tuxedo system on a Windows 2003 Server system. Only if the installation included Oracle Tuxedo server components will these additional administration tools be installed on the Windows 2003 Server system.

After you have installed or upgraded the Oracle Tuxedo software on your Windows 2003 Server system, you can use the Oracle Administration control panel (Start → Settings → Control Panel → Oracle Tuxedo 11g Release 1 (11.1.1.2.0) with VS2008 Administration) to perform the following tasks:

•	Access other machines on the network on which the Oracle Tuxedo system is installed

•	Set and modify environment variables for the Oracle Tuxedo system

•	Direct Oracle Tuxedo system messages to the Windows 2003 Server Event Log

•	Configure Oracle Tuxedo tlisten(1) processes to start automatically

•	Tune interprocess communication (IPC) resources to maximize Oracle Tuxedo system performance

For instructions on performing these tasks, see “Configuring Oracle Tuxedo ATMI for Windows Server 2003” in Using Oracle Tuxedo ATMI on Windows.

Reviewing the Windows Server Registry Content

The Windows Server Registry is the repository for all hardware, software, and application configuration settings for the Windows system. During the Oracle Tuxedo installation, the installer program writes general installation information as well as IPC Resource values to the Registry. The structure of the Registry relevant to Oracle Tuxedo is as follows.

HKEY_LOCAL_MACHINE\Software\ORACLE\Tuxedo\<version>\...

•

Developer

•	Environment

•

Security

To view this structure, choose Start → Run to launch the Run dialog box, enter regEdt32, and click OK to launch the Registry Editor window.

Developer Key

The Developer key stores product information, including the major and minor version numbers of the release, and user and company names.

Environment Key

The Environment key stores the locations referenced by the Oracle Tuxedo environment variables set on your Windows system. It also stores other values such as IPC resource settings.

Security Key

The Security key holds the access permissions for Oracle Tuxedo processes and services. The following permissions are mandatory:

•	Any user who runs tlisten(1) must have read access permissions.

•	The account under which the Oracle ProcMGR service is running must have read access permissions.

Oracle recommends that the Administrator have full control permissions.

What Do I Do Next?

To configure your Oracle Tuxedo software, verify that your software is installed correctly, or to uninstall Oracle Tuxedo software, see “Performing Post-Installation Tasks” on page 6‑1.