Table of Contents Previous Next PDF


Installing Oracle Tuxedo Message Queue Using Silent Installation

Installing Oracle Tuxedo Message Queue Using Silent Installation
The following sections describe how to install Oracle Tuxedo Message Queue using silent installation on both Windows and UNIX systems:
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.
Using Silent Installation: Main Steps
Creating a Response File
You can create a new response file, based on the installation options you select, by using the OUI record mode.
When you use record mode, OUI records the installation session to a response file. You specify the name of the response file on the command line. The recorded response file is generated immediately after the Summary page; you do not need to actually install your Oracle product to create the response file. That is, you can start the installation in Record mode and proceed through the installation options until you get to the Summary page. On the Summary Page, click Exit to stop the installation from proceeding with the installation. However, all the options you selected are saved in the resulting response file.
You can use the newly created response file to run identical installation sessions on other computers in your organization.
Record mode can be also used during a silent installation. In this case, the variable values specified in the original source response file will be recorded to the new response file.
The following sections describe how to use record mode on Windows and UNIX systems.
Using Record Mode
To record a new response file:
1.
At the command prompt, use the cd command to change to the directory that contains the OUI executable file (setup.exe or runInstaller.sh) for your installation.
2.
On Windows:
setup -record -destinationFile <response_file_name>
On UNIX:
./runInstaller -record -destinationFile <response_file_name>
Replace the <response_file_name> with the complete path for the new response file. For example:
On Windows:
setup -record -destinationFile C:\response_files\install_oracle11g.rsp
On UNIX:
./runInstaller -record -destinationFile /private/temp/install_oracle11g.rsp
3.
When OUI displays the Summary page, you can either continue with the installation or exit.
OUI saves your new response file using the path and file name you specified on the command line.
Required Variables in Oracle Tuxedo Message Queue Response File
The variables defined in this section are specific for Oracle Tuxedo Message Queue installer.
Note:
RESPONSEFILE_VERSION
The format version number of the response file. You must enter as follows.
RESPONSEFILE_VERSION=2.2.1.0.0
ORACLE_HOME
The location where products are to be installed. You must enter a value for ORACLE_HOME for a complete silent installation.
ORACLE_HOME_NAME
The name of the current Oracle home. You must enter a value for ORACLE_HOME_NAME for a complete silent installation.
INSTALL_TYPE
You can set the installation type variable to determine the installation type of the currently selected top level component. Install_type can be selected from below table:
 
