Skip Headers

Oracle® Fail Safe Installation Guide
Release 3.3.1 for Windows
Part No. A96685-01
Go To Table Of Contents
Contents
Go To Index
Index

Previous Next

B
Performing a Silent Installation

This appendix describes how to automate the Oracle Fail Safe installation by performing a silent installation.

The following topics are discussed in this appendix:

Topic Reference
Introduction to Silent Mode Installations   Section B.1  
Editing and Enabling the Response File   Section B.2  
Contents of a Response File   Section B.3  

B.1 Introduction to Silent Mode Installations

You can install Oracle Fail Safe in silent mode, which is an installation method that allows you to install software by supplying input to Oracle Universal Installer in a file, rather than through the Oracle Universal Installer graphical user interface (GUI).

If you are performing multiple installations that are identical or similar to each other, you may want to run Oracle Universal Installer in silent mode to automate the installation 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 session. By providing all installation input in a response file, which you invoke at the command-line prompt or in batch mode, you eliminate the need for direct interaction from the user, and a GUI is not displayed.

You can use the same response file multiple times. However, each installation uses only one response file.

To perform a silent installation with a response file, use the command-line mode or a batch script to invoke Oracle Universal Installer and enable the response file.

A silent installation 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 the Oracle Universal Installer interface to perform the reinstallation, or use the Oracle Universal Installer interface to first deinstall Oracle Fail Safe and then use response files to install the software again.

B.2 Editing and Enabling the Response File

Three different response file templates are available on the Oracle Fail Safe CD-ROM to help you set up Oracle Fail Safe installations in silent mode. Each template file performs a different type of installation. In the Oracle Universal Installer, you would choose an installation type through the screen shown in Figure 2-4; in a silent installation, you 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 
oracle.failsafe.complete.client.rsp failsafe.client.rsp Client Only installation
oracle.failsafe.complete.custom.rsp failsafe.custom.rsp Custom installation
Footnote The Typical installation type installs all of the Oracle Fail Safe components.

B.2.1 Implementation Steps

The following steps describe how to customize the variables in a response file and enable Oracle Universal Installer to use the file.


Note:

Use a response file only to perform silent installations for Oracle Fail Safe. Do not use the response files that are provided with Oracle Fail Safe to install any other products.


Step 1 Copy the response file template from the CD-ROM.

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.

Step 2 Edit the response file.

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

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. Except where noted, the variables have the same behavior in each of the three response file templates. The variables used in the following sections are also documented in Table B-1 and Table B-2.


For All Installation Types:

Edit the following variables to specify the name of the Oracle home where you want to install Oracle Fail Safe:

ORACLE_HOME

ORACLE_HOME_NAME


For a Typical Installation:

To install all of the Oracle Fail Safe components:

  1. Use the oracle.failsafe.complete.typical.rsp response file template.

  2. Locate the INSTALL_TYPE variable in the [oracle.failsafe.complete_3.3.1.0.0] Component section and make sure the value is INSTALL_TYPE="Typical" (this is the default setting).

  3. 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:

  1. Use the oracle.failsafe.complete.client.rsp response file template.

  2. Locate the INSTALL_TYPE variable in the [oracle.failsafe.complete_3.3.1.0.0] Component section and make sure 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:

  1. Use the oracle.failsafe.complete.custom.rsp response file template.

  2. Locate the INSTALL_TYPE variable in the [oracle.failsafe.complete_3.3.1.0.0] Component section and make sure the value is INSTALL_TYPE="Custom" (this is the default value).

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

  4. Specify the components to be installed in the DEPENDENCY_LIST variable.


Step 3 Invoke Oracle Universal Installer in silent mode.

On each system where you want to install Oracle Fail Safe, invoke 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

In the example, E: is the drive letter for the CD-ROM. The following list explains the syntax in the command line:

  • setup.exe invokes Oracle Universal Installer.

  • -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 that typically displays during an installation.

For example, the following command performs an Oracle Fail Safe installation in silent mode by reading all required installation information from the failsafemanager.rsp file:

E:\stage\Disk1\install\setup.exe -responseFile C:\failsafemanager.rsp -silent -nowelcome

Step 4 Delete the response file or move it to a secure location.

Because the response file specifies the domain, user name, and password information in the DomainUserName and Pwd variables, make sure that you either delete the response file or move it to a secure location on your system after the installation completes.

B.2.2 Validation of Values from the Response File

During an installation session when a variable is initialized, Oracle Universal Installer reads the response file to see if a value has been assigned for the variable. 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.

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

B.2.3 silentInstall.log File

When you perform a silent installation, the success or failure of the installation 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 has completed.

B.3 Contents of a Response File

The rest of the 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 and Table B-2. Set the optional <recommendation> variable to either Forced or Default, as follows:

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]).

B.3.1 General Section

The General section is an informational section that contains the version number of the response file. There is only one General section per response file. For example:

[General]

RESPONSEFILE_VERSION=1.7.0

Do not edit information in the General section.

B.3.2 Session Section

The Session section lists predefined (generic) dialogs for Oracle Universal Installer and shows whether the dialogs are visible to the user.


