The following sections describe how to install Oracle Tuxedo using graphical user interface (GUI) mode installation on both Windows and UNIX systems:
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, seeInstalling Oracle Tuxedo on UNIX Systems Using Console-Mode Installation. |
If you are upgrading from Oracle WebLogic Enterprise or Oracle Tuxedo 9.1 or earlier software, see Upgrading the Oracle Tuxedo System to 10g Release 3 (10.3) 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 10g Release 3 (10.3).
If you choose to remove the older software, refer to Upgrading the Oracle Tuxedo System to 10g Release 3 (10.3), 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 10g Release 3 (10.3) 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
To start the GUI-mode installation process on a Windows system, follow these steps:
The Windows XP systems support only Oracle Tuxedo client components.
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.
For disk space requirements, see Oracle Tuxedo 10g Release 3 (10.3) Platform Data Sheets. For important disk space allocation information, seeFile and Database Management and Disk Space Allocation.
To start the GUI-mode installation process on a UNIX system, follow these steps:
For disk space requirements, see Oracle Tuxedo 10g Release 3 (10.3) Platform Data Sheets. For important disk space allocation information, see File and Database Management and Disk Space Allocation
where filename
is the name of the Oracle Tuxedo installer file.
Note: | GUI mode is the default for Tuxedo 10g Release 3 (10.3) installation. If a GUI interface is not available on your Unix platform, you will receive an error message and the installation process is aborted. |
Note: | 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? |
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 the following table.
Select the install set that you want installed on your system. The following seven choices are available:
For a detailed list of software components for each install set, see Install Sets.
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.
|
|||||
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.
|
|||||
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.
|
|||||
Specify the directory in which you want to install the Oracle Tuxedo software. You may select the default product directory (
tuxedo10gR3_VS2005 Windows or tuxedo10gR3 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.
|
|||||
No user input is required here. The installation program is installing Oracle Tuxedo in the user-specified product directory.
|
|||||
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.
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.
|
|||||
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.
|
|||||
|
|||||
Congratulations! Your installation of the Oracle Tuxedo software is complete!
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.
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 the following figure.
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 10g Release 3 (10.3) folder (Start Programs Oracle WebLogic E-Business Platform Tuxedo 10g Release 3 (10.3)) contains the following shortcuts:
In addition to the Oracle Tuxedo Administration Console, the Oracle Tuxedo 10g Release 3 (10.3) 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 10g Release 3 (10.3) with VS2005 Administration) to perform the following tasks:
tlisten(1)
processes to start automatically For instructions on performing these tasks, see “Configuring Oracle Tuxedo ATMI for Windows Server 2003” in Using Oracle Tuxedo ATMI on Windows.
The Windows 2003 Server Registry is the repository for all hardware, software, and application configuration settings for the Windows 2003 Server 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\10.3.0.0_VS2005\...
To view this structure, choose Start Run to launch the Run dialog box, enter regEdt32
, and click OK to launch the Registry Editor window.
The Developer key stores product information, including the major and minor version numbers of the release, and user and company names.
The Environment key stores the locations referenced by the Oracle Tuxedo environment variables set on your Windows 2003 Server system. It also stores other values such as IPC resource settings.
The Security key holds the access permissions for Oracle Tuxedo processes and services. The following permissions are mandatory:
Oracle recommends that the Administrator
have full control permissions.
To configure your Oracle Tuxedo software, verify that your software is installed correctly, or to uninstall Oracle Tuxedo software, see Performing Post-Installation Tasks.