For more information, see “Install Types”.
INSTALL_SAMPLES
Configures whether to install samples for Oracle Tuxedo Message Queue products.
Set INSTALL_SAMPLES=true to install samples for Oracle Tuxedo Message Queue products.
CONFIG_TLISTEN
Configures the tlisten parameters during installation. Set this variable to true.
ENCRYPT_CHOICE (Windows)
Configures encryption method, 0 is LLE, 1 is SSL.
If CONFIG_TLISTEN=true, ENCRYPT_CHOICE must be set.
TLISTEN_PASSWORD
Configures tlisten password.
If CONFIG_TLISTEN=true, TLISTEN_PASSWORD must be set.
TLISTEN_PORT (Windows)
Configures tlisten port.
If CONFIG_TLISTEN=true, TLISTEN_PORT must be set.
SSL_PARAMETERS (Windows)
Configures tlisten SSL Parameters Security Principal (Name, Location, Password).
If ENCRYPT_CHOICE=1, SSL_PARAMETERS must be set.
MIN_ENCRYPT_BITS (Windows)
Configures Min Encryption Bits.
MIN_ENCRYPT_BITS must be set.
MAX_ENCRYPT_BITS (Windows)
Configures Max Encryption Bits.
If CONFIG_TLISTEN=true, MAX_ENCRYPT_BITS must be set.
LDAP_SUPPORT_SSL
Configures LDAP support for SSL.
LDAP_CONFIG
Configures LDAP parameters (Service Name, PortID, BaseObject)
If LDAP_SUPPORT_SSL= true, LDAP_CONFIG must be set.
LDAP_FILTER_FILE
Configures LDAP filter file.
If LDAP_SUPPORT_SSL= true, LDAP_CONFIG must be set.
Installing with a Response File
Many Oracle software products provide tools and procedures for running OUI from the command line without displaying OUI screens or responding to questions during the installation.
This is called silent installation.
Instead of prompting you to select a series of installation options, OUI installs the software using a predefined set of options. These options are stored in a response file (.rsp).
Note:
For more information, see “Oracle Universal Installer Inventory” on page 1‑3.
Specifying a Response File
To start OUI and specify the response file, enter the following command on the command line in the directory where the executable file is installed:
On Windows:
setup.exe -responseFile <filename> <optional_parameters>
On UNIX:
./runInstaller -responseFile <filename> <optional_parameters>
Notes:
You must specify the complete responseFile path. If you do not, OUI assumes the location is relative to the oraparam.ini file associated with the launched OUI.
For help on command line usage, enter the following on the command line in the directory where the executable file is stored:
On Windows:
setup –help
On UNIX:
./runInstaller –help
In Windows, when you execute setup -help, a new command window appears displaying the "Preparing to launch..." message. A moment later, the help information appears in that window.
Optional Parameters When Specifying a Response File
Optional parameters you can use with the -responseFile flag are:
-nowelcome - Use the -nowelcome flag with the -responseFile flag to suppress the Welcome dialog that appears during installation.
-silent - Use the -silent flag with the -responseFile flag to run OUI in complete silent mode. Note that the Welcome dialog is suppressed automatically.
-waitforcompletion - Use the -waitforcompletion flag with -silent flag to wait for completion instead of spawning the java engine and exiting.
In a file named silentInstall<timestamp>.log for hosts without an Oracle inventory. This file is generated in the /tmp directory on UNIX and the directory specified by the TEMP variable on Windows platforms.
Note:
Using the -nowelcome option with the -silent option is unnecessary since the Welcome screen does not appear when you use the -silent option.
UNIX Template File
This sample UNIX response file (installer.properties) in Listing 3‑1 applies to a silent installation of Oracle Tuxedo Message Queue 12c Release 2 (12.1.3).
Listing 3‑1 UNIX response File
####################################################################
## Copyright (c) 1999, 2014 Oracle. All rights reserved. ##
## ##
## Specify values for the variables listed below to customize ##
## your installation. ##
## ##
## Each variable is associated with a comment. The comment ##
## identifies the variable type. ##
## ##
## Please specify the values in the following format: ##
## ##
## Type Example ##
## String "Sample Value" ##
## Boolean True or False ##
## Number 1000 ##
## StringList {"String value 1","String Value 2"} ##
## ##
## The values that are given as <Value Required> need to be ##
## specified for a silent installation to be successful. ##
## ##
## ##
## This response file is generated by Oracle Software ##
## Packager. ##
####################################################################
 
 
RESPONSEFILE_VERSION=2.2.1.0.0
 
#-------------------------------------------------------------------------
#Name : UNIX_GROUP_NAME
#Datatype : String
#Description: Unix group to be set for the inventory directory. Valid only in Unix platforms.
#Example: UNIX_GROUP_NAME = "install"
#-------------------------------------------------------------------------
UNIX_GROUP_NAME="cr0208"
 
#-------------------------------------------------------------------------
#Name : FROM_LOCATION
#Datatype : String
#Description: Complete path to the products.xml.
#Example: FROM_LOCATION = "../stage/products.xml"
#-------------------------------------------------------------------------
FROM_LOCATION="/nfs/ucfhomes/beadev/OTMQ12cR2/installers/Disk1/stage/products.xml"
 
#-------------------------------------------------------------------------
#Name : FROM_LOCATION_CD_LABEL
#Datatype : String
#Description: This variable should only be used in multi-CD installations. It includes the label of the compact disk where the file "products.xml" exists. The label can be found in the file "disk.label" in the same directory as products.xml.
#Example: FROM_LOCATION_CD_LABEL = "CD Label"
#-------------------------------------------------------------------------
FROM_LOCATION_CD_LABEL=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : ORACLE_HOME
#Datatype : String
#Description: Complete path of the Oracle Home.
#Example: ORACLE_HOME = "C:\OHOME1"
#-------------------------------------------------------------------------
ORACLE_HOME="/scratch/beadev/OraHome_2"
 