Note:

This section is relevant only if you do not specify the -silent qualifier on the command line. The -silent qualifier overrides all of the variable values in the Session section and does not display any of the installation dialog boxes.

Oracle Universal Installer displays the dialog when the value is set to true, and does not display the dialog when a value is set to false. For example:

[SESSION]

SHOW_INSTALL_PROGRESS_PAGE=true

Because the SHOW_INSTALL_PROGRESS_PAGE is set to true, the progress of the installation will be displayed during the installation. The Session section also lists global variables that are set during one installation session (from the start of the installation to the end of installation). These variables include top-level components and languages.

Table B-1 provides a list of the variables in the Session section.

Table B-1 Variables for the Session Section

Variable Name Value Type Required?
FROM_LOCATION Specifies the "From" location in the installer, which is a directory path containing the source of the products to be installed. String Yes
FROM_LOCATION_CD_LABEL 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
NEXT_SESSION Set to true to allow users 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 true. Boolean No
NEXT_SESSION_ON_FAIL Set to true to allow users to invoke another session even if the current installation has failed. This variable is relevant only if NEXT_SESSION is set to true. Boolean Yes
NEXT_SESSION_RESPONSE Optionally 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 <TEMP>\OraInstall directory. This variable is active only if NEXT_SESSION is set to true. String No
ORACLE_HOME Specifies the "To" location in the installer where products are to be installed. For example, "C:\OFS" (use quotation marks). String Yes
ORACLE_HOME_NAME Specifies the name of the current Oracle home. For example, "OracleFailSafe" (use quotation marks). String Yes
SHOW_COMPONENT_LOCATIONS_PAGE Allows you to specify an alternate directory location for the installation. Specify false to prevent users from changing the location of the installation directory. Boolean No
SHOW_CUSTOM_TREE_PAGE Displays only during a custom installation. On this page, dependencies can be selected or deselected. 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
SHOW_END_SESSION_PAGE Displays the install success/failure page at the end of an installation. Set the value to true to show the page. Specify false to suppress it. Boolean Yes
SHOW_EXIT_CONFIRMATION Set to true to show confirmation when exiting the installer. Specify false to suppress it. Boolean No
SHOW_INSTALL_PROGRESS_PAGE Displays the current status (including which product is being installed and which file is being copied) during the installation. Set the value to true to show the current status. Specify false to suppress it. Boolean No
SHOW_OPTIONAL_CONFIG_TOOL_PAGE Displays the optional configuration tools that are a part of this installation, including the status of each tool and any tool failures that were detected. Set the value to true to show the page. Specify false to suppress it. Boolean No
SHOW_RELEASE_NOTES Displays the list of release notes available for the products just installed. Set to true to show the release notes at the end of the installation. Specify false to suppress the list. Boolean No
SHOW_REQUIRED_CONFIG_TOOL_PAGE Displays the required configuration tools that are a part of this installation, including the status of each tool and any tool failures that were detected. Set the value to true to show the page. Specify false to suppress it. Boolean No
SHOW_ROOTSH_CONFIRMATION Not applicable (NA). NA NA
SHOW_SPLASH_SCREEN Set to true if the initial splash screen for the Oracle Universal Installer needs to be shown. Boolean No
SHOW_SUMMARY_PAGE Lists the components that will be installed in this session. Set this value to true to display the summary page during the silent installation. Specify false to suppress it. Boolean Yes
SHOW_WELCOME_PAGE Set to true if the welcome page in the installer needs to be shown. Boolean No
TOPLEVEL_COMPONENT 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.3.1.0.0"}. Stringlist Yes
UNIX_GROUP_NAME Not applicable (NA). NA NA

B.3.3 Component Section of the Response File

The response file can contain one or more of the following Oracle Fail Safe component sections:


[oracle.failsafe.complete_3.3.1.0.0]
[oracle.failsafe.server_3.3.1.0.0]

To find a value for a variable, Oracle Universal Installer checks the appropriate component section to which the variable belongs. All variables are required for the files in which they appear. Table B-2 describes the variables.

Table B-2 Variables for the Component Section

Variable Name Value Type
DomainUserName 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
Pwd 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
DEPENDENCY_LIST Specifies 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.server","3.3.1.0.0",
"oracle.failsafe.manager","3.3.1.0.0",
"oracle.mscs.server","3.3.1.0.0",
"oracle.swd.oui","1.7.0.18.0a"}

This variable appears in response files for only the Custom installation.

Stringlist
INSTALL_TYPE Specify the internal name for only one of the following installation types:
  • The internal name for a Typical installation is Typical.

  • The internal name for a Custom installation is Custom.

  • The internal name for a Client Only installation is install_type_1.

For example: INSTALL_TYPE="install_type_1"

This variable appears in all response files.

String
OPTIONAL_CONFIG_TOOLS Specifies 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 for only the Typical installation.

Stringlist


Previous Next
Oracle Logo
Copyright © 1999, 2002 Oracle Corporation

All rights reserved
Go To Table Of Contents
Contents
Go To Index
Index