Installing Oracle TSAM Plus Manager Using Silent Installation

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

•	What Is Silent Installation?

•	Creating a Response File

•	Using Record Mode

•	Installing with a Response File

•	Keyword of Response File

•	Uninstalling Oracle TSAM Plus Manager Using Silent Mode

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.

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.	Enter the following command:

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

Installing with a Response File

When installing in silent mode you must make sure that there is enough disk space and that the login ID has proper permissions to access Oracle inventory directory.

To invoke the silent installation procedure on a Windows system executes the following steps:

1.	Create a file containing the required variables set to valid data.

2.	At a command line prompt go to the directory containing the installer executable.

3.	Enter the following command:

setup.exe -responseFile <filename> <optional_parameters> (on Windows)

./runInstaller -responseFile <filename> <optional_parameters> (on UNIX)

Note:

All Silent options are stored in a response file (.rsp).You must specify the complete responseFile path. If you do not, Oracle Universal Installer assumes the location to be relative to the oraparam.ini associated with the launched Oracle Universal Installer.

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 Oracle Universal Installer 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.

Note:

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

For help on command line usage, enter the following at the command line in the directory where the executable file is stored:

setup -help (on Windows)

./runInstaller -help (on UNIX)

For example, on a UNIX machine, enter:

./runInstaller -responseFile /tsam/tsam_linux_silent.rsp -silent

If the ORACLE_HOME is not empty, please use -force option to overwrite it, or you will get the following error:

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.

Keyword of Response File

OUI Related Keyword

 

Table 3‑1 Optional Keyword

Keyword Name	Datatype	Description
UNIX_GROUP_NAME	String	Unix group to be set for the inventory directory. Valid only in Unix platforms.
FROM_LOCATION	String	Complete path to the products.xml
FROM_LOCATION_CD_LABEL	String	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.
ORACLE_BASE	String	Complete path of the Oracle Base.
SHOW_WELCOME_PAGE	Boolean	Set to true if the Welcome page in OUI needs to be shown.
SHOW_CUSTOM_TREE_PAGE	Boolean	Set to true if the custom tree page in OUI needs to be shown.
SHOW_COMPONENT_LOCATIONS_PAGE	Boolean	Set to true if the component locations page in OUI needs to be shown.
SHOW_SUMMARY_PAGE	Boolean	Set to true if the summary page in OUI needs to be shown.
SHOW_INSTALL_PROGRESS_PAGE	Boolean	Set to true if the install progress page in OUI needs to be shown.
SHOW_REQUIRED_CONFIG_TOOL_PAGE	Boolean	Set to true if the required config assistants page in OUI needs to be shown.
SHOW_CONFIG_TOOL_PAGE	Boolean	Set to true if the config assistants page in OUI needs to be shown.
SHOW_RELEASE_NOTES	Boolean	Set to true if the release notes of this installation need to be shown at the end of installation.
SHOW_ROOTSH_CONFIRMATION	Boolean	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.
SHOW_END_SESSION_PAGE	Boolean	Set to true if the end of session page in OUI needs to be shown.
SHOW_EXIT_CONFIRMATION	Boolean	Set to true if the confirmation when exiting OUI needs to be shown.
NEXT_SESSION	Boolean	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).
NEXT_SESSION_ON_FAIL	Boolean	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.
NEXT_SESSION_RESPONSE	Boolean	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.
DEINSTALL_LIST	StringList	List of components to be deinstalled during a deinstall session. #Example: DEINSTALL_LIST={"TSAM_Manager","12.1.3.0.0"}
SHOW_DEINSTALL_CONFIRMATION	Boolean	Set to true if deinstall confimation is needed during a deinstall session.
SHOW_DEINSTALL_PROGRESS	Boolean	Set to true if deinstall progress is needed during a deinstall session.
CLUSTER_NODES	StringList	This variable represents the cluster node names selected by the user for installation.
ACCEPT_LICENSE_AGREEMENT	Boolean	By setting this variable to true, you are accepting the license agreement. This variable is used only for silent installations.
METALINK_LOCATION	String	This variable represents the Oracle metalink location.
METALINK_USERNAME	String	This variable represents the Oracle metalink user name.
METALINK_PASSWORD	String	This variable represents the corresponding Oracle metalink password.
PROXY_HOST	String	The proxy host used to connect to Oracle metalink.
PROXY_PORT	String	The proxy port used to connect to Oracle metalink.
PROXY_REALM	String	The realm for the proxy used to connect to Oracle metalink.
PROXY_USER	String	The username for the proxy used to connect to Oracle metalink.
PROXY_PWD	String	The password for the proxy used to connect to Oracle metalink.
DONT_PROXY_FOR	String	The dont proxy for list.
TOPLEVEL_COMPONENT	StringList	The top level component to be installed in the current session. #Example: DEPENDENCY_LIST={"TSAM_Manager","12.1.3.0.0"}
SHOW_SPLASH_SCREEN	Boolean	Set to true if the initial splash screen in OUI needs to be shown.
SELECTED_LANGUAGES	StringList	Languages in which the components will be installed.
COMPONENT_LANGUAGES	StringList	Languages supported by this component.List of supported languages : {"en","ja"}

 

Table 3‑2 Required Keyword