#-------------------------------------------------------------------------
#Name : ORACLE_BASE
#Datatype : String
#Description: Complete path of the Oracle Base.
#Example: ORACLE_BASE = "C:\app"
#-------------------------------------------------------------------------
ORACLE_BASE=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : ORACLE_HOME_NAME
#Datatype : String
#Description: Oracle Home Name. Used in creating folders and services.
#Example: ORACLE_HOME_NAME = "OHOME1"
#-------------------------------------------------------------------------
ORACLE_HOME_NAME="OraHome2"
 
#-------------------------------------------------------------------------
#Name : SHOW_WELCOME_PAGE
#Datatype : Boolean
#Description: Set to true if the Welcome page in OUI needs to be shown.
#Example: SHOW_WELCOME_PAGE = false
#-------------------------------------------------------------------------
SHOW_WELCOME_PAGE=true
 
#-------------------------------------------------------------------------
#Name : SHOW_CUSTOM_TREE_PAGE
#Datatype : Boolean
#Description: Set to true if the custom tree page in OUI needs to be shown.
#Use this page to select or de-select dependencies. This page appears only in a custom install type.
#Example: SHOW_CUSTOM_TREE_PAGE = false
#-------------------------------------------------------------------------
SHOW_CUSTOM_TREE_PAGE=true
 
#-------------------------------------------------------------------------
#Name : SHOW_COMPONENT_LOCATIONS_PAGE
#Datatype : Boolean
#Description: Set to true if the component locations page in OUI needs to be shown.
#This page only appears if there are products whose installed directory can be changed.
#If you set this to false you will prevent the user from being able to specify alternate directories.
#Example: SHOW_COMPONENT_LOCATIONS_PAGE = false
#-------------------------------------------------------------------------
SHOW_COMPONENT_LOCATIONS_PAGE=true
 
#-------------------------------------------------------------------------
#Name : SHOW_SUMMARY_PAGE
#Datatype : Boolean
#Description: Set to true if the summary page in OUI needs to be shown.
#The summary page shows the list of components that will be installed in this session.
#Example: SHOW_SUMMARY_PAGE = true
#-------------------------------------------------------------------------
SHOW_SUMMARY_PAGE=true
 
#-------------------------------------------------------------------------
#Name : SHOW_INSTALL_PROGRESS_PAGE
#Datatype : Boolean
#Description: Set to true if the install progress page in OUI needs to be shown.
#This page shows the current status in the installation. The current status includes the product being installed and the file being copied.
#Example: SHOW_INSTALL_PROGRESS_PAGE = true
#-------------------------------------------------------------------------
SHOW_INSTALL_PROGRESS_PAGE=true
 
#-------------------------------------------------------------------------
#Name : SHOW_REQUIRED_CONFIG_TOOL_PAGE
#Datatype : Boolean
#Description: Set to true if the required config assistants page in OUI needs to be shown.
#This page shows the list of required configuration assistants that are part of this installation.
#It shows the status of each assistant, including any failures with detailed information on why it failed.
#Example: SHOW_REQUIRED_CONFIG_TOOL_PAGE = true
#-------------------------------------------------------------------------
SHOW_REQUIRED_CONFIG_TOOL_PAGE=true
 
#-------------------------------------------------------------------------
#Name : SHOW_CONFIG_TOOL_PAGE
#Datatype : Boolean
#Description: Set to true if the config assistants page in OUI needs to be shown.
#This page shows the list of configuration assistants that are part of this installation and are configured to launch automatically.
#It shows the status of each assistant, including any failures with detailed information on why it failed.
#Example: SHOW_CONFIG_TOOL_PAGE = true
#-------------------------------------------------------------------------
SHOW_CONFIG_TOOL_PAGE=true
 
