Installing OTMQ Using Silent Installation

The following sections describe how to install Oracle Tuxedo Message Queue (OTMQ) using silent installation on UNIX systems:

•	What Is Silent Installation?

•	Using Silent Installation: Main Steps

•	Creating a Template File

•	Invoking the Silent Installation Process on a UNIX System

•	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 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.

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. A sample template file is provided in UNIX Template File.

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

For the detailed procedure, seeInvoking the Silent Installation Process on a UNIX System.

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 template is available in:

•	UNIX template file content at UNIX Template File.

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=	The mode of installation. The default is silent; do not modify this value.
ORACLEHOME=	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‑4.
USER_INSTALL_DIR=	The full pathname of the product directory of your choice. WARNING: Running a previous Oracle Tuxedo version in conjunction with Oracle Tuxedo 12c Release 1 (12.1.1) on a Windows system requires that the product directories for both versions do not have the same name.
INSTALL_SAMPLES	“yes” installs Oracle Tuxedo 12c samples. “no” does not install samples.
LDAP_HOSTNAME=	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=	The port number through which the local machine communicates with the LDAP server; for example, 389.* (See Note at end of table.)
TLISTEN_PORT	The port number through which the local machine communicates with the TLISTEN server; for example, 1357.
LDAP_BASE_OBJECT=	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=	The full pathname of the LDAP filter file on your machine; for example, C:\oracle\tuxedo12c\udataobj\security\ bea_ldap_filter.dat. (See Note at end of table.)
TLISTEN_PASSWORD=	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 Message Queue 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. • Addon for installing OTMQ on an existing Oracle Tuxedo directory • Stdalone for installing OTMQ and minimal Oracle Tuxedo files For a description of install sets, see “Install Sets” on page 1‑3.

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 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 OTMQ 12c Release 1 (12.1.1) Platform Data Sheets.

2.	Log in to the UNIX system as the Oracle Tuxedo Message Queue administrator.

3.	Ensure that you have enough free space for the Oracle Tuxedo Message Queue installation.

For disk space requirements, see OTMQ 12c Release 1 (12.1.1) Platform Data Sheets. For important disk space allocation information, see File and Database Management and Disk Space Allocation.

4.	Install Oracle Tuxedo Message Queue by downloading from the Oracle FTP site:

a.	Download the Oracle Tuxedo 12c Release 1 (12.1.1) installation file specific to your platform (Message Queue is an Oracle Tuxedo add-on product).

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 Message Queue 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 Post-Installation.

UNIX Template File

This sample UNIX template file (installer.properties) in Listing 4‑1 applies to a silent installation of Oracle Tuxedo Message Queue 12c Release 1 (12.1.1).

Listing 4‑1 UNIX installer.properties Template File

INSTALLER_UI=silent
### Locale ###
USER_LOCALE=en
### Oracle Home Directory ###
ORACLEHOME=/home/user/oracle/otmq12c
### Product Installation Directory ###
USER_INSTALL_DIR=/home/user/oracle/otmq12c1
### 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/otmq12c/udataobj/security/
bea_ldap_filter.dat
### Tlisten Password ###
TLISTEN_PASSWORD=luckluck
### Valid Install Sets, select one:###
### CHOSEN_INSTALL_SET=Stdalone###
### CHOSEN_INSTALL_SET=Addon###
### 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=Stdalone
### Install Samples Y/N###
INSTALL_SAMPLES=Yes

 

What Do I Do Next?

After the successful installation, you can run samples to verify if the software is installed correctly, or uninstall the software. For more information, see Post-Installation..