Installing Oracle Tuxedo Using Silent Installation

The following sections describe how to install Oracle Tuxedo using silent installation on both Windows and UNIX systems:

•	What Is Silent Installation?

•	Before You Start

•	Using Silent Installation: Main Steps

•	Creating a Template File

•	Invoking the Silent Installation Process on a Windows System

•	Invoking the Silent Installation Process on a UNIX System

•	Windows Template File

•	UNIX Template File

•	What Do I Do Next?

What Is Silent Installation?

Silent installation reads the settings for your configuration from a text file that you create prior to beginning the installation. Manual intervention is not necessary during the installation process. Silent installation works on both Windows and UNIX systems.

Silent installation is a way of setting installation configurations only once and then using those configurations to duplicate the installation on many machines.

Note:

Using silent installation implies your consent to the License Agreement. You neither see a copy of the Software License Agreement nor have any means to accept the terms of the agreement.

Before You Start

If you are upgrading from Oracle WebLogic Enterprise or Oracle Tuxedo 9.1 or earlier software, see “Upgrading the Oracle Tuxedo System to 11g Release 1 (11.1.1.3.0)” on page 5‑1 and follow the instructions given there. Then return here to continue your Oracle Tuxedo installation.

If you are planning to use Oracle Tuxedo 11g Release 1 (11.1.1.3.0) in conjunction with a previous Tuxedo version on a Windows system, see “Oracle Installation Program” on page 1‑7.

Using Silent Installation: Main Steps

The silent installation process has two primary steps:

1.	Create a template file that contains the configuration settings, such as Oracle Home directory, product directory, and install set appropriate for your installation.

For the detailed procedure, see “Creating a Template File” on page 4‑3. Two sample template files are provided in “Windows Template File” on page 4‑9 and “UNIX Template File” on page 4‑11.

2.	Invoke the installation process using the values specified in the template files.

For the detailed procedure, see “Invoking the Silent Installation Process on a Windows System” on page 4‑6 and “Invoking the Silent Installation Process on a UNIX System” on page 4‑7.

Creating a Template File

To create a template file for use in the silent installation process, follow these steps:

1.	Display the template file specific to your platform. The following templates are available in:

•	Windows template file content at “Windows Template File” on page 4‑9.

•	UNIX template file content at “UNIX Template File” on page 4‑11.

2.	Copy the contents of the template file and save it as a text file named installer.properties.

3.	In the installer.properties file, modify the values for the keywords shown in the following table to create your desired configuration.

The installer.properties file is shown in Table 4‑1

 

Table 4‑1 The installer.properties File 

For This Keyword . . .	Enter the Following Value . . .
INSTALLER_UI= (UNIX and Windows)	The mode of installation. The default is silent; do not modify this value.
ORACLEHOME= (UNIX and Windows)	The full pathname of the Oracle Home directory of your choice. For details about the Oracle Home directory, see “Oracle Home Directory” on page 1‑10.
USER_INSTALL_DIR= (UNIX and Windows)	The full pathname of the product directory of your choice. WARNING: Running a previous Tuxedo version in conjunction with Tuxedo 11g Release 1 (11.1.1.3.0) on a Windows system requires that the product directories for both versions do not have the same name.
INSTALL_SAMPLES	“yes” installs Tuxedo 11gR1 samples. “no” does not install samples.
LDAP_HOSTNAME= (UNIX & Windows)	The fully qualified domain name of the Lightweight Directory Access Protocol (LDAP) server of your choice; for example, pcwiz.mydomain.com. (See Note at end of table.)
LDAP_PORTID= (UNIX & Windows)	The port number through which the local machine communicates with the LDAP server; for example, 389.* (See Note at end of table.)
TLISTEN_PORT (Windows)	The port number through which the local machine communicates with the TLISTEN server; for example, 1357.
LDAP_BASE_OBJECT= (Unix & Windows)	The distinguished name of the base object for search in the LDAP server; for example, o=beasys.com. (See Note at end of table.)
LDAP_FILTER_FILE= (Unix & Windows)	The full pathname of the LDAP filter file on your machine; for example, C:\oracle\tuxedo11gR1\udataobj\security\ bea_ldap_filter.dat. (See Note at end of table.)
TLISTEN_PASSWORD= (Unix & Windows)	A tlisten password of your choice. The password must be a string of alphanumeric characters in clear-text format that is no more than 80 characters in length. You will be prompted to enter this password when logging in to the Oracle Tuxedo Administration Console.
CHOSEN_INSTALL_SET=	The chosen installation set. You must set this value to one of the following options: Notes: The valid options are case sensitive and should be coded exactly as defined below for proper installation. Use of invalid options will result in improper installation. Spaces should not be included after the install set name. If there are spaces after the install set name, the installation process uses the default mode Full Install. • Full for a full installation • Server for server-only installation • Client for full client installation • ATMI for ATMI-client-only installation, • CORBA for CORBA-client-only installation • Jolt for Jolt-client-only installation • DNET for Tuxedo .NET Workstation client only installation (Windows platforms only.) No customizing of install sets is possible with silent-mode installation. For a description of install sets, see “Install Sets” on page 1‑9.

