Preparing to Install the Oracle Tuxedo System

The following sections provide information that you need to know before installing the Oracle Tuxedo 12c Release 1 (12.1.1) product software:

•	Oracle Tuxedo Web Distribution

•	Oracle Tuxedo Software Components

•	LLE and SSL Levels of Encryption

•	Hardware and Software Prerequisites

•	Interprocess Communication Resources Configuration

•	Oracle Installation Program

•	Oracle Home Directory

•	Installation Road Map

Oracle Tuxedo Web Distribution

An evaluation copy of Oracle Tuxedo is available for download from the Oracle corporate Web site at http://www.oracle.com/technology/software/index.html.

Platform-specific installer files for the Oracle Tuxedo product software are available for download from the Oracle corporate Web site.

Oracle Tuxedo Software Components

Included with the Oracle Tuxedo 12c Release 1 (12.1.1) software distribution is the Oracle Jolt product software, which enables Java clients to call Oracle Tuxedo services, and the Oracle SNMP Agent product software, which enables Oracle Tuxedo applications to be managed from a centralized enterprise management console.

The Oracle Tuxedo 12c Release 1 (12.1.1) distribution contains the following components:

•	Server components:

•	Oracle Application-to-Transaction Monitor Interface (ATMI) server software

•	Oracle Common Object Request Broker Architecture (CORBA) C++ server software

•	Oracle Jolt 12c Release 1 (12.1.1) server software

•	Oracle SNMP Agent 12c Release 1 (12.1.1) software

•	Oracle Tuxedo Administration Console software

•	Link-Level Encryption (LLE) and Secure Sockets Layer (SSL) encryption software

•	Client components:

•	Oracle ATMI Workstation (/WS) client software

•	Oracle CORBA C++ client software—includes the C++ client Object Request Broker (ORB) and the environmental objects

•	Oracle Jolt 12c Release 1 (12.1.1) client software

•	Tuxedo.NET Workstation client software

•	LLE and SSL encryption software

Figure 1‑1 illustrates a high-level view of the Oracle Tuxedo client and server components.

Figure 1‑1 Oracle Tuxedo Client and Server Components

For descriptions of terms such as remote client, native client, LLE, and SSL, see “Client and Server Components” in Oracle Tuxedo Product Overview.

Tuxedo .NET Workstation Client

The Tuxedo .NET Workstation Client requires:

•	the ATMI Client to be automatically installed when you select the .NET Client install set.

•

A correct version of Microsoft’s .NET Framework installed on your system. If .NET Framework is not detected, you can continue the .NET Client installation and install.NET Framework later. For more information on the Tuxedo.Net Workstation Client, see Creating Tuxedo.NET Workstation Client Applications.

LLE and SSL Levels of Encryption

LLE and SSL are available with two levels of encryption: 56-bit and 128/256-bit.

Hardware and Software Prerequisites

The Oracle Tuxedo software must be installed on each server machine that will participate in a Oracle Tuxedo application, also known as a Tuxedo domain. A Tuxedo application is a business software program, built upon the Tuxedo system, that is defined and controlled by a single configuration file known as the UBBCONFIG file. The Tuxedo configuration file is described in reference page UBBCONFIG(5) in Oracle Tuxedo File Formats, Data Descriptions, MIBs, and System Processes Reference.

A Tuxedo application consists of many Tuxedo system processes, one or more application client processes, one or more application server processes, and one or more computer machines connected over a network. In a multi-machine Tuxedo application running different releases of the Oracle Tuxedo software, the master machine—designated via the MASTER parameter in the RESOURCES section of the UBBCONFIG file—must run the highest release of the Oracle Tuxedo software in the application. For more information about Tuxedo applications, see “Domains” in Oracle Tuxedo Product Overview.

Note:

Oracle advises against trying to share the Oracle Tuxedo system executables across remote filesystems; this practice has proven to be unreliable in the past.

System Requirements

The system requirements for Oracle Tuxedo 12c Release 1 (12.1.1) are given in Table 1‑1.

 

Table 1‑1 The System Requirements for Oracle Tuxedo 12c Release 1 (12.1.1)

