Installing Oracle Tuxedo Mainframe Adapter for TCP Using Silent Installation

The following sections describe how to install Oracle Tuxedo Mainframe Adapter for TCP using silent installation on UNIX systems:

•	What Is Silent Installation?

•	Using Silent Installation: Main Steps

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.

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 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 (runInstaller.sh) for your installation.

2.	Enter the following command:

On UNIX:

./runInstaller.sh -record -destinationFile <response_file_name>

Replace the <response_file_name> with the complete path for the new response file. For example:

On UNIX:

./runInstaller.sh -record -destinationFile /private/temp/tmatcp_linux_silent.rsp

3.	Use the OUI user interface to select and record your installation options.

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 Mainframe Adapter for TCP Response File

The variables defined in this section are specific for Tuxedo installer.

Note:

For String type variables, you must contain the value using the double quote.

RESPONSEFILE_VERSION

The format version number of response file.

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.

DEPENDENCY_LIST

List of dependents that need to be installed along with this product.

Example:

DEPENDENCY_LIST={"TMATCP:12.2.2.0.0"}

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:

If you attempt to perform a silent installation on a UNIX computer where no Oracle products have been installed, you will receive an error message. Before you can perform a silent installation in this situation, you must first run the oraInstRoot.sh script located in the /oraInventory directory. You must run this script with root privileges. This enables OUI to set up the Central Inventory on a clean host.

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 UNIX:

./runInstaller.sh -responseFile <filename> <optional_parameters>

Notes:

•	To install Oracle Tuxedo Mainframe Adapter for TCP in complete silent mode, you must specify <optional_parameters> to -silent.

•	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 UNIX:

./runInstaller.sh –help

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.

•	-force - Use the -force flag with the -responseFile flag to suppress the dialog when specifying a new folder for ORACLE_HOME.

•	-waitforcompletion - Use the -waitforcompletion flag with -silent flag to wait for completion instead of spawning the java engine and exiting.

For example, on a UNIX machine, enter the following command:

./runInstaller.sh -responseFile /tma/tmatcp_linux_silent.rsp -silent

Note:

•	Using the -nowelcome option with the -silent option is unnecessary since the Welcome screen does not appear when you use the -silent option.

•	If the ORACLE_HOME is not empty, use the -force option to overwrite it; otherwise, you will get the following error message:

SEVERE:OUI-10029:You have specified a non-empty directory to install this product. It is recommended to specify either an empty or a non-existent directory. You may, however, choose to ignore this message if the directory contains Operating System generated files or subdirectories like lost+found.

Response File Examples

Listing 3‑1 and Listing 3‑2 show response file examples that apply to a silent installation of Oracle Tuxedo Mainframe Adapter for TCP 12c Release 2 (12.2.2).

Listing 3‑1 Example - A Brief Response File

RESPONSEFILE_VERSION=2.2.1.0.0

ORACLE_HOME="/home/test/OraHome_1"

ORACLE_HOME_NAME="OUIHome1"

INSTALL_TYPE="Full"

SAMPLES_SELECT=true

CRM_FOLDER="/home/test/OraHome_1/tuxedo12.2.2.0.0"

 

Listing 3‑2 Example - A Complete Response File

####################################################################

## Copyright (c) 1999, 2013 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="oinstall"

 

#-------------------------------------------------------------------------------

#Name : FROM_LOCATION

#Datatype : String

#Description: Complete path to the products.xml.

#Example: FROM_LOCATION = "../stage/products.xml"

#-------------------------------------------------------------------------------

FROM_LOCATION="/home/test/tma/stage_tma_linux/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="/home/test/OraHome_1"

 

#-------------------------------------------------------------------------------

#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="OUIHome1"

 

#-------------------------------------------------------------------------------

#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 = {"tmabase_tcp","12.2.2.0.0"}

#-------------------------------------------------------------------------------

DEINSTALL_LIST={"tmabase_tcp","12.2.2.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 = {"tmabase_tcp","12.2.2.0.0"}

#-------------------------------------------------------------------------------

TOPLEVEL_COMPONENT={"tmabase_tcp","12.2.2.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 : tmabase_tcp

#-------------------------------------------------------------------------------

 

SELECTED_LANGUAGES={"en"}

 

#-------------------------------------------------------------------------------

#Name : COMPONENT_LANGUAGES

#Datatype : StringList

#Description: Languages supported by this component.List of supported languages : {"en","ja"}

#Component : tmabase_tcp

#-------------------------------------------------------------------------------

 

COMPONENT_LANGUAGES={"en"}

 

#-------------------------------------------------------------------------------

#Name : INSTALL_TYPE

#Datatype : String

#Description: Installation type of the component.

#Component : tmabase_tcp

#-------------------------------------------------------------------------------

 

INSTALL_TYPE="Full"