2.5 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
  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 are installed by default to English.

The Oracle Tuxedo installer program prompts you to enter specific information about your system and configuration.

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

Table 2-1 Instructions

Window 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. Ensure that the operating system group name selected on this screen has write permissions to the central inventory location.
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.
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).

See Also:

Install Types.
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, a warning message displays. In addition, you can specify whether or not to proceed.

For silent installations, if a non-empty, existing directory is specified, an error is logged in the console and in theinstallActions<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/tuxedo21.1.0.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 displays 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 .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 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 is completed).
Select samples installation If the selected install feature sets include server component, this screen appears to confirm the 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.
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.

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.

Note:

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

Parent topic: Installing Oracle Tuxedo Using GUI-Mode Installation