#-------------------------------------------------------------------------
#Name : SHOW_RELEASE_NOTES
#Datatype : Boolean
#Description: Set to true if the release notes of this installation need to be shown at the end of installation.
#This dialog is launchable from the End of Installation page and shows the list of release notes available for the products just installed.
# This also requires the variable SHOW_END_SESSION_PAGE variable to be set to true.
#Example: SHOW_RELEASE_NOTES = true
#-------------------------------------------------------------------------
SHOW_RELEASE_NOTES=true
 
#-------------------------------------------------------------------------
#Name : SHOW_ROOTSH_CONFIRMATION
#Datatype : Boolean
#Description: Set to true if the Confirmation dialog asking to run the root.sh script in OUI needs to be shown.
#Valid only for Unix platforms.
#Example: SHOW_ROOTSH_CONFIRMATION = true
#-------------------------------------------------------------------------
SHOW_ROOTSH_CONFIRMATION=true
 
#-------------------------------------------------------------------------
#Name : SHOW_END_SESSION_PAGE
#Datatype : Boolean
#Description: Set to true if the end of session page in OUI needs to be shown.
#This page shows if the installation is successful or not.
#Example: SHOW_END_SESSION_PAGE = true
#-------------------------------------------------------------------------
SHOW_END_SESSION_PAGE=true
 
#-------------------------------------------------------------------------
#Name : SHOW_EXIT_CONFIRMATION
#Datatype : Boolean
#Description: Set to true if the confirmation when exiting OUI needs to be shown.
#Example: SHOW_EXIT_CONFIRMATION = true
#-------------------------------------------------------------------------
SHOW_EXIT_CONFIRMATION=true
 
#-------------------------------------------------------------------------
#Name : NEXT_SESSION
#Datatype : Boolean
#Description: Set to true to allow users to go back to the File Locations page for another installation. This flag also needs to be set to true in order to process another response file (see NEXT_SESSION_RESPONSE).
#Example: NEXT_SESSION = true
#-------------------------------------------------------------------------
NEXT_SESSION=false
 
#-------------------------------------------------------------------------
#Name : NEXT_SESSION_ON_FAIL
#Datatype : Boolean
#Description: Set to true to allow users to invoke another session even if current install session has failed. This flag is only relevant if NEXT_SESSION is set to true.
#Example: NEXT_SESSION_ON_FAIL = true
#-------------------------------------------------------------------------
NEXT_SESSION_ON_FAIL=true
 
#-------------------------------------------------------------------------
#Name : NEXT_SESSION_RESPONSE
#Datatype : String
#Description: Set to true to allow users to go back to the File Locations page for another installation. This flag also needs to be set to true in order to process another response file (see NEXT_SESSION_RESPONSE).
#Example: NEXT_SESSION_RESPONSE = "nextinstall.rsp"
#-------------------------------------------------------------------------
NEXT_SESSION_RESPONSE=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : DEINSTALL_LIST
#Datatype : StringList
#Description: List of components to be deinstalled during a deinstall session.
#Example: DEINSTALL_LIST = {"otmq.top","12.1.3.0.0"}
#-------------------------------------------------------------------------
DEINSTALL_LIST={"otmq.top","12.1.3.0.0"}
 
#-------------------------------------------------------------------------
#Name : SHOW_DEINSTALL_CONFIRMATION
#Datatype : Boolean
#Description: Set to true if deinstall confirmation is needed during a deinstall session.
#Example: SHOW_DEINSTALL_CONFIRMATION = true
#-------------------------------------------------------------------------
SHOW_DEINSTALL_CONFIRMATION=true
 
#-------------------------------------------------------------------------
#Name : SHOW_DEINSTALL_PROGRESS
#Datatype : Boolean
#Description: Set to true if deinstall progress is needed during a deinstall session.
#Example: SHOW_DEINSTALL_PROGRESS = true
#-------------------------------------------------------------------------
SHOW_DEINSTALL_PROGRESS=true
 
#-------------------------------------------------------------------------
#Name : CLUSTER_NODES
#Datatype : StringList
#Description: This variable represents the cluster node names selected by the user for installation.
#Example: CLUSTER_NODES = {"node1","node2"}
#-------------------------------------------------------------------------
CLUSTER_NODES={}
 
