This appendix describes how to perform a silent mode installation or deinstallation of Oracle Fail Safe.
The following topics are discussed in this appendix:
A silent mode installation or deinstallation is a mode that lets you install or deinstall software by supplying input to Oracle Universal Installer in a file, rather than through Oracle Universal Installer graphical user interface (GUI).
If you are performing multiple installations or deinstallations of Oracle Fail Safe that are identical or similar to each other, you may want to run Oracle Universal Installer in silent mode to automate the process. You do this by editing a file, called a response file, that is supplied with Oracle Fail Safe.
A response file contains the answers that you typically provide in an interactive installation or deinstallation session. By providing all input in a response file, which you run using the command-line interface or in batch mode, you eliminate the need for direct interaction from the user, and a GUI is not displayed.
To perform a silent installation or deinstallation with a response file, use the command-line mode or a batch script to start Oracle Universal Installer and enable the response file.
A silent installation or deinstallation is the only alternative to using the Oracle Universal Installer GUI; there is no character-mode version of Oracle Universal Installer.
Note:
You cannot use response files to reinstall Oracle Fail Safe. If you need to reinstall Oracle Fail Safe, you must use Oracle Universal Installer interface to perform the reinstallation, or you must first deinstall Oracle Fail Safe and then use response files to install the software again.Three different response file templates are available in the Oracle Fail Safe installation kit. These response files help you to set up Oracle Fail Safe installations and deinstallations in silent mode. Although each template file performs a different type of installation, you can use any one of them to perform a deinstallation.
To perform a silent installation, choose a response file template that corresponds to the desired installation type. The template files are located on the CD-ROM in the \stage\Response directory. Sample response files have also been provided.
The template files, samples, and their corresponding installation types are listed in the following table:
| Template Name | Sample Name | Installation Type |
|---|---|---|
oracle.failsafe.complete.typical.rsp |
failsafe.typical.rsp |
Typical installationFoot 1 |
oracle.failsafe.complete.client.rsp |
failsafe.client.rsp |
Client Only installation |
oracle.failsafe.complete.custom.rsp |
failsafe.custom.rsp |
Custom installation |
Footnote 1 The Typical installation type installs all of the Oracle Fail Safe components.
During an installation or deinstallation session, Oracle Universal Installer retrieves and uses values from the response file according to the conditions described in the following list:
If the response file does not contain values for one or more required variables, then Oracle Universal Installer stops the installation or deinstallation.
If any variable that is specified in the response file contains invalid content, format, or type value, then Oracle Universal Installer ignores the specified value.
If any variable is specified outside of a response file section, then Oracle Universal Installer ignores the variable.
When you perform a silent installation or deinstallation, the success or failure of the operation is recorded in a file named silentInstall.log. The file is located in the Oracle installation log area, such as C:\Program Files\Oracle\Inventory\logs.
Oracle Universal Installer does not write to the log file until after the silent installation or deinstallation has completed.
The following steps describe how to customize the variables in a response file and enable Oracle Universal Installer to use the file for a silent mode installation or deinstallation.
Make a copy of the original response file templates (located on the CD-ROM in the \stage\Response directory) to use as the basis for your response file. Retain the original files for use as templates.
You might want to make several copies of a response file, each with a different purpose, and specify a different name for each one. For example, you might have a response file named failsafemanager.rsp that performs only Oracle Fail Safe Manager installations.
Edit the response file to specify options for your Oracle Fail Safe installation.
Note:
Before editing the response file, read Section B.3, which contains important information about editing the variables in the response file.The response file templates contain all of the Oracle Fail Safe installation variables for the corresponding installation type. There are variables that specify the name of the Oracle home where you want to install Oracle Fail Safe, the installation type (Typical, Custom, or Client Only), and the account user name and password for the Oracle Fail Safe service. You can use any one of the response file templates for a deinstallation.
In the response files, each variable is documented using comment lines that begin with a number sign (#). The comments contain information about the type of the variable, whether the variable is displayed in a dialog box, and the function of the variable.
The following sections describe how to perform the installations or a deinstallation. Except where noted, the variables respond in the same way, in each of the response file templates. The variables used in the following sections are also documented in Table B-1, Table B-2, and Table B-3.
For All Installation Types: Edit the following variables to specify the name of the Oracle home where you want to install Oracle Fail Safe:
For a Typical Installation: To install all Oracle Fail Safe components:
Use the oracle.failsafe.complete.typical.rsp response file template.
Locate the INSTALL_TYPE variable in the [oracle.failsafe.complete_3.4.2.0.0] Component section and make sure the value is INSTALL_TYPE="Typical". (This is the default setting.)
Locate the DomainUserName and Pwd variables at the end of the file. Edit these variables with the account domain, user name, and password needed by Oracle Fail Safe.
For a Client Only Installation: To install Oracle Fail Safe Manager only:
Use the oracle.failsafe.complete.client.rsp response file template.
Locate the INSTALL_TYPE variable in the [oracle.failsafe.complete_3.4.2.0.0] Component section and ensure that the value is INSTALL_TYPE="install_type_1". (This is the default value.)
For a Custom Installation: To perform a customized installation of Oracle Fail Safe:
Use the oracle.failsafe.complete.custom.rsp response file template.
Locate the INSTALL_TYPE variable in the [oracle.failsafe.complete_3.4.2.0.0] Component section and make sure the value is INSTALL_TYPE="Custom" (this is the default value).
Locate the DomainUserName and Pwd variables at the end of the file. Edit these variables with the account domain, user name, and password needed by Oracle Fail Safe.
Specify the components to be installed in the DEPENDENCY_LIST variable.
For a Deinstallation: To perform a deinstallation:
Use any one of the response file templates.
Update the variables described in Table B-2. These are the only variables of concern for a deinstallation.
On each system where you want to install or deinstall Oracle Fail Safe, run Oracle Universal Installer using the following command syntax at the command-line prompt or in a batch file:
E:\stage\Disk1\install\setup.exe -responseFile filename -silent [-nowelcome | -deinstall]
In the example, E: is the drive letter for the CD-ROM. The following list explains the syntax in the command line:
-responseFile indicates that you are supplying a response file for this installation.
filename specifies the full path name of the response file that you want to use to provide input to Oracle Universal Installer.
-silent indicates that you want to run Oracle Universal Installer in silent mode.
-nowelcome is an optional command parameter that suppresses the welcome dialog box that is displayed during an installation.
-deinstall specifies that the response file is to be used for a deinstallation. If this qualifier is not specified, then an installation is assumed.
The Oracle Fail Safe silent installation and deinstallation are case-sensitive. You must enter all command-line syntax exactly as shown in this chapter (for example, the -responseFile parameter must be entered using all lowercase characters, except for the F). You must enter the file specification by using the case shown in Microsoft Windows Explorer (for example, C:\Ofs\Silent_Install\OfsProducts.rsp).
The following command performs an Oracle Fail Safe installation in silent mode by reading all required installation information from the failsafe.rsp file:
E:\stage\Disk1\install\setup.exe -responseFile C:\failsafe.rsp -silent -nowelcome
The following command performs an Oracle Fail Safe deinstallation in silent mode by reading the deinst_failsafe.rsp file:
E:\stage\Disk1\install\setup.exe -responseFile C:\deinst_failsafe.rsp -silent -deinstall
Because the response file for an installation specifies the domain, user name, and password information in the DomainUserName and Pwd variables, ensure that you either delete the response file for an installation or move it to a secure location on your system after the installation is completed.
The next three sections in this appendix describe the contents of the response file templates that are provided with Oracle Fail Safe. Edit the variables in your copy of the file to contain the responses you would need to provide during the Oracle Fail Safe installation session. Use the following format when you specify values for variables in the response file:
variable name = recommendation : value
Set the variable name and value parameters as described in Table B-1, Table B-2, and Table B-3. Set the optional recommendation variable to either Forced or Default, as follows:
Forced: does not display the setting for the value parameter during installation or deinstallation; the user cannot change any variable values during the silent installation or deinstallation.
Default: displays the default setting for the value parameter during the installation or deinstallation and allows the user to choose another value.
Each response file contains at least three sections: General, Session, and one or more Component sections. Each section begins with a line that specifies the section name in brackets (for example, the General section begins with [General]).
Note:
Use a response file only to perform silent installations or deinstallations for Oracle Fail Safe. Do not use the response files that are provided with Oracle Fail Safe to install or deinstall any other products.The General section is an informational section that contains the version number of the response file. There is only one General section for each response file. For example:
[General] RESPONSEFILE_VERSION=2.2.1
Do not edit information in the General section.
The Session section lists predefined (generic) dialogs for Oracle Universal Installer and shows whether the dialogs are visible to the user.
The Session section also lists global variables that are set during one installation or deinstallation session (from the start of the installation or deinstallation to the end of installation or deinstallation). These variables include top-level components and languages.
If you are performing an installation, then the variables used only for deinstallation are ignored. Similarly, if you are performing a deinstallation, then the variables used only for installation are ignored. For example, if you specify -deinstall on the command line, then any value you have set for the FROM_LOCATION variable is ignored.
Note:
When you specify the-silent qualifier on the command line, none of the installation (or deinstallation) dialog boxes are displayed, regardless of the variable settings in this section.
The only variables that are used during an installation when you specify the -silent qualifier are the following:
FROM_LOCATION
FROM_LOCATION_CD_LABEL
ORACLE_HOME
ORACLE_HOME_NAME
TOPLEVEL_COMPONENT
The only variables that are used during an deinstallation when you specify the -silent qualifier are the following:
DEINSTALL_LIST
ORACLE_HOME
ORACLE_HOME_NAME
Table B-1 provides a list of the variables in the Session section that can be used in a silent mode installation.
Table B-2 provides a list of the variables in the Session section that can be used in a silent mode deinstallation.
Table B-1 Variables for the Session Section for a Silent Mode Installation
| Variable Name | Value | Type | Required? |
|---|---|---|---|
|
Specifies the "From" location in the installer, which is a directory path containing the source of the products to be installed. |
String |
Yes |
|
|
Specifies the label of the CD-ROM where the products.jar file exists. The label can be found in the file "disk.label" in the same directory as products.jar. This variable should be used only in multi-CD-ROM installations. |
String |
No |
|
|
Specifies whether or not you will be permitted to go back to the File Locations page for another installation. If you want to process another response file, this flag must be set to |
Boolean |
No |
|
|
Specifies whether or not you will be permitted to run another session even if the current installation has failed. This variable is active only if |
Boolean |
Yes |
|
|
Specifies the full path of the response file for the next session. If only a file name is specified, the response file is retrieved from the |
String |
No |
|
|
Specifies the "To" location in the installer where products are to be installed. For example, " |
String |
Yes |
|
|
Specifies the name of the current Oracle home. For example, "OracleFailSafe" (use quotation marks). |
String |
Yes |
|
|
Specifies an alternative directory location for the installation. Specify False to prevent the location of the installation directory from being changed. |
Boolean |
No |
|
|
Specifies whether or not the custom tree page in the installer will be displayed during a custom installation, which lets you select or deselect dependencies on the custom tree page. Set the value to True if you want to show the custom tree page in the installer and allow dependencies to be selected or deselected. Specify False to suppress it. |
Boolean |
No |
|
|
Specifies whether or not the installation success/failure page will be displayed at the end of an installation. Set the value to True to show the page. Specify False to suppress it. |
Boolean |
Yes |
|
|
Specifies whether or not confirmation is shown when exiting the installer. Specify True to display confirmation. Specify False to suppress it. |
Boolean |
No |
|
|
Specifies whether or not the current status (including which product is being installed and which file is being copied) is displayed during the installation. Set the value to True to show the current status. Specify False to suppress it. |
Boolean |
No |
|
|
Specifies whether or not the release notes available for the products just installed will be displayed. Set to True to show the release notes at the end of the installation. Specify False to suppress the display of the release notes. |
Boolean |
No |
|
|
Specifies whether or not the required configuration tools that are a part of this installation, including the status of each tool and any tool failures that were detected, are displayed. Set the value to True to show the display. Specify False to suppress it. |
Boolean |
No |
|
|
Not applicable (NA). |
NA |
NA |
|
|
Specifies whether or not the splash screen for Oracle Universal Installer will be displayed. Set to true to display the initial splash screen for the Oracle Universal Installer. Set to false to suppress the display. |
Boolean |
No |
|
|
Specifies whether or not to display the summary page, which lists the components that will be installed in this session. Set this value to true to display the summary page. Specify false to suppress it. |
Boolean |
Yes |
|
|
Specifies whether or not to display the welcome page. Set to true to display the welcome page. Specify false to suppress it. |
Boolean |
No |
|
|
Specifies the name of the Oracle Fail Safe component and version as a string list. Specify the components as a pair of strings: The first one represents the internal name and the second represents the version. For example, {"oracle.failsafe.complete","3.4.2.0.0"}. |
Stringlist |
Yes |
Table B-2 Variables for the Session Section for a Silent Mode Deinstallation
| Variable Name | Value | Type | Required? |
|---|---|---|---|
|
Specifies the list of components to be deinstalled. To deinstall all Oracle Fail Safe components, specify: {"oracle.failsafe.complete", "3.4.2.0.0"} |
Stringlist |
Yes |
|
|
Specifies the location in the installer where the Oracle Fail Safe product is currently installed. For example, " |
String |
Yes |
|
|
Specifies the name of the current Oracle home. For example, "OracleFailSafe" (use quotation marks). |
String |
Yes |
|
|
Specifies whether or not to confirm deinstallation during a deinstallation session. Set to true to confirm deinstallation. Set to false to suppress confirmation. |
Boolean |
No |
|
|
Specifies whether or not to display deinstallation progress during a deinstallation session. Set to true to display deinstallation progress. Set to false to suppress it. |
Boolean |
No |
The response file can contain one or more of the following Oracle Fail Safe component sections:
To find a value for a variable, Oracle Universal Installer checks the appropriate component section to which the variable belongs. For an installation, all variables are required for the files in which they appear. For a deinstallaion, none of the component section variables are used.
Table B-3 describes the variables in the component section.
Table B-3 Variables for the Component Section for a Silent Mode Installation
| Variable Name | Value | Type |
|---|---|---|
|
Enter the domain and user name for an account (entered as domain\username) that has Administrator privileges. For example: DomainUserName="OFSDomain\smith" This variable appears in response files for Custom and Typical installations. |
String |
|
|
Enter the password for the account you specified with the DomainUserName variable. For example: Pwd="myadminpassword" This variable appears in response files for Custom and Typical installations. |
String |
|
|
Enter the dependent components that you want to install with Oracle Fail Safe. You specify the list of components using an internal name and version number. For example, the value can contain any combination of the following components:
DEPENDENCY_LIST=
"oracle.failsafe.manager","3.4.2.0.0",
{"oracle.failsafe.server","3.4.2.0.0",
"oracle.mscs.server","3.4.2.0.0",
"oracle.mscs.common:3.4.2.0.0",
"oracle.failsafe.doc:3.4.2.0.0",
"oracle.swd.oui:11.2.0.0.0"}
This variable appears in response files for only the Custom installation. |
Stringlist |
|
|
Enter the internal name for only one of the following installation types: For example: This variable appears in all response files. |
String |
|
|
Enter the security configuration tool to be started when you install Oracle Services for MSCS. Specify it using the internal name and external name, as follows:
OPTIONAL_CONFIG_TOOLS={"configtool1"}
This variable appears in response files only for the Typical installation. |
Stringlist |