Component	Requirement
Platform*	Any platform identified in “Oracle Tuxedo 12c Release 1 (12.1.1) Platform Data Sheets” on page A‑1.
Hard disk drive	As stated in the data sheet for the target platform in “Oracle Tuxedo 12c Release 1 (12.1.1) Platform Data Sheets” on page A‑1. For additional information about disk space requirements, see “File and Database Management and Disk Space Allocation” on page C‑1.
Memory	As stated in the data sheet for the target platform in “Oracle Tuxedo 12c Release 1 (12.1.1) Platform Data Sheets” on page A‑1.
* Microsoft Windows XP systems support only the Oracle Tuxedo client components.

For Oracle Jolt installation preparatory information, see “Oracle Jolt 12c Release 1 (12.1.1) Overview and Installation Information” on page B‑1. No installation preparation is required for Oracle SNMP Agent.

Note:

Before installing Oracle Tuxedo software on a UNIX system, Oracle recommends that you repartition your hard disk device in accordance to “File and Database Management and Disk Space Allocation” on page C‑1.

Temporary Storage Space Requirements

The Oracle Installation program uses a temporary directory in which it extracts the files from the archive that are needed to install Oracle Tuxedo on the target system. During the installation process, your temporary directory must contain sufficient space to accommodate the compressed Java Runtime Environment (JRE) bundled with the installer and an uncompressed copy of the JRE that is expanded into the temporary directory. The installation program moves the JRE from the temporary directory to the Oracle Home directory at the end of the installation process. For information about the Oracle Home directory, see “Oracle Home Directory” on page 1‑10.

The amount of temporary storage space needed depends upon the target platform, as stated in the data sheets in “Oracle Tuxedo 12c Release 1 (12.1.1) Platform Data Sheets” on page A‑1.

By default, the installation program uses the temporary directories shown in Table 1‑2.

 

Table 1‑2 Temporary Directories

Platform	Directory
Windows	Directory referenced by the TMP system variable
UNIX	/tmp

To ensure there is adequate temporary space, you may want to allocate an alternate directory for use as a temporary directory for the installation. To do so, perform the appropriate step in Table 1‑3 and clean up files as more as possible in the temporary directory before starting the Oracle Installation program.

 

Table 1‑3 Perform This Step

On This Platform...	Perform This Step...
Windows	Set the TMP system variable to a directory of your choice.
UNIX	Enter the following command at the shell prompt: export IATEMPDIR=tmpdirname Replace tmpdirname with the name of a temporary directory of your choice.

Interprocess Communication Resources Configuration

Interprocess communication (IPC) is a capability supported by the Windows and UNIX operating systems that allows one process to communicate with another process. The processes can be running on the same computer or on different computers connected through a network.

On a Windows 2003 Server system, the Oracle Tuxedo system provides an IPC service called the Oracle ProcMGR (Process Manager), which facilitates interprocess communications. You use the Oracle ProcMGR service to adjust the IPC parameters and maximize the performance of a Oracle Tuxedo application.

On a UNIX system, you use methods native to the UNIX system to adjust the IPC parameters and maximize the performance of a Oracle Tuxedo application. Since most UNIX systems are shipped with default values that are too low for a Oracle Tuxedo application, you need to adjust the IPC parameters, using the methods given in “Oracle Tuxedo 12c Release 1 (12.1.1) Platform Data Sheets” on page A‑1. For the recommended IPC values, see “IPC Resource Configuration on a UNIX System” on page D‑1.

After installing the Oracle Tuxedo software and creating an application configuration file (UBBCONFIG file), you use the tmloadcf(1) command to calculate and print a list of the minimum IPC resources needed to support the application. If your Oracle Tuxedo application is distributed, the minimum IPC resources must be available on every machine participating in the application. For more information about calculating IPC resources using the tmloadcf(1) command, see “Performing Post-Installation Tasks” on page 6‑1.

Note:

Before installing Oracle Tuxedo software on a UNIX system, Oracle recommends that you adjust the IPC parameters on the target machine in accordance to “IPC Resource Configuration on a UNIX System” on page D‑1.

Oracle Installation Program