#-------------------------------------------------------------------------
#Name : ACCEPT_LICENSE_AGREEMENT
#Datatype : Boolean
#Description: By setting this variable to true, you are accepting the license agreement. This variable is used only for silent installations.
#Example: ACCEPT_LICENSE_AGREEMENT = true
#-------------------------------------------------------------------------
ACCEPT_LICENSE_AGREEMENT=false
 
#-------------------------------------------------------------------------
#Name : METALINK_LOCATION
#Datatype : String
#Description: This variable represents the Oracle metalink location.
#-------------------------------------------------------------------------
METALINK_LOCATION=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : METALINK_USERNAME
#Datatype : String
#Description: This variable represents the Oracle metalink user name.
#-------------------------------------------------------------------------
METALINK_USERNAME=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : METALINK_PASSWORD
#Datatype : String
#Description: This variable represents the corresponding Oracle metalink password.
#-------------------------------------------------------------------------
METALINK_PASSWORD=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : PROXY_HOST
#Datatype : String
#Description: The proxy host used to connect to Oracle metalink.
#Example: PROXY_HOST =
#-------------------------------------------------------------------------
PROXY_HOST=""
 
#-------------------------------------------------------------------------
#Name : PROXY_PORT
#Datatype : String
#Description: The proxy port used to connect to Oracle metalink.
#Example: PROXY_PORT =
#-------------------------------------------------------------------------
PROXY_PORT=""
 
#-------------------------------------------------------------------------
#Name : PROXY_REALM
#Datatype : String
#Description: The realm for the proxy used to connect to Oracle metalink.
#Example: PROXY_REALM =
#-------------------------------------------------------------------------
PROXY_REALM=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : PROXY_USER
#Datatype : String
#Description: The username for the proxy used to connect to Oracle metalink.
#Example: PROXY_USER =
#-------------------------------------------------------------------------
PROXY_USER=""
 
#-------------------------------------------------------------------------
#Name : PROXY_PWD
#Datatype : String
#Description: The password for the proxy used to connect to Oracle metalink.
#Example: PROXY_PWD =
#-------------------------------------------------------------------------
PROXY_PWD=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : DONT_PROXY_FOR
#Datatype : String
#Description: The dont proxy for list.
#Example: DONT_PROXY_FOR =
#-------------------------------------------------------------------------
DONT_PROXY_FOR=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : TOPLEVEL_COMPONENT
#Datatype : StringList
#Description: The top level component to be installed in the current session.
#Example: TOPLEVEL_COMPONENT = {"otmq.top","12.1.3.0.0"}
#-------------------------------------------------------------------------
TOPLEVEL_COMPONENT={"otmq.top","12.1.3.0.0"}
 
#-------------------------------------------------------------------------
#Name : SHOW_SPLASH_SCREEN
#Datatype : Boolean
#Description: Set to true if the initial splash screen in OUI needs to be shown.
#Example: SHOW_SPLASH_SCREEN = true
#-------------------------------------------------------------------------
SHOW_SPLASH_SCREEN=true
 
#-------------------------------------------------------------------------
#Name : SELECTED_LANGUAGES
#Datatype : StringList
#Description: Languages in which the components will be installed.
#Component : otmq.top
#-------------------------------------------------------------------------
 
SELECTED_LANGUAGES={"en"}
 
#-------------------------------------------------------------------------
#Name : COMPONENT_LANGUAGES
#Datatype : StringList
#Description: Languages supported by this component.List of supported languages : {"en","ja"}
#Component : otmq.top
#-------------------------------------------------------------------------
 
COMPONENT_LANGUAGES={"en"}
 
#-------------------------------------------------------------------------
#Name : INSTALL_TYPE
#Datatype : String
#Description: Installation type of the component.
#Component : otmq.top
#-------------------------------------------------------------------------
 
INSTALL_TYPE="Standalone installation"
 
#-------------------------------------------------------------------------
#Name : TLISTEN_PORT
#Datatype : String
#Description: This variable is for configure tlisten port
#Component : tuxedoServerBase
#-------------------------------------------------------------------------
 
