Installing Oracle Tuxedo Using GUI-Mode Installation

The following sections describe how to install Oracle Tuxedo using graphical user interface (GUI) mode installation:

•	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 systems.

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, use silent install mode.

Before You Start

If you are upgrading from Oracle WebLogic Enterprise or Oracle Tuxedo 12cR1 or earlier software, see Upgrading the Oracle Tuxedo System to 12c Release 2 (12.2.2) 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 12c Release 2 (12.2.2).

If you choose to remove the older software, refer to Upgrading the Oracle Tuxedo System to 12c Release 2 (12.2.2), 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 12c Release 2 (12.2.2) software to a different Oracle Home directory than the Oracle Home directory where the Oracle WebLogic Enterprise software or the older version of the Oracle Tuxedo software is installed. See also Previous Tuxedo Versions

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 12c Release 2 (12.2.2) 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 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 12c Release 2 (12.2.2) Platform Data Sheets. For important disk space allocation information, see File and Database Management and Disk Space Allocation.

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 12c Release 2 (12.2.2) installation file specific to your platform.

b.	Set the JAVA_HOME environment variable which points to your JRE or JDK home.

c.	Go to the directory where you downloaded the Oracle Tuxedo installer, unzip the installer file, and then go to the Disk1\install directory, run the following command to start the installation:

setup.bat

Note:

If you have an old version of Tuxedo installed on the machine, you should deinstall it. After completing the deinstallation, you should click the "exit" button to exit this OUI installer process, and then run the setup.bat command to start a new installation.

5.	Proceed to Running GUI-Mode Installation.

6.	Re-login to the system after Tuxedo 12c Release 2 (12.2.2) 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 12c Release 2 (12.2.2) Platform Data Sheets

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 12c Release 2 (12.2.2) Platform Data Sheets. For important disk space allocation information, see File and Database Management and Disk Space Allocation

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 12c Release 2 (12.2.2) 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 following command to invoke the installation procedure:

./runInstaller.sh

Note:

GUI mode is the default for Tuxedo 12c Release 2 (12.2.2) 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 may use console mode or silent mode installation. For more information, see What Is Console-Mode Installation? and What Is Silent Installation?

5.	Proceed to Running GUI-Mode Installation.

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.

For GUI-Mode installation screens, see Oracle Universal Installer Installation Screens.

 

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: • Full Install (the default) - all the Oracle Tuxedo server and Tuxedo, SALT, and TSAM Plus agent client components. • Server Install - all Tuxedo, SALT, and TSAM Plus agent server components of • Client Install - Tuxedo client software components only • Custom Install - select specific Tuxedo, SALT, and TSAM Plus agent 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 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). Or select an install type and then click Customize to launch the Customize Install window.
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. Tuxedo Product Installation Directory is "$ORACLE_HOME/tuxedo12.2.2.0.0" by default (UNIX) and cannot change after the ORACLE_HOME is determined. Tuxedo installer doesn't allow installation of two versions of the same tuxedo product into the same ORACLE_HOME. If the selected ORACLE_HOME had the same version tuxedo installed, the installer will show a warning.
Customize Install	Select (add) or deselect (clear) one or more software components from the selected install type, or choose one of the other four install types 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. Observe the following software component mappings: • Tuxedo Server—contains ATMI server software; CORBA C++ server software; Oracle Jolt server software; and Oracle SNMP Agent software • Tuxedo ATMI Client—contains Oracle ATMI Workstation (/WS) client software • Tuxedo CORBA Client—contains Oracle CORBA C++ client software (C++ client ORB) including environmental objects • Tuxedo Jolt JRLY—contains Oracle Jolt Relay software • Tuxedo Jolt Client—contains Oracle Jolt client software • Tuxedo . NET Client—contains Oracle .Net client software • Oracle Tuxedo System and Applications Monitor Plus (Oracle TSAM Plus) agent—contains Oracle Tuxedo System and Applications Monitor Plus (Oracle TSAM Plus) agent software • Oracle Services Architecture Leveraging Tuxedo (Oracle SALT)—contains Oracle Services Architecture Leveraging Tuxedo (Oracle SALT) software After selecting or deselecting one or more software components from the selected install type, click Next to continue with the installation. The appropriate encryption software for LLE and/or SSL is automatically included.
Confirm .NET Client Install (Windows Platforms only)	The Confirm to install .NET v4.0 Client panel displays if Microsoft .NET Framework v4.0 is not detected and install type contains ".NET Client". Click Next to proceed with the installation.
Confirm enable TSAM plus agent	This screen appears if the previously selected bundles include TSAM plus agent component. Enable it to use TSAM plus manager monitor and manage Tuxedo.
SSL Installation Choice	This window appears only if you have installed Server, ATMI and/or CORBA Client install type 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 choose	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, the default LDAP filter file is generated after installation completed)
Select samples installation	If the selected install feature sets include server component, this screen appears to confirm install the samples.
Configure tlisten Choice	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	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. 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) 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. The default minimum value is 0.
Choose Encryption max Bit (Windows Platforms only)	Specify tlisten maximum encryption bit. The default maximum value is 256.
SSL Parameter Input	If the SSL encryption method is chosen, you must enter Security Principal name, location, and password.
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 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.

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 an Oracle Home directory may be the home directory for an Oracle Tuxedo installation, an Oracle WebLogic Server installation, or other Oracle product installations, an Oracle WebLogic E-Business Platform folder may contain multiple Oracle product folders.

Understanding the Oracle Administration Program on a Windows System

The Oracle Tuxedo 12c Release 2 (12.2.2) 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 system. Only if the installation included Oracle Tuxedo server components will these additional administration tools be installed on the Windows system.

After you have installed or upgraded the Oracle Tuxedo software on your Windows system, you can use the Oracle Administration control panel (Start → Settings → Control Panel → Oracle Tuxedo 12c Release 2 (12.2.2) 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 system 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 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.

Windows Service Change

If Oracle Tuxedo 12c Release 2 (12.2.2) is installed successfully, Windows Service "ORACLE ProcMGR V12.2.2.0.0_VS2010" and "TUXEDO 12.2.2.0.0_VS2010 Listener on Port 3050" are installed.

Windows Control Panel Change

If Oracle Tuxedo 12c Release 2 (12.2.2) is installed successfully, Oracle Tuxedo 12.2.2.0.0 Control Panel is installed as below.

Earlier Version Detected

The following warning information occurs if an earlier version of Tuxedo is detected.

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.