The Oracle Tuxedo software is distributed as an installer file, which also contains a copy of the Oracle Installation program. The Oracle Installation program is the Oracle standard tool for installing the Oracle Tuxedo software on Windows or UNIX systems.

Note:

On Windows platforms you must re-login to the system after Tuxedo 12c Release 1 (12.1.1) installation has completed.

Previous Tuxedo Versions

If a previous version of the Tuxedo software is detected during GUI mode and silent installation on a Windows system, the Tuxedo installer will automatically stop the following previous Tuxedo version ProcMGR and Listener services:

•	Oracle ProcMGR V2.2

•	Oracle ProcMGR V8.0

•	Oracle ProcMGR V8.1

•	Oracle ProcMGR V9.0

•	Oracle ProcMGR V9.1

•	Oracle ProcMGR V9.1with VS2005 v2

•	Oracle ProcMGR V10.0 with VS2005

•	Tuxedo 10.0 with VS2005 Listener on Port 3050

•	Tuxedo 9.1 Listener on Port 3050

•	Tuxedo 9.1with VS2005 Listener on Port 3050

•	Tuxedo 9.0 Listener on Port 3050

•	Tuxedo 8.1 Listener on Port 3050

•	Tuxedo 8.0 Listener on Port 3050

•	Tuxedo 7.1 Listener on Port 3050

•	Tuxedo 6.5 Tuxedo IPC Helper

Note:

During GUI installation, users will be prompted with the following message: “Stopping Previous Version Tuxedo Services”

Listener services configured on ports other than 3050 must be stopped manually.

The current Tuxedo distribution requires these services to be stopped in order to run multiple Tuxedo versions on the same machine. The time required for stopping the ProcMGR services is minimal; however, the time required to stop the listener services may take a few minutes.

Installation Methods

The Oracle Installation program supports three installation methods. You can use any of these methods to install the Oracle Tuxedo product software:

•	Graphical user interface (GUI) installation, described in “Installing Oracle Tuxedo Using GUI-Mode Installation” on page 2‑1.

•	Console Installation (UNIX systems only), described in “Installing Oracle Tuxedo on UNIX Systems Using Console-Mode Installation” on page 3‑1.

•	Silent installation, described in “Installing Oracle Tuxedo Using Silent Installation” on page 4‑1.

Cancelling Installation

Clicking the “Cancel” or the “close’ window button in GUI mode, or typing “quit” in console mode creates an incomplete Tuxedo 12c Release 1 (12.1.1) installation. You will have to re-install Tuxedo 12c Release 1 (12.1.1).

If you installed Tuxedo 12c Release 1 (12.1.1) in a previous Tuxedo product directory, and you want to return to your original configuration, you must re-install your previous Tuxedo version.

Install Sets

An install set is a bundle of product software components related by function. Oracle Tuxedo 12c Release 1 (12.1.1) offers the following seven install sets:

•	Full install set—consists of all the Oracle Tuxedo 12c Release 1 (12.1.1) server and client components

•	Server install set—consists of all the Oracle Tuxedo 12c Release 1 (12.1.1) server components:

•	Oracle Application-to-Transaction Monitor Interface (ATMI) server, native ATMI client, and ATMI Workstation (/WS) software

•	Oracle Common Object Request Broker Architecture (CORBA) C++ server

•	Oracle Jolt 12c Release 1 (12.1.1) server software including Oracle Jolt Internet Relay

•	Oracle SNMP Agent 12c Release 1 (12.1.1) software

•	Oracle Tuxedo Administration Console software

•	Link-Level Encryption (LLE) and Secure Sockets Layer (SSL) encryption software

•	Full client install set—consists of all the Oracle Tuxedo 12c Release 1 (12.1.1) client components:

•	Oracle ATMI Workstation (/WS) client software

•	Oracle CORBA C++ client software (C++ client Object Request Broker, or ORB) including environmental objects

•	Oracle Jolt 12c Release 1 (12.1.1) client software

•	Oracle Tuxedo.NET Workstation client software

•	LLE and SSL encryption software

•	ATMI (/WS) client install set—consists of the following Oracle Tuxedo 12c Release 1 (12.1.1) components:

•	Oracle ATMI (/WS) client software

•	LLE and SSL encryption software

•	CORBA client install set—consists of the following Oracle Tuxedo 12c Release 1 (12.1.1) components:

•	Oracle CORBA C++ client software

•	SSL encryption software

•	Jolt client install set—consists of the following Oracle Tuxedo 12c Release 1 (12.1.1) components:

•	Oracle Jolt 12c Release 1 (12.1.1) client software

•	LLE and SSL encryption software

•	.NET client install set—consists of the following Oracle Tuxedo 12c Release 1 (12.1.1) components and install sets: (Windows platforms only)

•	Tuxedo.NET Workstation client software

•	Oracle ATMI (/WS) client install set

In addition to selecting an install set during a Oracle Tuxedo 12c Release 1 (12.1.1) installation, a user can further customize the installation by selecting (adding) or deselecting (deleting) one or more software components from the install set. Customizing is only possible for GUI-mode and console-mode installation methods described in “Installing Oracle Tuxedo Using GUI-Mode Installation” on page 2‑1 and “Installing Oracle Tuxedo on UNIX Systems Using Console-Mode Installation” on page 3‑1; it is not possible for silent-mode installation method.

Oracle Home Directory

When you install Oracle Tuxedo, you are prompted to specify an Oracle Home directory. The Oracle Home directory is a repository for common files that are used by multiple Oracle products installed on the same machine. For this reason, the Oracle Home directory can be considered a “central support directory” for the Oracle products installed on your system.

The files in the Oracle Home directory are essential to ensuring that the Oracle software operates correctly on your system. These files perform the following types of functions:

•	Facilitate checking of cross-product dependencies during installation

•	Facilitate service pack installation

The structure of the Oracle Home directory created by the Oracle Tuxedo 12c Release 1 (12.1.1) installer program is shown in the following illustration.

Choosing a Oracle Home Directory

During the installation of Oracle Tuxedo 12c Release 1 (12.1.1), you are prompted to choose an existing Oracle Home directory or specify a path for a new Oracle Home directory. If you choose to create a new directory, the Oracle Tuxedo installer program automatically creates the directory for you.

Upon choosing a Oracle Home directory, you are prompted to choose a Oracle product directory for your Oracle Tuxedo installation. You may choose to create your Oracle product directory under the Oracle Home directory, but there is no requirement to do so.

Understanding the Functions of the Oracle Home Directory

The files and directories in an Oracle Home directory created by the Oracle Tuxedo installer are described in Table 1‑4.

 

Table 1‑4 Description

Component	Description
registry.xml file	An XML registry file that contains a persistent record of all Oracle products installed on the target system for this Oracle Home directory. The registry contains product-related information, such as version level, service pack level, and product installation directory.
logs directory	A directory containing a Oracle Home location file and a history file of installation and uninstallation for this Oracle Home directory. For more information on these files, see the “Understanding the Oracle Tuxedo Shortcuts on a Windows System” on page 2‑11.

Creating More Than One Oracle Home Directory

Although it is possible to create more than one Oracle Home directory, Oracle recommends that you avoid doing so. In almost all situations, a single Oracle Home directory is sufficient. There may be circumstances, however, in which you prefer to maintain separate development and production environments, each containing a separate product stack. With two directories, you can update your development environment (in an Oracle Home directory) without modifying the production environment until you are ready to do so.

Installation Road Map

You are now ready to begin your installation. To install Oracle Tuxedo 12c Release 1 (12.1.1), see one of the following sections:

•	“Installing Oracle Tuxedo Using GUI-Mode Installation” on page 2‑1

•	“Installing Oracle Tuxedo on UNIX Systems Using Console-Mode Installation” on page 3‑1

•	“Installing Oracle Tuxedo Using Silent Installation” on page 4‑1

If you are upgrading from Oracle WebLogic Enterprise or Oracle Tuxedo 9.1 or earlier software, see “Upgrading the Oracle Tuxedo System to 12c Release 1 (12.1.1)” on page 5‑1.

If you want to uninstall your Oracle Tuxedo software, see “Performing Post-Installation Tasks” on page 6‑1.