Keyword Name	Datatype	Description
RESPONSEFILE_VERSION	String	The format version number of response file.
ORACLE_HOME	String	Complete path of the Oracle Home.
ORACLE_HOME_NAME	String	Oracle Home Name. Used in creating folders and services.

TSAM Plus Manager Related Keyword

 

Table 3‑3 TSAM Plus Manager Related Keyword

Keyword Name	Datatype	Description
OVERWRITE	Boolean	Ask customer Whether to overwrite it if there is already installed TSAM manager product on this ORACLE_HOME. The default value is true.
AUTHEN_TYPE	Number	"Database first" or "LDAP only"? O means "Database first", 1 means "LDAP only", the default value is 0.
LDAP_SELECTION	Boolean	Ask customer Whether to specify LDAP configuration file if AUTHEN_TYPE=0, the default value is false.
LDAP_CONFIG_FILE	String	The full path of LDAP configuration file. It is required if AUTHEN_TYPE=1, or AUTHEN_TYPE=0 && LDAP_SELECTION=true.
DB_TYPE	Number	Choose the database type you will use with TSAM Plus Manager. 0 means "Create a new schema of existing Oracle Database", 1 means "Use existing schema of Oracle Database", 2 means "Use bundled Derby database", 3 means "Use existing Derby database", 4 means "Skip, I will deploy TSAM Plus Manager to an existing database server after the installation". The default value is 0.
DB_CONNECTION	StringList	Database connection parameters. The format is {<Hostname>,<port>,<databaseName>,<Database SYSDBA user>,<Database SYSDBA user password>,<TSAM plus DB user name>,< TSAM plus DB user password>,< TSAM plus DB user tablespace>, < TSAM plus DB user Max DB connection number>}. If DB_TYPE=1, the Database SYSDBA user>,<Database SYSDBA user password>< TSAM plus DB user tablespace>< TSAM plus DB user Max DB connection number> can not set to "". It is required if DB_TYPE=0 or 1. For example, DB_CONNECTION={"bej301153","1521","sol12em12cR3","SYS","SYSPWD","tsam_oui","tsam_oui","USERS","30"}
DB_OVERWRITE	Boolean	If the database type is "An existing Derby database" or "An existing Oracle database", and the TSAM Plus Manager database is already existed under the specified database connection, you need to specify whether to overwrite it. The default value is true.
GIDS	StringList	The parameters of Group IDs. The format is {<administratorGroupID>, <viewerGroupID>}, the defalut vaule is {"0","1"}.
ADM_PWD	String	The password of administrator. It is required.
APP_SRV_TYPE	Number	Choose the application server to which oracle TSAM Plus Manager will be deployed. 0 means "An existing WebLogic server", 1 means "Bundled Tomcat server", 2 means "An existing Tomcat server", 3 means "Skip, I will deploy TSAM Plus Manager to an existing application server after the installation", the default value is 0.
APPSERVERDIR	String	Application Server Directory. It is tomcat server if APP_SRV_TYPE=2, WebLogic server if APP_SRV_TYPE=0. It is required if APP_SRV_TYPE is 0 and 2.
WLS_PARAMETERS	StringList	WebLogic Server connection parameters. The format is {<adminUrl>,<userName>,<password>}. It is required if APP_SRV_TYPE is 0.
TSAM_PROPERTY	StringList	The properties of TSAM Plus Manager, { Max persistence threads Data persistence queue size Busy threshold Timeout shutdown (seconds) Call pattern calculation schedule("DAILY",or "HOURLY") Call pattern calculation delay (minutes) Automatic data purge(true or false) Reserve monitoring data for days}. For example, TSAM_PROPERTY= {"2","5000","500","30","DAILY","10","true","30"}. It is not required if it import configuration file. $ORACLE_HOME/tsam12.1.3.0.0/tsam.properties.
IMPORT_CONFIG	Boolean	Whether to import configuration file, if art.properties, tsam.properties , or persistence.xml is under directory $ORACLE_HOME/tsam12.1.3.0.0. the default value is false.

For more information, see Example of Complete Response File.

Uninstalling Oracle TSAM Plus Manager Using Silent Mode

Not only can you perform command line installations, you can also perform command line deinstallations. A command line deinstallation enables you to remove Oracle products or Oracle homes from your system without using the Oracle Universal Installer graphical user interface.

You can choose to display no dialog boxes or prompts, or you can selectively avoid displaying certain dialog boxes that are normally used during a deinstallation.

Use the following commands to immediately display the Inventory dialog box, which allows you to select items for removal without navigating the Oracle Universal Installer startup screen:

./runInstaller -deinstall -silent (on UNIX)

If you want to hide the inventory dialog box during a deinstallation, you can specify the products to be removed in the DEINSTALL_LIST parameter of the response file; specify Oracle homes to be removed with the REMOVE_HOMES variable; specify the name of the current Oracle home name with ORACLE_HOME_NAME. For example, on a UNIX machine, enter:

./runInstaller -deinstall -silent

"DEINSTALL_LIST={"TSAM_Manager","12.1.3.0.0"}"

ORACLE_HOME_NAME="OUIHome2"

REMOVE_HOMES={"/home/tuxqa/OraHome_2"}