TLISTEN_PORT="3050"
 
#-------------------------------------------------------------------------
#Name : INSTALL_SAMPLES
#Datatype : Boolean
#Description: This variable is for configure whether need to install Tuxedo samples
#Component : tuxedoServerBase
#-------------------------------------------------------------------------
 
INSTALL_SAMPLES=true
 
#-------------------------------------------------------------------------
#Name : ENCRYPT_CHOICE
#Datatype : Number
#Description: This variable is for configure encrypt method, 0 is LLE, 1 is SSL.
#Component : tuxedoServerBase
#-------------------------------------------------------------------------
 
ENCRYPT_CHOICE=0
 
#-------------------------------------------------------------------------
#Name : CONFIG_TLISTEN
#Datatype : Boolean
#Description: To configure the tlisten parameters at installation phase, set this variable to true.
#Component : tuxedoServerBase
#-------------------------------------------------------------------------
 
CONFIG_TLISTEN=true
 
#-------------------------------------------------------------------------
#Name : TLISTEN_PASSWORD
#Datatype : String
#Description: This variable is for configure tlisten password
#Component : tuxedoServerBase
#-------------------------------------------------------------------------
 
TLISTEN_PASSWORD=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : SSL_PARAMETERS
#Datatype : StringList
#Description: This variable is for configure SSL Parameters Security
#Principal (Name, Location, Password)
#Component : tuxedoServerBase
#-------------------------------------------------------------------------
 
SSL_PARAMETERS=<Value Unspecified>
 
#-------------------------------------------------------------------------
#Name : MIN_CRYPT_BITS_CHOOSE
#Datatype : Number
#Description: This variable is for configure Min Encryption Bits,
#for LLE:
#0 means max encryption bit set to 0 ,
#1 means max encryption bit set to 56 ,
#2 means max encryption bit set to 128,
#3 means max encryption bit set to 256.
#
#for SSL:
#0 means max encryption bit set to 112 ,
#1 means max encryption bit set to 128 ,
#2 means max encryption bit set to 256
#Component : tuxedoServerBase
#-------------------------------------------------------------------------
 
MIN_CRYPT_BITS_CHOOSE=0
 
#-------------------------------------------------------------------------
#Name : MAX_CRYPT_BITS_CHOOSE
#Datatype : Number
#Description: This variable is for configure Max Encryption Bits,
#
#for LLE:
#0 means max encryption bit set to 0 ,
#1 means max encryption bit set to 56 ,
#2 means max encryption bit set to 128,
#3 means max encryption bit set to 256.
#
#for SSL:
#0 means max encryption bit set to 112 ,
#1 means max encryption bit set to 128 ,
#2 means max encryption bit set to 256
#Component : tuxedoServerBase
#-------------------------------------------------------------------------
 
MAX_CRYPT_BITS_CHOOSE=3
 
#-------------------------------------------------------------------------
#Name : LDAP_SUPPORT_SSL
#Datatype : Boolean
#Description: This variable is for configure LDAP support for SSL
#Component : tuxedoClientCore
#-------------------------------------------------------------------------
 
LDAP_SUPPORT_SSL=true
 
#-------------------------------------------------------------------------
#Name : LDAP_FILTER_FILE
#Datatype : String
#Description: This variable is for configure LDAP filter file
#Component : tuxedoClientCore
#-------------------------------------------------------------------------
 
LDAP_FILTER_FILE="/scratch/beadev/OraHome_2/otmq12.1.3.0.0/udataobj/security/bea_ldap_filter.dat"
 
#-------------------------------------------------------------------------
#Name : LDAP_CONFIG
#Datatype : StringList
#Description: This variable is for configure LDAP parameters(Service Name, PortID, BaseObject)
#Component : tuxedoClientCore
#-------------------------------------------------------------------------
 
LDAP_CONFIG={"1","1","1"}
 
What Do I Do Next?
To configure your Oracle Tuxedo Message Queue software, verify that your software is installed correctly, or to uninstall Oracle Tuxedo Message Queue software, see “Post-Installation”.

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.