1 Preparing to Install the Oracle Tuxedo System
Preparing to Install the Oracle Tuxedo System The following sections provide information that you need to know before installing the Oracle Tuxedo 22c Release 1 (22.1.0.0.0) product software:
- Oracle Universal Installer (OUI)
- Modes of Installation
- Installation Media
- Special Instructions for UNIX Users
- About Oracle Universal Installer Log Files
- Oracle Internationalization
- Oracle Tuxedo Web Distribution
- Oracle Tuxedo Software Components
- Hardware and Software Prerequisites
- System Requirements
- Software Requirements
- Interprocess Communication Resources Configuration
- Oracle Installation Program
- Install Types
- Installation Road Map
1.1 Oracle Universal Installer (OUI)
The Oracle Tuxedo 22c Release 1 (22.1.0.0.0) product software installer is based on the Oracle Universal Installer (OUI). To install the Oracle Tuxedo 22c Release 1 (22.1.0.0.0) product software on your host, you must know how to use OUI to install Oracle products.
Parent topic: Preparing to Install the Oracle Tuxedo System
1.2 Modes of Installation
- Interactive
- Use OUI interactive mode to use the graphical user interface to walk through the installation, providing information in the installation dialogs when prompted. This method is most useful when installing a small number of products in different setups on a small number of hosts.
- Console
- Use OUI console mode to bypass the graphical user interface and execute the Oracle Installation program with a console interactive interface. This method is intended for UNIX systems with non-graphical consoles.
- Silent
- Use OUI silent installation mode to bypass the graphical user interface and supply the necessary information in a response file. This method is most useful when installing the same product multiple times on multiple hosts. By using a response file, you can automate the installation of a product for which you know the installation parameters.
Parent topic: Preparing to Install the Oracle Tuxedo System
1.3 Installation Media
Note:
When you invokerunInstaller.sh
(UNIX), you should invoke it from the directory where this command is present, or you must specify the complete path to runInstaller.sh
(UNIX).
Parent topic: Preparing to Install the Oracle Tuxedo System
1.4 Special Instructions for UNIX Users
The following sections describe special instructions that apply when you are installing certain products on a UNIX system.
- Providing a UNIX Installer Location with Root Privileges
- Failed to Connect to Server Error
- Providing a UNIX Group Name
Parent topic: Preparing to Install the Oracle Tuxedo System
1.4.1 Providing a UNIX Installer Location with Root Privileges
If you are installing Oracle Products with OUI for the first time, you are prompted to run a shell script from another terminal window before proceeding with the installation.
Note:
When running OUI in silent mode,orainstRoot.sh
is required prior to configuration assistants, OUI skips configuration assistants during the installation. You must run orainstRoot.sh
as root and then run the skipped configuration assistants after the silent installation is complete.
- Leave the OUI window open and open another terminal window.
- In the new terminal window, use the substitute user command to log in with root privileges:
su -root
. - Change directory to the Oracle home into which you are currently installing your Oracle software product.
- Run the shell script
orainstRoot.sh
. - When the script is finished and you are returned to the command prompt, exit from the new terminal window and return to OUI to continue installation.
Note:
Do not exit the installation to run the shell script. Exiting the installation removes this script. You are prompted to run the script only when you install Oracle products for the first time with OUI.Parent topic: Special Instructions for UNIX Users
1.4.2 Failed to Connect to Server Error
Xlib
error or a "Failed to connect to Server
" error when you are running OUI on the Solaris operating system, do the following:
- Define the following environment variable on the host computer where you are running OUI:
%setenv DISPLAY <machine name>:0.0
- Replace
<machine name>
with the name of the computer that displays the OUI. - On the computer that displays the OUI, enter the following command, which allows other computers to display information on the computer monitor:
%xhost +
- Rerun the
runInstaller.sh
script after you have set theDISPLAY
environment variable.
Note:
You can run OUI without specifying theDISPLAY
variable by running in silent mode using a response file.
Parent topic: Special Instructions for UNIX Users
1.4.3 Providing a UNIX Group Name
If you are installing a product on a UNIX system, the Installer also prompts you to provide the name of the group that owns the base directory.
You must choose a UNIX group name that has permissions to update, install, and remove Oracle software. Members of this group must have write permissions for the chosen base directory.
Only users who belong to this group are able to install or remove software on this host.
Parent topic: Special Instructions for UNIX Users
1.5 About Oracle Universal Installer Log Files
$ORACLE_HOME/cfgtoollogs
You can use these log files to troubleshoot installation problems. These files are also crucial for removing and configuring the various software components you install. OUI displays the name and location of the current session log file on the Install page. Each installation or configuration utility provides a separate folder containing the logs inside the $ORACLE_HOME/cfgtoollogs
folder.
Note:
The logs used to remove products are different from installActions<timestamp> .log
generated during the install process. The installActions<timestamp>.log
is easier to read and can be used to view the operations performed at installation time.
Parent topic: Preparing to Install the Oracle Tuxedo System
1.6 Oracle Internationalization
This section helps you set your OUI (Oracle User Interface ) language.
1.6.1 Installation Dialogs Language
OUI runs in the operating system language. OUI uses the language that Java detects the system locale value, and sets that to the default language. The OUI dialogs are displayed in this language if available. If specific the OUI dialogs are not translated in the language of the operating system, these dialogs are shown in English.
OUI displays the translated GUI only if the variable NLS_ENABLED
has been set to TRUE
in the oraparam.ini
file. If the NLS_ENABLED
variable is set to FALSE
, all text is shown in English.
Note:
The dialogs displayed for internationalization can only be customized parts; some of them are embedded in OUI.Parent topic: Oracle Internationalization
1.7 Oracle Tuxedo Web Distribution
Oracle Tuxedo is available for download from the Oracle corporate Web site.
Platform-specific installer files for the Oracle Tuxedo product software are available for download from the Oracle corporate Web site.
Parent topic: Preparing to Install the Oracle Tuxedo System
1.8 Oracle Tuxedo Software Components
Included with the Oracle Tuxedo 22c Release 1 (22.1.0.0.0) 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, and Oracle Service Architecture Leveraging Tuxedo (Oracle SALT), which provides native Tuxedo Web service.
The Oracle Tuxedo 22c Release 1 (22.1.0.0.0) distribution contains the following components:
- Oracle Tuxedo Server components:
- Oracle Application-to-Transaction Monitor Interface (ATMI) server software
- Oracle Common Object Request Broker Architecture (CORBA) C++ server software
- Oracle Jolt server software
- Oracle SNMP Agent software
- Oracle Tuxedo 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 22c Release 1 (22.1.0.0.0) client software
- Oracle Service Architecture Leveraging Tuxedo (Oracle SALT):
- Oracle Service Architecture Leveraging Tuxedo (Oracle SALT) software
The following figure illustrates the high-level components of Oracle Tuxedo:
Figure 1-1 Oracle Tuxedo Client and Server Components
![Oracle Tuxedo Client and Server Components Diagram Oracle Tuxedo Client and Server Components Diagram](img/oracle-tuxedo-client-and-server-components.jpg)
See Also:
Client and Server ComponentsParent topic: Preparing to Install the Oracle Tuxedo System
1.9 Hardware and Software Prerequisites
The Oracle Tuxedo software must be installed on each server machine that participates in an Oracle Tuxedo application, also known as a Tuxedo domain. A Tuxedo application is a business software program, built upon the Tuxedo system, which is defined and controlled by a single configuration file known as the UBBCONFIG
file. The Tuxedo configuration file is described on reference page UBBCONFIG(5)
inFile 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.
- 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.
Parent topic: Preparing to Install the Oracle Tuxedo System
1.10 System Requirements
The system requirements for Oracle Tuxedo 22c Release 1 (22.1.0.0.0) mentioned in the following table:
Table 1-1 The System Requirements for Oracle Tuxedo 22c Release 1 (22.1.0.0.0)
Component | Requirement |
---|---|
Platform* | Any platform identified in Oracle Tuxedo 22c Release Platform Data Sheets. |
Hard disk drive | As stated in the data sheet for the target platform in Oracle Tuxedo 22c Release Platform Data Sheets. For additional information about disk space requirements, see File and Database Management and Disk Space Allocation. |
Memory | As stated in the data sheet for the target platform in Oracle Tuxedo 22c Release Platform Data Sheets. |
1.11 Software Requirements
Java Runtime Environment(JRE) is required to install Oracle Tuxedo 22c using console mode. JRE 1.8 and above are recommended. Ensure that you install the required JRE and set the environment variable JAVA_HOME
accordingly before installing Oracle Tuxedo.
Parent topic: Preparing to Install the Oracle Tuxedo System
1.12 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. On a UNIX system, you use methods native to the UNIX system to adjust the IPC parameters and maximize the performance of an Oracle Tuxedo application. Since most UNIX systems are shipped with default values that are too low for an Oracle Tuxedo application, you need to adjust the IPC parameters, using the methods given in Oracle Tuxedo 22c Release Platform Data Sheets. For the recommended IPC values, see IPC Resource Configuration on a UNIX System.
After installing the Oracle Tuxedo software and creating an application configuration file (UBBCONFIG
file), you use thetmloadcf(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 and using the tmloadcf(1)
command, see Performing Post-Installation Tasks
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 the information mentioned in the following link, IPC Resource Configuration on a UNIX SystemParent topic: Preparing to Install the Oracle Tuxedo System
1.13 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 UNIX systems.
1.13.1 Cancelling Installation
Clicking the “Cancel” or the “close’ window button in GUI mode causes an incomplete Oracle Tuxedo 22c Release 1 (22.1.0.0.0) installation. In that case, you must re-install Oracle Tuxedo 22c Release 1 (22.1.0.0.0).
If you install Oracle Tuxedo 22c Release 1 (22.1.0.0.0) in a previous Tuxedo product directory, and you want to return to your original configuration, you must re-install your previous Tuxedo version. It is strongly suggested that you install the Oracle Tuxedo 22c Release 1 (22.1.0.0.0) to a new Oracle Home product directory.
Parent topic: Oracle Installation Program
1.14 Install Types
An install type is a bundle of product software components related by function. Oracle Tuxedo 22c Release 1 (22.1.0.0.0) offers the following install types:
- Full Install - consists of all the Oracle Tuxedo 22c Release 1 (22.1.0.0.0) server and client components of Tuxedo, SALT, and TSAM Plus agent.
- Server Install - consists of all the Oracle Tuxedo 22c Release 1 (22.1.0.0.0) server components of Tuxedo, SALT, and TSAM Plus agent.
- Client Install - consists of all the Oracle Tuxedo 22c Release 1 (22.1.0.0.0) 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 22c Release 1 (22.1.0.0.0) client software
In addition to selecting an install type during an Oracle Tuxedo 22c Release 1 (22.1.0.0.0) installation, a user can further customize the installation by selecting (adding) or deselecting (deleting) one or more software components from the install type. Customizing is only possible for GUI-mode installation methods described in Installing Oracle Tuxedo Using GUI-Mode Installation.
Parent topic: Preparing to Install the Oracle Tuxedo System
1.15 Installation Road Map
You are now ready to begin your installation. To install Oracle Tuxedo 22c Release 1 (22.1.0.0.0), see one of the following sections:
- Installing Oracle Tuxedo Using GUI-Mode Installation.
- Installing Oracle Tuxedo Using Console-Mode Installation.
- Installing Oracle Tuxedo Using Silent Installation
If you are upgrading from Oracle Tuxedo Release (12.2.2.0.0) or earlier software, see Upgrading the Oracle Tuxedo System to Tuxedo 22c Release 1(22.1.0.0.0)
If you want to uninstall your Oracle Tuxedo software, see Uninstalling Oracle Tuxedo
Parent topic: Preparing to Install the Oracle Tuxedo System