Notes:

Keywords: LDAP_HOSTNAME, LDAP_PORTID, LDAP_BASE_OBJECT, LDAP_FILTER_FILE are optional.

Include these keywords and their values only if you want to use Secure Sockets Layer (SSL) encryption. Otherwise, comment these lines out by preceding them with hash marks (#).

Keywords: TLISTEN_PORT, and TLISTEN_PASSWORD are also optional

Include these keywords and their values only if you select Server (server-only installation).

In the template files, comment lines are preceded by hash marks (#). The installer program does not read any line beginning with a hash mark.

Invoking the Silent Installation Process on a Windows System

Installing the software using silent installation takes the same amount of time as a standard installation. During silent installation, an initial installation program window appears briefly, indicating that the installation has started.

To invoke the silent 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 11g Release 1 (11.1.1.3.0) Platform Data Sheets” on page A‑1.

The Windows XP system supports only Oracle Tuxedo client components.

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 11g Release 1 (11.1.1.3.0) Platform Data Sheets” on page A‑1. For important disk space allocation information, see “File and Database Management and Disk Space Allocation” on page D‑1.

4.	If installing Oracle Tuxedo by downloading from the Oracle Web site:

a.	Open a command-line shell.

b.	Go to http://www.oracle.com/technology/software/index.html and download the Oracle Tuxedo 11g Release 1 (11.1.1.3.0) installation file specific to your platform.

c.	Go to the directory where you downloaded the installer and invoke the installation procedure by entering the following command:

prompt> filename.exe -f path\installer.properties

where filename is the name of the Oracle Tuxedo installer file, and path is the full or relative pathname of the installer.properties file.

Note:

If a file named installer.properties is present in the same directory as the installer (for example, tuxedo81_win.exe), it will be supplied automatically in silent mode. However, if installer.properties is in a different directory, you may use the -f command line option to specify the properties file. For example, filename.exe -f path\installer.properties

5.	To verify that the software installed successfully, see “Performing Post-Installation Tasks” on page 6‑1.

6.	Re-login to the system after Tuxedo 11g Release 1 (11.1.1.3.0) installation has completed.

Invoking the Silent Installation Process on a UNIX System

Installing the software using silent installation takes the same amount of time as a standard installation. During silent installation, a startup message appears followed by an “Installing . . .” message, indicating that the installation has started.

To invoke the silent 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 11g Release 1 (11.1.1.3.0) Platform Data Sheets” on page A‑1.

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 11g Release 1 (11.1.1.3.0) Platform Data Sheets” on page A‑1. For important disk space allocation information, see “File and Database Management and Disk Space Allocation” on page D‑1.

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 11g Release 1 (11.1.1.3.0) installation file specific to your platform.

b.	Go to the directory where you downloaded the installer and invoke the installation procedure by entering the following command:

prompt> sh filename.bin -f path/installer.properties

where filename is the name of the Oracle Tuxedo installer file, and path is the full or relative pathname of the installer.properties file.

Note:

If a file named installer.properties is present in the same directory as the installer (for example, tuxedo81_sol.bin), it will be supplied automatically in silent mode. However, if installer.properties is in a different directory, you may use the -f command line option to specify the properties file. For example, filename.exe -f path/installer.properties

5.	To verify that the software installed successfully, see “Performing Post-Installation Tasks” on page 6‑1.

Windows Template File

This sample Windows template file (installer.properties) in Listing 4‑1 applies to a silent installation of Oracle Tuxedo 11g Release 1 (11.1.1.3.0).

Listing 4‑1 Windows installer.properties Template File

INSTALLER_UI=silent
### Locale ###
USER_LOCALE=en
### Oracle Home Directory ###
### NOTE: backslashes must be escaped. ###
ORACLEHOME=c:\\oracle\\tuxedo11gR1
### Product Installation Directory ###
USER_INSTALL_DIR=c:\\oracle\\tuxedo11gR1
### LDAP Service Name ###
LDAP_HOSTNAME=pcwiz.mydomain.com
### LDAP PortID ###
LDAP_PORTID=389
### LDAP BaseObject ###
LDAP_BASE_OBJECT="o=beasys.com"
### LDAP Filter File Location ###
LDAP_FILTER_FILE=c:\\oracle\\tuxedo11gR1\\udataobj\\security\\
bea_ldap_filter.dat
### Default Listen Port, User Can Run ###
### Oracle Tuxedo 11gR1 Administration in ###
### Control Panel to Change to Another Port ###
TLISTEN_PORT=1357
### Tlisten Password ###
TLISTEN_PASSWORD=luckluck
### TLISTEN ENCRYPTION###
ENCRYPT_CHOICE_BOOLEAN_2=0
ENCRYPT_CHOICE_BOOLEAN_1=1
SSL_PNAME=test1
SSL_PLOC=test1.pem
SSL_PPASS=passwd
min_crypt_bits_1=0
min_crypt_bits_2=1
min_crypt_bits_3=0
min_crypt_bits_4=0
max_crypt_bits_1=0
max_crypt_bits_2=0
max_crypt_bits_3=1
max_crypt_bits_4=0
### Valid Install Sets, select one:###
### CHOSEN_INSTALL_SET=Full###
### CHOSEN_INSTALL_SET=Server###
### CHOSEN_INSTALL_SET=Client###
### CHOSEN_INSTALL_SET=ATMI###
### CHOSEN_INSTALL_SET=CORBA###
### CHOSEN_INSTALL_SET=Jolt###
### CHOSEN_INSTALL_SET=DNET###
### NOTE: Spaces should not be included after the install set name. ###
### If there are spaces after the install set name, the installation ###
### process uses the default mode Full Install. ###
CHOSEN_INSTALL_SET=Full Install
### Install Samples Y/N###
INSTALL_SAMPLES=Yes

 

Note:

ENCRYPT_CHOICE_BOOLEAN_1=1: "1" means tlisten supports SSL. ENCRYPT_CHOICE_BOOLEAN_2=1: "1" means tlisten supports LLE. 0 means SSL/LLE is not supported. If one of the encryption methods (SSL or LLE) is set to 1, the other must be set to 0.

min_crypt_bits_1: "1" means min encryption bit 0 is set, "0" not set
min_crypt_bits_2: "1" means min encryption bit 56 is set, "0" not set
min_crypt_bits_3: "1" means min encryption bit 128 is set, "0" not set
min_crypt_bits_4: "1" means min encryption bit 256 is set, "0" not set
One encryption method must be set to 1; the other must be set to 0.

max_crypt_bits_1: "1" means max encryption bit 0 is set, "0" not set
max_crypt_bits_2: "1" means max encryption bit 56 is set, "0" not set
max_crypt_bits_3: "1" means max encryption bit 128 is set, "0" not set
max_crypt_bits_4: "1" means max encryption bit 256 is set, "0" not set
One encryption method must be set to 1; the other must be set to 0.

SSL_PNAME = SECURITY PRINCIPAL NAME

SSL_PLOC = SECURITY PRINCIPAL LOCATION

SSL_PPASS = SECURITY PRINCIPAL PASSWORD

UNIX Template File

This sample UNIX template file (installer.properties) in Listing 4‑2 applies to a silent installation of Oracle Tuxedo 11g Release 1 (11.1.1.3.0).

Listing 4‑2 UNIX installer.properties Template File

INSTALLER_UI=silent
### Locale ###
USER_LOCALE=en
### Oracle Home Directory ###
ORACLEHOME=/home/user/oracle/tuxedo11gR1
### Product Installation Directory ###
USER_INSTALL_DIR=/home/user/oracle/tuxedo11gR1
### LDAP Service Name ###
LDAP_HOSTNAME=pcwiz.mydomain.com
### LDAP PortID ###
LDAP_PORTID=389
### LDAP BaseObject ###
LDAP_BASE_OBJECT="o=beasys.com"
### LDAP Filter File Location ###
LDAP_FILTER_FILE=/home/user/oracle/tuxedo11gR1/udataobj/security/
bea_ldap_filter.dat
### Tlisten Password ###
TLISTEN_PASSWORD=luckluck
### Valid Install Sets, select one:###
### CHOSEN_INSTALL_SET=Full###
### CHOSEN_INSTALL_SET=Server###
### CHOSEN_INSTALL_SET=Client###
### CHOSEN_INSTALL_SET=ATMI###
### CHOSEN_INSTALL_SET=CORBA###
### CHOSEN_INSTALL_SET=Jolt###
### NOTE: Spaces should not be included after the install set name. ###
### If there are spaces after the install set name, the installation ###
### process uses the default mode Full Install. ###
CHOSEN_INSTALL_SET=Full Install
CHOSEN_INSTALL_SET=Full Install
### Install Samples Y/N###
INSTALL_SAMPLES=Yes

 

What Do I Do Next?

To prepare for the post-installation tasks, read the following sections:

•	“Assigning File Ownership on a UNIX System” on page 2‑10

•	“Understanding the Oracle Tuxedo Shortcuts on a Windows System” on page 2‑11

•	“Understanding the Oracle Administration Program on a Windows System” on page 2‑12

•	“Reviewing the Windows Server Registry Content” on page 2‑13

To configure your Oracle Tuxedo software, verify that your software is installed correctly, or to uninstall Oracle Tuxedo software, see “Performing Post-Installation Tasks” on page 6‑1.