OFS - Oracle Fail Safe

Oracle Fail Safe
Installation Guide Release 3.4.2 for Microsoft Windows

E14975-01
October 2009
Oracle Fail Safe Installation Guide, Release 3.4.2 for Microsoft Windows E14975-01 Copyright 2009, Oracle and/or its affiliates. All rights reserved. Primary Author: Ashmita Bose Janelle Simmons
Contributing Author: Contributor:
Paul Mead
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.
Contents
Preface ................................................................................................................................................................ vii
Audience...................................................................................................................................................... vii Documentation Accessibility .................................................................................................................... vii Related Documents ................................................................................................................................... viii Conventions ............................................................................................................................................... viii
1 Introduction and Preinstallation Checklist

1.1 1.2 1.3 1.4 1.5 1.6 Cluster Setup Prerequisites ....................................................................................................... Software Compatibility .............................................................................................................. Recommended Order for Software Installation ..................................................................... Adding a Node to an Existing Cluster..................................................................................... Adding a Sample Database ....................................................................................................... Postinstallation Procedures ....................................................................................................... 1-1 1-2 1-2 1-4 1-4 1-4
2 Installing Oracle Fail Safe

2.1 2.2 Review the PreInstallation Checklist ....................................................................................... 2-1 Install the Oracle Fail Safe Software......................................................................................... 2-2
3 Getting Started
3.1 3.1.1 3.1.2 3.1.3 3.1.4 3.1.5 3.1.6 3.2 Starting the Manager and Verifying the Oracle Fail Safe Installation ................................ Start Oracle Fail Safe Manager........................................................................................... Connect to the Cluster......................................................................................................... Run Verify Cluster............................................................................................................... Verify the OracleMSCSServices Service Entry ................................................................ Verify That Oracle Services for MSCS Is in the Cluster Group..................................... Verify That Oracle Resource DLLs Are Registered with MSCS ................................... Oracle Fail Safe Manager Tutorial and Online Help ............................................................. 3-1 3-1 3-3 3-3 3-4 3-4 3-5 3-5
4 Deinstalling Oracle Fail Safe

4.1 Deinstalling Oracle Fail Safe Release 3.n Software ................................................................ 4-1
5 Troubleshooting Installation Problems

5.1 5.2 Problems With the FSCMD Command After an Upgrade ................................................... 5-1 Problems Installing Oracle Services for MSCS ....................................................................... 5-1
iii
5.3 5.4 5.5
Problems Deinstalling Oracle Fail Safe and MSCS Software ............................................... 5-1 Problems With the User Rights Policy..................................................................................... 5-2 Network Configuration Problems............................................................................................ 5-2
Rolling Upgrades and Patches

A.1 A.2 A.3 A.4 A.4.1 A.4.2 A.5 Preparing Users for the Upgrade............................................................................................. Recommended Order for Upgrading Software..................................................................... Upgrading the Oracle Fail Safe Software and Installing Patches ....................................... Upgrading or Patching a Highly Available Oracle Database ............................................. Upgrading a Database Configured for High Availability ............................................ Patching an Oracle Database Configured for High Availability ................................. Upgrading Other Oracle Product Software ........................................................................... A-1 A-2 A-2 A-4 A-4 A-5 A-8
B Silent Mode Installations and Deinstallations

B.1 B.1.1 B.1.2 B.1.3 B.2 B.3 B.3.1 B.3.2 B.3.3 Introduction to Silent Mode Installations and Deinstallations ........................................... Selecting a Response File ................................................................................................... Validating Values from the Response File ...................................................................... Locating the silentInstall.log File...................................................................................... Steps for a Silent Mode Installation or Deinstallation .......................................................... Contents of a Response File ..................................................................................................... General Section.................................................................................................................... Session Section .................................................................................................................... Component Section of the Response File ........................................................................ B-1 B-1 B-2 B-2 B-2 B-5 B-5 B-5 B-8
C Manually Registering Oracle Resource DLL Files

C.1 C.2 C.2.1 C.2.2 Oracle Resource DLL Files........................................................................................................ Registering and Unregistering the Oracle Database Resource DLL Files ......................... Oracle Resource DLL Files ................................................................................................ Oracle Resource Administrator Extension DLL Files.................................................... C-1 C-2 C-2 C-2
Index
iv
List of Figures
11 12 31 32 33 Recommended Order for Installing Software on a Two-Node Cluster .............................. Software Installed on Private, Shared-Nothing Cluster Disks............................................. Adding a Cluster to the Tree View........................................................................................... Oracle Fail Safe Manager with a Cluster Added to the Tree View...................................... Oracle Services for MSCS in the Cluster Administrator Window....................................... 1-2 1-3 3-2 3-2 3-5
List of Tables
A1 A2 A3 A4 A5 B1 B2 B3 C1 Steps Required to Upgrade to Oracle Fail Safe.................................................................... Steps for Upgrading a Database Configured for High Availability................................. Steps for Patching a Database Configured for High Availability..................................... Steps for Starting Up a Database with the MIGRATE Option .......................................... Steps Required to Upgrade Other Oracle Product Software............................................. Variables for the Session Section for a Silent Mode Installation ....................................... Variables for the Session Section for a Silent Mode Deinstallation .................................. Variables for the Component Section for a Silent Mode Installation ............................... Oracle Resource DLL Files...................................................................................................... A-3 A-5 A-6 A-7 A-8 B-6 B-8 B-9 C-1
vi
Preface
This guide provides step-by-step procedures to help you install, deinstall, and upgrade Oracle Fail Safe.
Audience
This document is intended for anyone who must perform the initial setup and installation of Oracle Fail Safe on Microsoft Windows systems. In general, this book defines technical terms and concepts when they are introduced. However, it assumes that you know the underlying operating system and are familiar with basic system administration tasks. Also, you should be familiar with Microsoft Cluster Server (MSCS).
Documentation Accessibility
Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/. Accessibility of Code Examples in Documentation Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace. Accessibility of Links to External Web Sites in Documentation This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites. Deaf/Hard of Hearing Access to Oracle Support Services To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request
vii
process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html.
Related Documents
For more information, see the following documents in the Oracle Fail Safe documentation set:

Oracle Fail Safe Release Notes Oracle Fail Safe Concepts and Administration Guide Oracle Services for MSCS Error Messages For online assistance, Oracle Fail Safe Manager provides a tutorial and online help topics. To access the tutorial and online help topics, click Help on the menu bar of the main Oracle Fail Safe Manager window.
For information about related products, refer to the following documentation:
For more information about cluster systems, see the Microsoft Cluster Server (MSCS) documentation. For more information about other related products, see the documentation for those products.
Conventions
The following text conventions are used in this document:
Convention boldface italic monospace Meaning Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary. Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values. Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.
viii
1
1
Introduction and Preinstallation Checklist

This guide uses a step-by-step approach to assist you with the installation of Oracle Fail Safe. Oracle Fail Safe consists of multiple components: Oracle Fail Safe Manager, Oracle Services for MSCS, and server components specific to Oracle Fail Safe. Oracle Fail Safe Manager is a graphical user interface using which you configure and manage Oracle single-instance databases, Oracle Management Agent, generic services, and so on for high availability in an MSCS cluster. Oracle Services for MSCS is the main server component. Typically, you perform the installation using Oracle Universal Installer graphical user interface. If you perform the same installation on multiple systems, you may run Oracle Universal Installer in silent mode to automate the installation process in batch files or scripts. Silent installations are described in Appendix B. The following topics are discussed in this chapter:

Cluster Setup Prerequisites Software Compatibility Recommended Order for Software Installation Adding a Node to an Existing Cluster Adding a Sample Database Postinstallation Procedures
1.1 Cluster Setup Prerequisites

You must perform the following configuration tasks before the installation of Oracle Fail Safe:
Ensure that you have a cluster hardware configuration listed on the Microsoft hardware compatibility list for Microsoft Windows clusters. Ensure that each system supports TCP/IP. Check that each system has the proper Oracle Net tnsnames.ora configuration to allow the system to connect to its local database (if applicable) and the databases on the other systems. If you install Oracle Services for MSCS on a subset of the nodes in the cluster, check that the Cluster Group is running on one of the nodes where you installed Oracle Fail Safe. You can view or change the location of the Cluster Group using MSCS Cluster Administrator.
1-1
Software Compatibility
Ensure that Microsoft Windows Event Viewer is not running while installing Oracle Services for MSCS. This is an issue only if installing on top of an existing installation (in-place upgrade).
Note:
If you attempt to install Oracle Services for MSCS while the Microsoft Windows Event Viewer is running, the installation procedure may return an error indicating that it cannot copy the fsus.dll file (fsja.dll on Japanese systems) and asks you to retry, ignore, or cancel. You can continue the installation if you stop the Microsoft Windows Event Viewer and then click Retry in the Oracle Fail Safe installation Error window.
1.2 Software Compatibility

Refer to Oracle Fail Safe Release Notes for information on current software compatibility for different operating systems.
1.3 Recommended Order for Software Installation

Although this guide describes the Oracle Fail Safe installation in detail, other products must also be installed to implement the Oracle Fail Safe environment. Figure 11 shows the recommended order for installing software on a two-node cluster
Note: (The numbers in Figure 11 do not correspond to the numbered steps in the subsequent list because the list contains more detailed information than the figure.
Figure 11 Recommended Order for Installing Software on a Two-Node Cluster
Node 1 Step 1 : Install or upgrade : Windows operating system MSCS Optional Oracle software Node 2 Step 2 : Install or upgrade : Windows operating system MSCS Optional Oracle software
Step 3 : Install or upgrade : Oracle Services for MSCS Oracle Fail Safe Manager
Step 4 : Install or upgrade : Oracle Services for MSCS Oracle Fail Safe Manager
The following list provides more detail about the installation order and other tasks to help you get started with Oracle Fail Safe:
1.
On each cluster node, install:

a. b.
Microsoft Windows Server on a private (system) disk. Microsoft Distributed Transaction Coordinator and correctly configure for a cluster environment.
1-2 Oracle Fail Safe Installation Guide
Recommended Order for Software Installation
See Oracle Fail Safe Release Notes for information about the versions of Microsoft Windows that can be used with Oracle Fail Safe. The Oracle Fail Safe Web site contains more information about installing Microsoft Cluster Server.
2.
On each cluster node for each Oracle product that you intend to install, create an Oracle home on a private disk (for example, the system disk). To minimize downtime during future upgrades, Oracle recommends that you use a separate Oracle home for each major component (for example, a separate Oracle home each for the database, application software, and Oracle Fail Safe). To allow applications to fail over, ensure that the Oracle homes on each cluster node have the same name. For example, name the Oracle Fail Safe home on each cluster node ofs_ home, and name the database home on each cluster node dbs_home. On each cluster node, install the optional Oracle software (Oracle Database and other applications) that you plan to use with Oracle Fail Safe. Place all application and database data, control, and log files on shared cluster disks so that they can fail over. If you are installing Oracle Database software, you can create the database before or after you install Oracle Fail Safe. Create the database as you would in a noncluster environment, including the database listener. However, the database must be created on a cluster disk or disks.
3.
4.
On each cluster node, install the server component of Oracle Fail Safe, Oracle Services for MSCS. If you want, you can install the client component, Oracle Fail Safe Manager, at the same time. See Chapter 2 for complete information about installing Oracle Fail Safe.
5.
On one or more client systems, optionally, install Oracle Fail Safe Manager (for example, to set up additional management consoles).
Figure 12 lists the software and the files that should be installed on private disks and shared-nothing cluster disks.
Figure 12 Software Installed on Private, Shared-Nothing Cluster Disks
Private Disk
Node 1
Node 2
Private Disk
Cluster Disks Executable Application Files:

Oracle Fail Safe Microsoft Windows MSCS Third-Party Applications ...
Executable Application Files:

Oracle Fail Safe Microsoft Windows MSCS Third-Party Applications ...
Application Data and Log Files:

Database Data Files Database Control Files Database Log Files ...
1-3
Adding a Node to an Existing Cluster
1.4 Adding a Node to an Existing Cluster

If you want to add a node to an existing cluster, perform the following operations:
1. 2.
Follow Microsoft's instructions to add a node to a cluster. On the new node, install any desired optional Oracle software (Oracle Database and other applications) that you plan to use with Oracle Fail Safe. Install executable application files located on private disks (for example, on the system disk for each node). On the new node, install Oracle Services for MSCS (which is the server component of Oracle Fail Safe). You can install Oracle Fail Safe Manager at the same time.
3.
1.5 Adding a Sample Database

Oracle Fail Safe includes a Create Sample Database command that installs a preconfigured sample database on a cluster disk specified by the user. The sample database has limited functions and is intended only for testing purposes and for use with the online Oracle Fail Safe tutorial. The sample database should not be used for production. To create a database for production, use Database Configuration Assistant or create the database manually.
1.6 Postinstallation Procedures

After you have successfully installed Oracle Fail Safe, perform the following tasks:
1.
If you installed optional Oracle software:

Configure application data and log files on the shared cluster disks. Configure alert and trace files on either the shared cluster disks or on the private disk. Configuring alert and trace files on private disks allows the administrator to determine the node on which problems occur, but requires that you maintain multiple sets of files. Placing parameter files on private disks is recommended only when you want the parameters to be different on each cluster node. For example, this can be useful if you want a database to use fewer resources on its failover node than on its primary node (such as when you know that another application or database on the failover node needs resources). For information about re-creating databases on cluster disks, refer to the Import/Export documentation that is specific to your database.
2.
Start Oracle Fail Safe Manager, connect to the cluster alias with a domain account that has Administrator privileges on each cluster node, and run the Verify Cluster operation when prompted. See Chapter 3 for information to help you get started with Oracle Fail Safe.
3.
Refer to the Oracle Fail Safe Tutorial for step-by-step information about creating a group and adding resources to it. (To run the tutorial from the Oracle Fail Safe Manager, select Help, and then select Tutorial.) Run the fssvr command qualifier, /GETSECURITY, which is provided by Oracle Fail Safe on each cluster node. The /GETSECURITY qualifier displays security information about the system where the command is run. The command and its associated output should be similar to the following:
fssvr /getsecurity
4.
Postinstallation Procedures
Looking up user account information for OracleMSCSServices. The user account must be a domain user acount with local Administrator privileges. The user account must also have the 'Log on as batch job' privilege. User account specified for OracleMSCSServices is NEDCDOMAIN\cluadmin User account specified has local Administrator privileges User account has the 'Log on as batch job' privilege Looking up user account information for Cluster Service. The user account must be a domain user account with local Administrator privileges. The user account must also have the 'Log on as batch job' privilege. User account specified for Cluster Service is NEDCDOMAIN\cluadmin User account specified has local Administrator privileges User account has the 'Log on as batch job' privilege Checking to see if DCOM is enabled. DCOM is enabled. DCOM must be enabled.
1-5
Postinstallation Procedures
2
2
Installing Oracle Fail Safe
This chapter provides step-by-step instructions for installing Oracle Fail Safe Manager, Oracle Services for MSCS, and additional server components specific to Oracle Fail Safe.
Note:
If you are upgrading Oracle Fail Safe from an earlier release, see Appendix A for information about performing a rolling upgrade.
The discussions in this chapter assume that you have set up your hardware configuration, installed Microsoft Windows and configured Microsoft Windows Failover Clusters. If you plan to configure Oracle products or other components with Oracle Fail Safe, then install the component software before installing Oracle Fail Safe. The following topics are discussed in this chapter:

Review the PreInstallation Checklist Install the Oracle Fail Safe Software
2.1 Review the PreInstallation Checklist

Perform the following preinstallation checks:
Verify the release of any other Oracle software or third-party software that you plan to use with Oracle Fail Safe against the software compatibility guidelines that are documented in Oracle Fail Safe Release Notes. If necessary, configure Microsoft Windows Failover Clusters and configure MSDTC. Verify that the cluster is up and running on all nodes. Remove the previous version of Oracle Fail Safe, if necessary. Install additional components that you want to configure with Oracle Fail Safe (such as Oracle Database and so on). If necessary, install Oracle Enterprise Manager. Log on to the cluster nodes using the same domain user account that has Administrator privileges. The account from which you run Oracle Universal Installer must have Administrator privileges.
Installing Oracle Fail Safe 2-1
Install the Oracle Fail Safe Software
2.2 Install the Oracle Fail Safe Software

After you have installed Microsoft Windows Server, and have configured and validated the failover cluster as described in the Microsoft documentation, you are ready to install Fail Safe. Install Oracle Fail Safe on all cluster nodes, but perform the Oracle Services for MSCS installation sequentially on only one node at a time. Optionally, you can install Oracle Fail Safe Manager on the cluster nodes at the same time. To install Oracle Fail Safe Manager on client systems, you must be running Microsoft Windows. See the Oracle Fail Safe Release Notes for information regarding the required versions of Microsoft Windows and MSCS.
Note:
If you decide to update a Microsoft Windows service pack from one supported version to another, you can do so regardless of whether Oracle Fail Safe or the software for resources that Oracle Fail Safe supports has been installed.
Perform the following steps to install Oracle Fail Safe. Step 1 Start Oracle Universal Installer. Use Oracle Universal Installer, which is included in the Oracle Fail Safe software kit, to install Oracle Fail Safe. Typically, after you insert the CD-ROM the Oracle Fail Safe Autorun window opens and presents three choices: Install/Deinstall Products, Explore CD, and Browse Documents. Click Install/Deinstall Products to begin the installation. If the Oracle Fail Safe Autorun window does not open when you insert the CD-ROM, then run the Oracle Fail Safe setup.exe program, which is on the CD-ROM. Oracle Universal Installer automatically performs the installation procedure in the same language used by the operating system. For example, if the node operating system is in Japanese, then Oracle Universal Installer automatically performs the installation in Japanese. When Oracle Universal Installer begins, a command interpreter window opens, indicating that the installer is checking prerequisites. If all prerequisites are met, then the Welcome window opens. If some or all prerequisite checks fail, then you are asked whether you want to continue. If you choose to continue, then the installation may fail. Step 2 Welcome Window: Verify installed components and Oracle homes. When the Welcome window opens, you can optionally click Installed Products to view the Oracle components that are installed and the Oracle homes where they reside. Click Next when ready to proceed. Step 3 Specify File Locations Window: Specify the Oracle home directory for the Oracle Fail Safe installation. In the Specify File Locations window, specify the source and destination paths, and the Oracle home, as follows:
1. 2.
Under Destination, in the Name box, enter a unique name for the Oracle home where you want to install the Oracle Fail Safe software. Under Destination, in the Path box, enter the directory specification for the Oracle home entered in the previous step.
3.
Click Next.
Note:
You must install Oracle Fail Safe on a private disk, not on a shared cluster disk. You must install the Oracle Fail Safe server software (which includes Oracle Services for MSCS and additional Oracle Fail Safe server components) in one Oracle home, not in multiple Oracle homes. Oracle Universal Installer prevents you from installing Oracle Fail Safe server components in multiple Oracle homes. The name of the Oracle home must be the same on each node in the cluster. Although not required, Oracle recommends that the Oracle home path also be the same on each cluster node.
Step 4 Installation Types Window: Select an installation type. In the Installation Types window, specify the type of installation to perform, as follows:
1.
Select an installation type:
Select Typical to install Oracle Fail Safe Manager and Oracle Services for MSCS. Typical is the default installation type. Select Client Only to install Oracle Fail Safe Manager. Select Custom or Reinstall to specify one-by-one which components you want to install or reinstall.
2.
Click Next.
Step 5 Available Product Components Window: Select components. If you selected Typical or Client Only in Step 4, then go to Step 6. If you selected Custom or Reinstall in Step 4, then this window lets you specify which components to install, as follows:
1. 2.
To install the manager, select Oracle Fail Safe Manager. To install Oracle Fail Safe server components and Oracle Services for MSCS, leave them selected. By default, Oracle Fail Safe server components and Oracle Services for MSCS are selected. You must deselect the components that you do not want to install. The Oracle Fail Safe server components have a dependency on Oracle Services for MSCS. Do not deselect one and not the other. However, you can choose to install just the manager by deselecting both Oracle Fail Safe server components and Oracle Services for MSCS or you can choose to install just the server software by deselecting Oracle Fail Safe Manager.
At this point, Oracle Universal Installer displays a window informing you that you must restart the node after the installation. (Step 9 in these instructions provides more information about restarting the node.) This window is not displayed if you have previously installed Oracle Fail Safe and the changes to the system path have been made and detected previously. Step 6 Summary Window: Verify the component installations. The Summary window lists the components selected for this installation.
Installing Oracle Fail Safe 2-3
Verify that the information in the Summary window is correct. If the summary includes a component that you do not want to install, then click Previous to back up through the installation dialog box and deselect the component.
Note:
If your system does not have sufficient space to perform the installation, then the text below Space Requirements is displayed in red.
If the information in the Summary window is correct, then click Install to start the installation. The Install window displays the progress of the installation, including the names of the files that are being installed. Typically, the installation completes in 1 to 5 minutes. Step 7 Configuration Tools Window and Associated Dialog Box: Enter a domain user account for Oracle Services for MSCS. If the installation is successful, then the Configuration Tools window and the Oracle Services for MSCS Account/Password dialog box open. In the Oracle Services for MSCS Account/Password dialog box enter:
1.
A value in the Domain\Username box for a user account that has Administrator privileges For example, if you are using the NEDCDOMAIN and your user name is cluadmin, then enter NEDCDOMAIN\cluadmin.
2.
The password for the account in the Password and Confirm Password boxes
Oracle Services for MSCS uses the account you specify to access the cluster. Oracle Services for MSCS runs as a Microsoft Windows service (called OracleMSCSServices) under a user account that must be a domain user account (not the system account) that has Administrator privileges on all nodes of this cluster. The account must be the same on all nodes of this cluster, or you will receive an error message when you attempt to connect to a cluster using Oracle Fail Safe Manager. Step 8 End of Installation Window: Confirm the Installation and view the Oracle Fail Safe Release Notes. Oracle Universal Installer displays the End of Installation window. To confirm the installation of Oracle Fail Safe and any additional components, click Installed Products. Step 9 Restart the cluster node if you are instructed to do so. If a window is presented that instructed you to restart the cluster node, then do so after you exit the installer. Step 10 Verify the Oracle Fail Safe installation. See Chapter 3 for information about verifying the Oracle Fail Safe installation.
3
3
Getting Started
This chapter contains the following topics to help you connect to a cluster and start using Oracle Fail Safe Manager:

Starting the Manager and Verifying the Oracle Fail Safe Installation Oracle Fail Safe Manager Tutorial and Online Help
3.1 Starting the Manager and Verifying the Oracle Fail Safe Installation
After you install the Oracle Fail Safe software on all nodes in the cluster, you must verify the installation. This section describes how to start Oracle Fail Safe Manager, connect to the cluster, and perform the tasks involved in installation verification.
3.1.1 Start Oracle Fail Safe Manager

After the installation is completed, start Oracle Fail Safe Manager from the Microsoft Windows taskbar by selecting Programs (or All Programs) from the Windows Start menu, then Oracle - ORACLE_HOME, then Oracle Fail Safe Manager. (ORACLE_ HOME is the name of the Oracle home where you installed Oracle Fail Safe.) When Oracle Fail Safe Manager opens, usually the Add Cluster to Tree dialog box also opens, as shown in Figure 31. If the Add Cluster to Tree dialog box does not open, from the File menu, select Add Cluster to Tree. In the Cluster Alias box, enter the alias for the cluster and then click OK.
Getting Started 3-1
Starting the Manager and Verifying the Oracle Fail Safe Installation
Figure 31 Adding a Cluster to the Tree View
After you click OK in the Add Cluster to Tree dialog box, the cluster alias is added to the tree view, and the General tab for the cluster is displayed, as shown in Figure 32. However, because Oracle Fail Safe Manager is not yet connected to the cluster, the General tab displays the message: "Oracle Fail Safe Manager is not currently connected to this cluster. To connect, open the File menu, and select Connect to Cluster." The next section describes connecting to a cluster in detail.
Figure 32 Oracle Fail Safe Manager with a Cluster Added to the Tree View
3.1.2 Connect to the Cluster

After you add the cluster to the tree view, you must connect to the cluster. Open the Connect to Cluster dialog box by performing one of the following steps:

On the File menu, click Connect to Cluster. Right-click the cluster alias, then click Connect. Click the box to the left of the cluster alias (to expand the cluster alias folder).
The following list describes the input to the Connect to Cluster dialog box:
User Name Enter a user name for a domain account name that has Administrator privileges on all nodes of the cluster where you are connecting.
Password Enter the password for the account specified in the User Name field.
Cluster Alias Contains the alias of the cluster that you selected from the tree view. The alias name is assigned to the cluster when you (or someone else) created the cluster with MSCS. A cluster alias is sometimes referred to as a cluster name.
Domain Enter the name of the domain to which the user name belongs.
Save as local preferred credentials Select to have Oracle Fail Safe Manager save the account information you have entered to a text file, ORACLE_HOME\fs\fsmgr\FsClusters.txt on the system from which you are running Oracle Fail Safe Manager. The password is saved in an encrypted format. This lets you disconnect and reconnect to the cluster (from your current system) without having to specify the account information each time a reconnection is requested.
Click OK or press Enter to connect to the cluster. Cluster Alias, User Name, Password, and Domain should all be entered. The Save as Local Preferred Credentials option is not a required choice on any Microsoft Windows system. If you do not specify a user name, password, or domain, Oracle Fail Safe attempts to connect to the cluster using the account with which you logged on to the server node. Once a connection to the cluster is made, the Oracle Fail Safe Manager main window expands the tree view.
3.1.3 Run Verify Cluster

The first time you connect to a cluster after you install Oracle Fail Safe, Oracle Fail Safe Manager prompts you to run the Verify Cluster operation to validate the Oracle Fail Safe installation and the network configuration. The Verify Cluster operation displays its progress in a Verifying Cluster window. Later, you can run the Verify Cluster operation at any time by selecting Troubleshooting, then Verify Cluster from the Oracle Fail Safe Manager menu bar. This is especially useful if you later change your cluster configuration. Verify Cluster performs operations to verify that:
The Oracle homes are identical on all nodes

Getting Started 3-3
The Oracle Fail Safe release is identical on all nodes The resource providers are configured identically on all nodes The resource providers are disabled if the required software has not been installed The Host Name/IP Address mappings resolve consistently across all nodes in the cluster
Verify Cluster also registers with MSCS the resource DLLs for the resource types that Oracle Fail Safe supports. For more information about Verify Cluster operations, refer to Oracle Fail Safe Concepts and Administration Guide.
3.1.4 Verify the OracleMSCSServices Service Entry

On successful installation and verification of Oracle Services for MSCS, the Services Control Panel on each cluster node must include a new service entry named OracleMSCSServices. To verify the OracleMSCSServices entry in the Services Control Panel:
1. 2.
Open the Windows Services Window. Scroll down to the Oracle service listings and locate the OracleMSCSServices entry. The Startup status for OracleMSCSServices is displayed as Started on the node where the Cluster Group resides, and it is displayed as Manual on the other cluster nodes.
3.
Perform steps 1 and 2 on each cluster node.
3.1.5 Verify That Oracle Services for MSCS Is in the Cluster Group
The Oracle Services for MSCS service is maintained by MSCS. On successful installation of Oracle Services for MSCS on each cluster node, start MSCS Cluster Administrator and verify that it includes Oracle Services for MSCS as a resource in the Cluster Group (the group containing the MSCS resources critical to cluster operation). To verify that Oracle Services for MSCS is listed as a resource, start MSCS Cluster Administrator, then click Cluster Group in the Cluster Administrator tree view to select it, and, in the right-hand side pane, locate the Oracle Services for MSCS entry in the Name column, as shown in Figure 33.
Oracle Fail Safe Manager Tutorial and Online Help
Figure 33 Oracle Services for MSCS in the Cluster Administrator Window
3.1.6 Verify That Oracle Resource DLLs Are Registered with MSCS
After installing Oracle Services for MSCS on all cluster nodes and verifying the cluster, start the MSCS Cluster Administrator and verify that it includes the cluster resource types for Oracle Fail Safe. For example, if you have the database installed on the cluster nodes, start the MSCS Cluster Administrator. Then select Resource Types in the Cluster Administrator tree view, and, in the right-hand side pane, locate the Oracle Database and Oracle TNS Listener entries in the Display Name column.
3.2 Oracle Fail Safe Manager Tutorial and Online Help

For detailed step-by-step instructions about using Oracle Fail Safe Manager, refer to the Oracle Fail Safe tutorial and help. To access these online tools, from the Oracle Fail Safe Manager menu bar, select Help, then select Contents, or Help, and then select Tutorial for step-by-step instructions. The online help is your primary source of information when you use Oracle Fail Safe Manager. For example, if you select Contents in the Help menu, the Help window displays the first help topic. If you select Search for Help on, a Help window opens to display Contents, Index, and Find tabs. You can find common tasks under the Contents tab and in the Index. The Find tab lets you perform a full text search of the Oracle Fail Safe Manager Help. To view the full set of Oracle Fail Safe documentation, select Online Manuals. If the documentation was not installed on the system then the documentation options under the Help menu will be dimmed and will not be available.
Getting Started 3-5
Oracle Fail Safe Manager Tutorial and Online Help
4
4
Deinstalling Oracle Fail Safe
This chapter contains the following topics to help you to deinstall Oracle Fail Safe:
Deinstalling Oracle Fail Safe Release 3.n Software
You might want to deinstall Oracle Fail Safe, for example, to remove older software or to move Oracle Fail Safe software to another Oracle home. However, do not use the deinstallation instructions in this chapter as a method for upgrading the Oracle Fail Safe software to the current release. See Appendix A for information about performing a rolling upgrade. See Appendix B for information about performing a silent mode deinstallation.
Caution: Do not evict a node from a cluster without first deinstalling Oracle Fail Safe. Evicting a node while Oracle Fail Safe is running will cause all MSCS metadata to be deleted, producing undesirable results. See Section 5.3 for more information.
4.1 Deinstalling Oracle Fail Safe Release 3.n Software

Deinstalling Oracle Fail Safe software involves removing resources from groups and reconfiguring them to run on a specific cluster node. Perform the following steps to remove Oracle Fail Safe software. Step 1 Close Event Viewer If you run the Windows Event Viewer and display any Oracle Fail Safe events, then you should close the Event Viewer before deinstalling Oracle Fail Safe. Step 2 Remove cluster resources from groups configured with Oracle Fail Safe Manager. This step must be performed only on groups that were configured with Oracle Fail Safe. Do not perform this step on groups that were configured with MSCS (such as the Cluster Group). Using Oracle Fail Safe Manager, perform the following tasks:
1. 2. 3. 4.
Move each group to the node that will host the standalone resources after Oracle Fail Safe is deinstalled. Remove all resources from your groups. Delete all groups. Exit Oracle Fail Safe Manager.
Deinstalling Oracle Fail Safe 4-1
Deinstalling Oracle Fail Safe Release 3.n Software
Step 3 Start Oracle Universal Installer and deinstall software. Start Oracle Universal Installer and perform the following tasks:
1. 2. 3. 4.
Click Deinstall Products to display Inventory dialog box. Select the Oracle home that contains the Oracle Fail Safe release 3.n software. Expand the tree view and select the check box next to Oracle Fail Safe 3.n. Click Remove.
Step 4 Exit Oracle Universal Installer. Click Exit to exit Oracle Universal Installer.
5
5
Troubleshooting Installation Problems

This chapter provides general information to help you troubleshoot problems with Oracle Fail Safe installations and deinstallations. The following topics are covered in this chapter:

Problems With the FSCMD Command After an Upgrade Problems Installing Oracle Services for MSCS Problems Deinstalling Oracle Fail Safe and MSCS Software Problems With the User Rights Policy Network Configuration Problems
5.1 Problems With the FSCMD Command After an Upgrade

Prior to release 3.4.2 the ORACLE_HOME\fs\fsmgr\bin directory was included in the system path environment variable, thus a full directory specification was not needed to invoke the FSCMD command. In 3.4.2 and later the directory is no longer in the system path environment variable. The FSCMD executable is located in ORACLE_HOME\fs\fsmgr\bin directory, where ORACLE_HOME is the Oracle Fail Safe home directory. If you have not set your directory to ORACLE_HOME\fs\fsmgr\bin, you must specify the full path when running the FSCMD command.
5.2 Problems Installing Oracle Services for MSCS

If you are running Oracle Universal Installer on a system that does not have MSCS installed (such as a client system) and you try to install Oracle Services for MSCS, then the installer will open an error window to display an error that states that the Oracle Services for MSCS must be installed on a cluster running Microsoft Cluster Server. You must configure Windows failover cluster prior to installing Oracle Services for MSCS. If such a message is displayed, do not continue with the installation. Click OK to back up through the installation windows and choose a Client Only installation. See Chapter 2 for more information about Client Only installation.
5.3 Problems Deinstalling Oracle Fail Safe and MSCS Software

Chapter 4 warns against evicting a node from a cluster before deinstalling Oracle Fail Safe. If you evict a node on all cluster nodes, then the cluster metadata information about Oracle Fail Safe will be removed.
Troubleshooting Installation Problems
5-1
Problems With the User Rights Policy
If you evict a node from only one cluster node, then the cluster metadata information is still available on the other node or nodes. To prevent the loss of the cluster metadata, do not evict a node from a cluster; reinstall MSCS on the first node and click Join an Existing Cluster when prompted by the installation procedure to add the node back to the cluster and recover the cluster metadata. If you accidentally evict a node on all cluster nodes before you deinstall Oracle Fail Safe, then you can recover your databases (after you reinstall MSCS on all cluster nodes) by performing the following steps using Oracle Fail Safe Manager:
1. 2. 3. 4.
Select the standalone resource in the Oracle Fail Safe Manager tree view. Select the Verify Standalone Database operation from the Resources menu. Enter the standalone database information in the Verify Standalone Database window. When the verification completes successfully, add the standalone resource to a group using the Add Resource to Group Wizard.
Note:
It might be necessary to manually restore the configuration of other non-database resources, such as Oracle Application Server.
5.4 Problems With the User Rights Policy

For Oracle Services for MSCS to run, the "Log on as batch job" and "Log on as a service" user rights policy must be enabled for the user account under which Oracle Services for MSCS runs. Typically, the Oracle Fail Safe installation enables this policy for the user account during the security setup. However, in some situations, the user rights policy might not be enabled correctly on a backup domain controller (BDC), because the account database on the BDC is read-only and cannot be changed directly. To solve the problem, perform these steps:
1.
Perform one of the following operations:
If the primary domain controller (PDC) is part of the cluster, then install Oracle Fail Safe on the PDC. If the PDC is not part of the cluster, then grant "Log on as batch job" and "Log on as a service" rights to the Oracle Services for MSCS user account on the PDC.
2. 3.
Synchronize the account database with the BDCby using the Server Manager administration tool. Install Oracle Fail Safe on the BDC.
5.5 Network Configuration Problems

If you receive error messages regarding problems with the mapping of host names to IP addresses (such as FS-10514 and FS-10515), see the appendix on network configuration requirements in the Oracle Fail Safe Concepts and Administration Guide.
A
A
Oracle Fail Safe allows a cluster system to continue to provide service while the software is being upgraded to the next release. This process is called a rolling upgrade because each node is upgraded and restarted in turn, until all server nodes and all client nodes have been upgraded. You might want to perform a rolling upgrade for the following reasons:

To upgrade the Oracle Fail Safe software or install patches To upgrade or patch a highly available Oracle single-instance database To upgrade or patch other Oracle software
When you upgrade Oracle software, do not start the installation procedure while any Oracle Fail Safe Manager operations or MSCS Cluster Administrator operations are in progress on groups. You must wait for a quiet period in cluster operations before you proceed with the steps described in this appendix.
Note:
To ensure minimal downtime and to identify any potential issues with other software that might be running on the cluster, Oracle recommends that you test the operations described in this appendix on an identically configured test cluster before you upgrade the production cluster.
This appendix includes the following topics:

Preparing Users for the Upgrade Recommended Order for Upgrading Software Upgrading the Oracle Fail Safe Software and Installing Patches Upgrading or Patching a Highly Available Oracle Database Upgrading Other Oracle Product Software
A.1 Preparing Users for the Upgrade

During a rolling upgrade, you need to perform a planned failover to make the cluster resources running on one node move to another node. Each planned failover will disconnect users and cause a rollback of any interrupted, uncommitted work if a database is involved in the operation. This brief outage typically is less than 1 minute and always is less than the downtime that would be experienced by users if Oracle Fail Safe was not installed. To prevent loss of work, notify users that you plan to shut down the system, and have all users
A-1
Recommended Order for Upgrading Software
commit their work and log off before you perform the failover. Advise users when they can reconnect and resume work after the database fails over to another cluster node. While you are performing upgrades to a two-node cluster, remember that failback is disabled and your cluster is not protected against failures. In addition, each time that you stop and restart the cluster service on a node (with MSCS Cluster Administrator), all remaining cluster resources running on the node fail over to another node with a similar brief loss of service.
A.2 Recommended Order for Upgrading Software

Oracle recommends the following procedure for upgrading software on your cluster when just the database software or both the database software and Oracle Fail Safe software must be upgraded.
1. 2. 3.
Remove each database from its group. Upgrade the Oracle Database software and the Oracle Fail Safe software if required. The order in which you perform these two upgrades is not important. Add each database back to its group.
If you are only performing an Oracle Fail Safe software upgrade or applying a patch to the database software (but you are not going to upgrade the database software), then you do not need to remove any database from its group prior to performing the upgrade or applying the patch. Patching typically involves updating the software from one release to another where only the fourth or fifth digit in the release number changes, for example, 9.2.0.1 to 9.2.0.2. An upgrade is required when the first, second, or third digit in the release number changes, for example 9.0.1 to 9.2.0 or 9.0.1 to 10.0.1.
A.3 Upgrading the Oracle Fail Safe Software and Installing Patches
This section describes how to perform a rolling upgrade when you want to upgrade the Oracle Fail Safe software on a cluster that is currently running Oracle Fail Safe (for example, to upgrade the cluster from Oracle Fail Safe release 3.3.2 to release 3.3.3). The tasks described in this section apply to upgrades from any Oracle Fail Safe release before the current Oracle Fail Safe release. If you are performing a rolling upgrade of the Oracle Fail Safe software, then you must upgrade the Oracle Services for MSCS and Oracle Fail Safe Manager software clusterwide. You cannot run multiple releases of the Oracle Services for MSCS software on the same cluster. See the Oracle Fail Safe Release Notes for information about the compatibility of various Oracle Fail Safe Manager releases with various releases of Oracle Fail Safe Server or Oracle Services for MSCS. Perform the steps described in Table A1 on only one cluster node at a time.
A-2 Oracle Fail Safe Installation Guide
Upgrading the Oracle Fail Safe Software and Installing Patches
Table A1 Step 1 Task
Steps Required to Upgrade to Oracle Fail Safe Tool Oracle Fail Safe Manager Comments Select a group from the Oracle Fail Safe Manager tree view, select the Failback tab, make a note of the current settings, and then change the setting to Prevent Failback. Repeat these steps for each group in the cluster. Changing the failback attributes prevents the group from failing back after its preferred node is restarted (later in Step 6). Oracle Fail Safe Manager In the tree view, select a group name, then select Move to a Different Node. Repeat for each group on the node. By moving groups to another node, you can upgrade the current node while users continue to access the group on another node. When moving groups that contain databases with this method, Oracle Fail Safe will perform a checkpoint operation. From the File menu, select Exit. Note: Do not use Oracle Fail Safe Manager on other cluster nodes during the rest of the upgrade procedure until you run Verify Cluster in Step 10. See Chapter 4 for instructions.
Change the group attributes to the Prevent Failback mode for each group.
Move groups off the node on which you plan to perform the upgrade.
Exit Oracle Fail Safe Manager.
Oracle Fail Safe Manager
Oracle Universal Deinstall the Installer previous release of Oracle Fail Safe Manager and Oracle Services for MSCS. Restart the Cluster Service service Windows Services
5 6
The Cluster Service service must be restarted to eliminate all references to Fail Safe executables and message files. You must install the same release of Oracle Fail Safe software on all server nodes in the cluster. Follow the installation instructions in Chapter 2. Note: You must wait until the first node is finished restarting before you begin installing Oracle Fail Safe on other nodes. Move cluster groups that contain Oracle databases to the upgraded node. Note: To avoid problems that can arise due to version mismatches, do not use Oracle Fail Safe Manager to perform this task; use MSCS Administrator. No comments.
Install the current Oracle Fail Safe release of Oracle Fail installation CD-ROM Safe. Restart the node. Microsoft Windows
Move groups that contain Oracle databases to the upgraded node.
MSCS Administrator
Repeat steps 4 Various through 6 on the other cluster node or nodes. Install Oracle Fail Safe Manager on client nodes. Run the Verify Cluster operation. Oracle Fail Safe installation CD-ROM Oracle Fail Safe Manager
10
See the Oracle Fail Safe Release Notes for information about which releases of Oracle Fail Safe Manager can be used with various releases of Oracle Services for MSCS. Right-click the cluster name in the tree view, then select Verify Cluster. This step verifies that there are no discrepancies in the software installation (such as with the release information) on each node in the cluster, and registers resource DLLs.
11
12
Review the Verify Cluster report.
Carefully review each error or warning and take corrective action if necessary.
A-3
Upgrading or Patching a Highly Available Oracle Database
Table A1 (Cont.) (Cont.) Steps Required to Upgrade to Oracle Fail Safe Step 13 Task Restore the failback policy attributes on the groups. Move each group back to its preferred node. Tool Oracle Fail Safe Manager Comments Select a group from the Oracle Fail Safe Manager tree view, select the Failback tab, and restore the original settings (as noted in Step 1). Repeat for each group on the cluster. In the tree view, right-click the group, then select Move to a Different Node. If you are working in a two-node cluster, then you will be asked to confirm the move to the other node. If you are working in a cluster that contains more than two nodes, then you will be asked to select the destination node. This step redistributes the workload across the nodes in the cluster. 15 Run the Verify Group operation on all groups. Oracle Fail Safe Manager In the tree view, right-click a group, then select Verify Group to check all resources in all groups and confirm that they have been configured correctly. Repeat for each group in the cluster. See the Oracle Fail Safe Concepts and Administration Guide for a description of the validation tests performed during a Verify Group operation.
14
A.4 Upgrading or Patching a Highly Available Oracle Database

This section describes how to patch or perform a rolling upgrade on a database that has been configured for high availability using Oracle Fail Safe. As mentioned previously, patching typically involves updating the database from one release to another where only the fourth or fifth digit in the release number changes, for example, 9.2.0.1 to 9.2.0.2. An upgrade is required when the first, second, or third digit in the release number changes, for example 9.0.1 to 9.2.0 or 9.0.1 to 10.0.1. This section contains the following topics:

Upgrading a Database Configured for High Availability Patching an Oracle Database Configured for High Availability
A.4.1 Upgrading a Database Configured for High Availability

An upgrade requires installing a new version of the database. Typically, it is installed into its own Oracle home, separate from the earlier version of the database and from the home into which Oracle Fail Safe was installed. To save time, you can install the new database version on each cluster node while the old version of the database is still running in an Oracle Fail Safe group. Consider performing a database backup prior to any major upgrade. Perform the steps in Table A2 to perform the upgrade. Perform the steps described on one cluster node at a time.
Steps for Upgrading a Database Configured for High Availability Tool Not applicable Comments Ensure that the release of the database to which you plan to upgrade is compatible with the version of Oracle Fail Safe you are running. See the section on software compatibility in the Oracle Fail Safe Release Notes. If the Oracle Database release and the Oracle Fail Safe software release are not compatible, then see Section A.3. Use the same directory and Oracle home name on each cluster node. In the tree view, right-click the database and select Remove from Group. Repeat for each database that you plan to upgrade. Instructions for performing the upgrade are included in the database upgrade (or migration) manual for the release to which you are upgrading.
Check compatibility
Install the Oracle Oracle Universal Database software Installer on each cluster node. Remove each database from its group. Upgrade each database. Oracle Fail Safe Manager Database Migration Assistant (or perform manually) Oracle Fail Safe Manager Oracle Fail Safe Manager
5 6
Verify each standalone database Add each database back to its original group.
Right-click the database in the tree view and select Verify Standalone Database. Correct any reported problems. Right-click the database, then select Add to Group and follow the steps through the Add Resource to Group Wizard.
A.4.2 Patching an Oracle Database Configured for High Availability

When you patch a database that has been configured for high availability, it is not necessary to remove the database from the group prior to applying the patch. Table A3 describes how to patch databases configured for high availability in a two-node cluster. These steps assume that there are two nodes, Node A and Node B, and that Node A is the first node that will be patched. Perform these steps on only one cluster node at a time.
A-5
Steps for Patching a Database Configured for High Availability Tool Oracle Fail Safe Manager Comments In the tree view, select a group name, then select the Failback tab. Make a note of the current settings, and then change the setting to Prevent Failback. Repeat these steps for each group in the cluster. This step prevents the group from failing back to its current node while the node is being restarted or when the cluster service is restarted.
Change the failback attributes to Prevent Failback for each group in the cluster.
Move all groups on Node A to Node B.
Oracle Fail Safe Manager and MSCS Cluster Administrator
In the tree view, select a group from Node A, and then select Move to a Different Node. Repeat for each group on Node A. Use MSCS Cluster Administrator to move the Cluster Group if it is on Node A. By moving all groups to another node, you can work on the current node. Oracle Fail Safe will perform a checkpoint operation on any databases within a group that is moved.
Exit Oracle Fail Safe Manager and Cluster Administrator. Stop the cluster service on Node A. Stop all running Oracle applications and all remaining Oracle services. Install the database patch in the correct home on Node A.
Oracle Fail Safe Manager and MSCS Cluster Administrator
In the File menu, select Exit. (The steps are the same in both Oracle Fail Safe Manager and MSCS Cluster Administrator.)
4 5
Microsoft Control Open the Microsoft Windows Services window and then stop Panel the Cluster Services service. Microsoft Control Open the Microsoft Windows Services window and then stop Panel all running Oracle services, including the Oracle Fail Safe service and the Distributed Transaction Coordinator Service (if it is running). Oracle Universal Installer Follow the instructions that come with the patch. If you did not stop the Distributed Transaction Coordinator Service in Step 5, then it is likely that a write error for OCIW32.DLL will be returned. If this happens, then return to Step 5, stop the service, and then click RETRY in the Installer window. Changes to the initialization parameter file should be made before databases are failed back. See the readme file supplied with the database patch for information about required parameter file changes. If you are maintaining multiple copies of the initialization parameter file (because you are maintaining them on private disks), then ensure that you update the file that will be used when the database is moved back to the current node. Once the patch scripts are completed, you will change the initialization parameter file back to the original values and restart the database. Once the groups are moved back to Node A, they will be restarted and running under the patched version of the database management system. Therefore, run the patch scripts as soon as the groups are moved back. By having changed the initialization parameter file as described in Step 8, you ensure that the database starts with the parameters needed to complete the patch. See Table A4 for the steps.
Adjust the initialization parameter file, if needed.
Editor of choice for pfile, SQL ALTER SYSTEM statement for spfile.
Move groups back to Oracle Fail Safe the selected node. Manager
10
See Table A4 for instructions on migrating to a new database release.
Various
Table A3 (Cont.) (Cont.) Steps for Patching a Database Configured for High Availability Step 11 Task Restrict user access on each database to be upgraded. Tool SQL*Plus Comments As each database comes online on the selected node, restrict user access with the following SQL statement: ALTER SYSTEM ENABLE RESTRICTED SESSION; Do this as soon as possible after the database instance starts to prevent users from connecting to the database while the upgrade scripts run. You can also take the listener service for the group offline to prevent users from making Oracle Net connections. 12 Run the upgrade scripts for the patch against each database being patched. Repeat steps 4 through 7, replacing Node A in the instructions with Node B. Verify each group in the cluster. End the restricted session on each database. Verify the cluster. Restore the failback policy on each group. Move each group back to its preferred node. SQL*Plus See the readme file supplied with the database patch.
13
Various
To save time, you can run the upgrade scripts against the databases on Node A while the patch is being installed on Node B.
14 15
Oracle Fail Safe Manager SQL*Plus
In the tree view, right-click a group name, then select Verify Group. Repeat for each group in the cluster. End the restricted session on each database with the following SQL statement: SQL> ALTER SYSTEM DISABLE RESTRICTED SESSION;
16 17
Oracle Fail Safe Manager Oracle Fail Safe Manager Oracle Fail Safe Manager
In the tree view, right-click the cluster name, then select Verify Cluster. Select a group from the Oracle Fail Safe Manager tree view, select the Failback tab, and restore the original settings (as noted in step 1). Repeat for each group on the cluster. In the tree view, right-click a group name, then select Move to a Different Node. Repeat for each node in the cluster. This step balances the workload across the nodes in the cluster.
18
For information about database upgrades, refer to the Oracle Fail Safe Concepts and Administration Guide and to the upgrade instructions for Oracle Database Upgrade Assistant. For Oracle release 9.2 and later, when any type of patch is applied, the database must be started with the MIGRATE option, as shown in Table A4.
Table A4 Step 1 2 3 Task Take the database offline. Exit Oracle Fail Safe Manager. Manually start the service for the instance Steps for Starting Up a Database with the MIGRATE Option Tool Oracle Fail Safe Manager Oracle Fail Safe Manager Microsoft Windows Services Window Comments In the tree view, right-click the database, then select Take Offline. From File menu, select Exit. Instance service names are of the form, ORACLESERVICESOFS1
A-7
Upgrading Other Oracle Product Software
Table A4 (Cont.) (Cont.) Steps for Starting Up a Database with the MIGRATE Option Step 4 Task Tool Comments For example, c:\> SET ORACLE_SID=OFS1 c:\> SQLPLUS "/as sysdba" SQL> STARTUP MIGRATE See the readme file supplied with the database patch.
Start up the database SQL*Plus with the MIGRATE option.
Run the upgrade scripts against each database being patched. Shut down the database and stop the service. Place the database resource online.
SQL*Plus
SQL*Plus and Microsoft Windows Services Window Oracle Fail Safe Manager
See the readme file supplied with the database patch.
7 8
In the tree view, right-click the database, then select Place Online. You are being directed to skip step 11 in Table A3 intentionally. When you start up a database with the MIGRATE option, the session is restricted automatically.
Resume the steps in Various table Table A3, Step 12.
A.5 Upgrading Other Oracle Product Software

This section describes upgrading non-database Oracle product software and installing patches that require you to stop the Oracle services being used by Oracle Fail Safe. See Section A.4 for the same information on Oracle Database software. If your cluster is in an active/passive configuration, then you can eliminate a failover if you start the rolling upgrade on the passive cluster node. Once you have finished the upgrade on the passive cluster node, you can skip to Step 4 in Table A5. Perform the steps on only one cluster node at a time.
Table A5 Step 1 Task Steps Required to Upgrade Other Oracle Product Software Tool Comments Select a group from the Oracle Fail Safe Manager tree view, select the Failback tab, make a note of the current settings, and then change the setting to Prevent Failback. Repeat these steps for each group in the cluster. Changing the failback attributes prevents the group from failing back to the node while it is being restarted or when the cluster service is restarted. 2 Move groups off the node on which you plan to perform the upgrade. Exit Oracle Fail Safe Manager. Stop the cluster service on the node where you want to install the software. Oracle Fail Safe Manager In the Groups menu, select Move to a Different Node. By moving all groups to another node, you can work on the current node. When you use this method to move groups that contain databases, Oracle Fail Safe performs a checkpoint operation. On the current node, in the File menu, select Exit.
Change the group Oracle Fail Safe failback attributes to Manager the Prevent Failback mode.
3 4
Microsoft Control Open the Services window and stop the Cluster Service. Panel
Table A5 (Cont.) (Cont.) Steps Required to Upgrade Other Oracle Product Software Step 5 Task Stop all running Oracle applications and all remaining Oracle services. Tool Comments
Microsoft Control Open the Services window and then stop all running Oracle Panel services, including the Oracle Fail Safe service.
Install the new Oracle Universal Oracle product or Installer component software. Restart the node. Microsoft Windows
Follow the instructions that come with the Oracle product or component. Restarting the node automatically restarts the cluster service on the node where you just installed the Oracle software. Restarting the cluster service is essential for the changes to take effect. In the tree view, right-click a group name, then select Verify Group to check all resources in the group and confirm that they have been configured correctly. Repeat for each group in the cluster. No comments.
Run the Verify Group operation on all groups. Repeat steps 2 through 8 on the other server node or nodes in the cluster. Run the Verify Cluster operation.
Various
10
In the tree view, right-click the cluster name, then select Verify Cluster. This step verifies that there are no discrepancies in the software installation (such as with the release information) on each node in the cluster.
11
Restore the failback policy attributes on the groups. Move each group back to its preferred node.
Oracle Fail Safe Manager Oracle Fail Safe Manager
Select a group from the Oracle Fail Safe Manager tree view, select the Failback tab, and restore the original settings (as noted in step 1). Repeat for each group on the cluster. In the tree view, right-click a group name, then select Move to a Different Node. Repeat for each node in the cluster. This step balances the workload across the nodes in the cluster.
12
A-9
B
B
Silent Mode Installations and Deinstallations

This appendix describes how to perform a silent mode installation or deinstallation of Oracle Fail Safe. The following topics are discussed in this appendix:

Introduction to Silent Mode Installations and Deinstallations Steps for a Silent Mode Installation or Deinstallation Contents of a Response File
B.1 Introduction to Silent Mode Installations and Deinstallations

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.
B.1.1 Selecting a Response File

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
Silent Mode Installations and Deinstallations B-1
Steps for a Silent Mode Installation or Deinstallation
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:
Installation Type
Template Name
Sample Name
oracle.failsafe.complete.typical.rsp failsafe.typical.rsp Typical installation1 oracle.failsafe.complete.client.rsp oracle.failsafe.complete.custom.rsp

1
failsafe.client.rsp failsafe.custom.rsp
Client Only installation Custom installation
The Typical installation type installs all of the Oracle Fail Safe components.
B.1.2 Validating Values from the Response File

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.
B.1.3 Locating the silentInstall.log File

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.
B.2 Steps for a Silent Mode Installation or Deinstallation

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. 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.
B-2 Oracle Fail Safe Installation Guide
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 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 B1, Table B2, and Table B3.
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 Oracle Fail Safe components:
1. 2.
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.
3.
For a Client Only Installation: To install Oracle Fail Safe Manager only:
1. 2.
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:

1.
Use the oracle.failsafe.complete.custom.rsp response file template.
B-3
2.
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.
3.
4.
For a Deinstallation: To perform a deinstallation:

1. 2.
Use any one of the response file templates. Update the variables described in Table B2. These are the only variables of concern for a deinstallation.
Step 3 Run Oracle Universal Installer in silent mode. 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:

setup.exe runs 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 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
Contents of a Response File
Step 4 Delete the installation response file or move it to a secure location. 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.
B.3 Contents of a Response File

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 B1, Table B2, and Table B3. 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.
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 for each response file. For example:
[General] RESPONSEFILE_VERSION=2.2.1
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. 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
B-5
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 B1 provides a list of the variables in the Session section that can be used in a silent mode installation. Table B2 provides a list of the variables in the Session section that can be used in a silent mode deinstallation.
Table B1 Variables for the Session Section for a Silent Mode Installation Value Type Required? Yes
Variable Name FROM_LOCATION
Specifies the "From" location in the installer, String which is a directory path containing the source of the products to be installed. Specifies the label of the CD-ROM where the String 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. Specifies whether or not you will be permitted Boolean 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. Specifies whether or not you will be permitted Boolean to run another session even if the current installation has failed. This variable is active only if NEXT_SESSION is set to True.
FROM_LOCATION_CD_LABEL
No
NEXT_SESSION
No
NEXT_SESSION_ON_FAIL
Yes
Table B1 (Cont.) Variable Name
(Cont.)
Variables for the Session Section for a Silent Mode Installation Value 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. Specifies the "To" location in the installer where products are to be installed. For example, "C:\OFS" (use quotation marks). Type String Required? No
NEXT_SESSION_RESPONSE
ORACLE_HOME
String
Yes
ORACLE_HOME_NAME
Specifies the name of the current Oracle home. String For example, "OracleFailSafe" (use quotation marks). Specifies an alternative directory location for the installation. Specify False to prevent the location of the installation directory from being changed. Boolean
Yes
SHOW_COMPONENT_LOCATIONS_PAGE
No
SHOW_CUSTOM_TREE_PAGE
Specifies whether or not the custom tree page Boolean 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. 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
No
SHOW_END_SESSION_PAGE
Yes
SHOW_EXIT_CONFIRMATION
Specifies whether or not confirmation is shown Boolean when exiting the installer. Specify True to display confirmation. Specify False to suppress it. 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. 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. 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. Not applicable (NA). Boolean
No
SHOW_INSTALL_PROGRESS_PAGE
No
SHOW_RELEASE_NOTES
Boolean
No
SHOW_REQUIRED_CONFIG_TOOL_ PAGE
Boolean
No
SHOW_ROOTSH_CONFIRMATION
NA
NA
B-7
Table B1 (Cont.) Variable Name
(Cont.)
Variables for the Session Section for a Silent Mode Installation Value Type Required? No
SHOW_SPLASH_SCREEN
Boolean 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. 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. Specifies whether or not to display the welcome page. Set to true to display the welcome page. Specify false to suppress it. 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"}. Boolean
SHOW_SUMMARY_PAGE
Yes
SHOW_WELCOME_PAGE
Boolean
No
TOPLEVEL_COMPONENT
Stringlist
Yes
Table B2
Variables for the Session Section for a Silent Mode Deinstallation Value Specifies the list of components to be deinstalled. To deinstall all Oracle Fail Safe components, specify: {"oracle.failsafe.complete", "3.4.2.0.0"} Type Stringlist Required? Yes
Variable Name DEINSTALL_LIST
ORACLE_HOME
Specifies the location in the installer where the String Oracle Fail Safe product is currently installed. For example, "C:\OFS" (use quotation marks). Specifies the name of the current Oracle home. String For example, "OracleFailSafe" (use quotation marks). Specifies whether or not to confirm deinstallation during a deinstallation session. Set to true to confirm deinstallation. Set to false to suppress confirmation. Boolean
Yes
ORACLE_HOME_NAME
Yes
SHOW_DEINSTALL_CONFIRMATION
No
SHOW_DEINSTALL_PROGRESS
Specifies whether or not to display Boolean deinstallation progress during a deinstallation session. Set to true to display deinstallation progress. Set to false to suppress it.
No
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.4.2.0.0] [oracle.failsafe.server_3.4.2.0.0] 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 B3 describes the variables in the component section.

Table B3 Variables for the Component Section for a Silent Mode Installation Value 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. 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. DEPENDENCY_LIST Enter the dependent components that you want to install with Oracle Fail Stringlist 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. INSTALL_TYPE Enter the internal name for only one of the following installation types:

Variable Name DomainUserName
Type String
String
String
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. OPTIONAL_CONFIG_ TOOLS Stringlist 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.
B-9
C
C
Manually Registering Oracle Resource DLL Files

Oracle Fail Safe provides resource dynamic-link library (DLL) files for the Oracle Database and Oracle TNS Listener. The DLL files enable the Cluster Service to communicate and manage the Oracle Database and listener resources. Other Oracle resources that do not require specialized DLL files are managed as Generic Services. The following topics are discussed in this appendix:

Oracle Resource DLL Files Registering and Unregistering the Oracle Database Resource DLL Files
C.1 Oracle Resource DLL Files

Oracle Services for MSCS includes the resource DLL files shown in Table C1. These files enable MSCS to communicate with and manage the Oracle resource types.
Table C1 File FsResOdbs.dll Oracle Resource DLL Files Type Oracle Database, Oracle TNS Listener, and Oracle resource type DLL file Description Provides functions to allow the cluster to bring an Oracle resource online or offline and check the health of the resource through Is Alive polling. When the resource is online, the Oracle resource DLL guarantees that the resource is accessible by the client. Otherwise, the Is Alive polling fails. Used by MSCS Cluster Administrator to display the properties of the Oracle Database resource. Used by MSCS Cluster Administrator to display the properties of the Oracle TNS Listener resource.
FsResOdbsEx.dll
Oracle Database resource administration extension DLL file
FsResTnsLsnrEx.dl Oracle TNS Listener l resource extension DLL file
As with other cluster resources, you can apply all advanced properties of controlling the failover parameters to these Oracle resources. You can control:
How often MSCS should poll the Oracle resource health (Looks Alive, Is Alive polling intervals) Whether a database resource should be restarted when it fails, and, if so, how many times MSCS should attempt to restart it before failing over to the other node How long MSCS should wait before declaring failure of the resource (pending timeout) during the startup and shutdown of the resource
C-1
Registering and Unregistering the Oracle Database Resource DLL Files
If the resource takes longer than the time you specified with the pending timeout parameter to come online or go offline and the resource DLL did not detect any problems in the online or offline process, then the resource DLL asks MSCS to give it more time to complete the process. Thus, you do not have to be concerned if a resource occasionally takes longer to come online or go offline.
Note:
If MSCS is unable to bring an Oracle Database resource online, or if the Is Alive polling fails, then the Oracle resource DLL logs a Microsoft Windows event under the OracleMCSServices source to indicate the reason.
C.2 Registering and Unregistering the Oracle Database Resource DLL Files
Typically, the Oracle Fail Safe Verify Cluster operation automatically verifies the Oracle Database and listener resource DLL files and their registration with the MSCS software. If the Verify Cluster operation finds that the DLL files are not registered, it registers them with the MSCS software. Using the Verify Cluster operation is the preferred method for registering DLL files. However, if you find that the Oracle resource DLL files are not registered properly, then you can use the commands in Section C.2.1 and Section C.2.2 to manually register or unregister them.
C.2.1 Oracle Resource DLL Files

To register the Oracle Database resource DLL files, use the following commands:
fssvr /register "Oracle Database" FsResOdbs.dll fssvr /register "Oracle TNS Listener" FsResOdbs.dll
To unregister the Oracle Database resource DLL files, use the following commands:
fssvr /unregister "Oracle Database" fssvr /unregister "Oracle TNS Listener"
C.2.2 Oracle Resource Administrator Extension DLL Files

To register the Oracle Database resource administrator extension DLL files on the cluster nodes, use the following commands:
fsregadm /r FsResOdbsEx.dll fsregadm /r FsResTnsLsnrEx.dll
To unregister the Oracle Database resource administrator extension DLL files on the cluster nodes, use the following commands:
fsregadm /u FsResOdbsEx.dll fsregadm /u FsResTnsLsnrEx.dll
If MSCS Cluster Administrator is installed on a node that is not a member of a cluster, you need to register the Oracle Database resource administrator extension DLL with the cluster so that you can view Oracle Database resource parameters from the MSCS Cluster Administrator. To register, use the fsregadm command. You must issue the command from the bin directory where Oracle Fail Safe Manager is installed (because Oracle Fail Safe Manager is not in the path environment variable). For example:
C-2 Oracle Fail Safe Installation Guide
fsregadm /r /c Cluster1 FsResOdbsEx.dll fsregadm /r /c Cluster1 FsResTnsLsnrEx.dll
You must specify the cluster name with the /c option; otherwise the command will fail.
C-3
C-4 Oracle Fail Safe Installation Guide
Index
A
adding a new node to the cluster, 1-4 administration deinstalling software on a cluster, 4-1 installing Oracle Fail Safe, 2-1 patching software, A-1 registering Oracle resource DLLs, C-1 starting Oracle Fail Safe Manager, 3-1 troubleshooting installation problems, 5-1 upgrading software, A-1 verifying the Oracle Fail Safe installation, 3-1 Administrator privileges, 2-1 required for cluster alias, 1-4 alert files location, 1-4 application data files installing, 1-4 application software installing, 1-3 applications files on private disks, 1-3 files on shared storage devices, 1-3 authentication connecting to cluster, 3-3 for an Oracle Fail Safe installation, 2-1 Oracle Services for MSCS and, 3-4 cluster metadata, 5-2 cluster nodes adding, 1-4 cluster alias specification, 3-3 connecting to, 3-3 insufficient space, 2-4 order of software installations, 1-2 setting up, 1-1 upgrading software on, A-1 verifying, 3-3 cluster systems metadata, 4-1 Microsoft hardware compatibility list, 1-1 verifying after an installation, 3-3 Component section response file for deinstallation and, B-8 response file for installation and, B-8 components installing, 2-3 Connect to Oracle Fail Safe Cluster dialog box, Custom installation sample file, B-2 template file, B-2
3-3
D
DEINSTALL_LIST variable, B-8 deinstallations Microsoft Cluster Server (MSCS) software, 4-1 Oracle Fail Safe release 3.0, 4-1 reasons for, 4-1 response file component section, B-8 silent mode, B-1 steps, 4-1 troubleshooting, 5-1 DEPENDENCY_LIST variable, B-9 destination directory for Oracle Fail Safe installations, 2-2 disk devices insufficient space for installations, 2-4 private and cluster installations, 1-3 DLL files FsResOdbs.dll, C-1 FsResOdbsEx.dll, C-1 FsResTnsLsnrEx.dll, C-1
C
checklists cluster setup, 1-1 installation order, 1-2 preinstallation of Oracle Fail Safe software, 2-1 Client Only installation sample file, B-2 specifying, 2-3 template file, B-2 clients preparing for upgrades, A-1 cluster alias connecting to, 1-4 supplying when connecting to cluster, 3-3 cluster disks software and file installations, 1-3 Cluster Group
Index-1
Oracle resources, C-1 registering manually, C-1 registering Oracle resource administrator, C-2 registering Oracle resources, C-2 registration, C-2 unregistering Oracle resource administrator, C-2 unregistering Oracle resources, C-2 domain connecting to cluster, 3-3 log on to install Oracle Fail Safe, 2-1 user account for Oracle Fail Safe, 2-4 DomainUserName variable, B-3, B-9 dynamic-link library (DLL) files See DLL files
E
errors See troubleshooting executable application files installing, 1-4
installations alert and trace files, 1-4 application data, 1-4 executable application files, 1-4 log files, 1-4 Oracle Fail Safe, 2-1 to 2-4 preparation for, 1-1 recommended order for software, 1-2 silent mode, B-1 trace files, 1-4 troubleshooting MSCS, 5-1 Web server components, 2-3 See also Oracle Installer, Oracle Universal Installer installing application software, 1-3 Oracle Database software, 1-3 IP addresses mapping to host names, 5-2 Is Alive polling DLL file function, C-1 failure, C-2
F
failback policy, A-7 failover planned, A-7 File Locations dialog box, 2-2 FROM_LOCATION variable, B-6 FROM_LOCATION_CD_LABEL variable, FsResOdbs.dll file functions, C-1 registering, C-2 unregistering, C-2 FsResOdbsEx.dll file functions, C-1 registering, C-2 unregistering, C-2
L
log files installing on a cluster, 1-4 silent deinstallation, B-2 silent installation, B-2 B-6
M
managing Oracle Fail Safe, 3-3 Microsoft Cluster Server See MSCS Microsoft hardware compatibility list, 1-1 Microsoft Windows 2000 installation, 1-2 recommended order for installation, 1-2 MSCS deinstallation, 4-1 to ?? Is Alive polling, C-1 prerequisites for installing, 1-1 troubleshooting deinstallations, 5-1 unable to bring Oracle resource online, C-2 MSCS Cluster Administrator, C-2 displaying Oracle Database resource properties with, C-1 displaying Oracle TNS Listener resource properties with, C-1 Oracle Services for MSCS resource in Cluster Group, 3-4 starting, 3-4
G
General section response file, B-5 groups removing resources from before deinstallation, 4-1
H
Help invoking Oracle Fail Safe tutorial with, Oracle Fail Safe Manager, 3-5 host names mapping to IP addresses, 5-2 1-4
I
INSTALL_TYPE variable, B-9 Custom value, B-4, B-9 install_type_1 value, B-3, B-9 Typical value, B-3, B-9
N
network configuration troubleshooting, 5-2 new nodes adding to a cluster, 1-4 NEXT_SESSION variable, B-6
Index-2
NEXT_SESSION_ON_FAIL variable, B-6 NEXT_SESSION_RESPONSE variable, B-7
O
online help, 3-5 OPTIONAL_CONFIG_TOOLS variable, B-9 Oracle Database resource administration extension DLL file, C-1 Oracle Database resource DLL files, C-1 Oracle Database software installing, 1-3 patching, A-5 special considerations for patching, A-7 steps for patching, A-6 steps for starting up with the MIGRATE options, A-7 steps for upgrading, A-5 Oracle Fail Safe software patching, A-2 requirements for upgrading, A-2 steps for upgrading, A-3 upgrading, A-2 Oracle homes for Oracle Fail Safe installations, 2-2 installing application software and, 1-3 installing database software and, 1-3 Oracle Net configuration, 1-1 Oracle Universal Installer, 1-1 deinstallations, 4-2 invoking at the command-line prompt, B-4 starting, 2-2 ORACLE_HOME variable, B-3, B-7, B-8 ORACLE_HOME_NAME variable, B-3, B-7, B-8 OracleMSCSServices service verifying, 3-4
cluster nodes, 2-4 registering Oracle Database resource administration extension DLL file, C-1 Oracle Database resource DLL files, C-1 Oracle resource administrator DLL files, C-2 Oracle resource DLL files, C-2 Oracle resource DLL files on noncluster nodes, C-2 resources DLL files, C-1 response file template for deinstallation, B-2 response file templates for installation, B-1 response files contents of, B-5 copying, B-2 editing, B-3 General section, B-5 installation and component section, B-8 invoking, B-4 Session section, B-5 use in silent deinstallations, B-1 use in silent installations, B-1 validating variable values in, B-2 rolling upgrades See upgrades
S
security domain user account for Oracle Fail Safe, 2-4 services verifying OracleMSCSServices service entry, 3-4 Services Control Panel startup status for Oracle Fail Safe, 3-4 Session section response file, B-5 variables and values for silent deinstallation, B-8 variables and values for silent installation, B-6 setup.exe program starting Oracle Universal Installer, B-4 shared storage devices alert and trace files, 1-4 SHOW_COMPONENT_LOCATIONS_PAGE variable, B-7 SHOW_CUSTOM_TREE_PAGE variable, B-7 SHOW_DEINSTALL_CONFIRMATION variable, B-8 SHOW_DEINSTALL_PROGRESS variable, B-8 SHOW_END_SESSION_PAGE variable, B-7 SHOW_EXIT_CONFIRMATION variable, B-7 SHOW_INSTALL_PROGRESS_PAGE variable, B-7 SHOW_RELEASE_NOTES variable, B-7 SHOW_REQUIRED_CONFIG_TOOL_PAGE variable, B-7 SHOW_ROOTSH_CONFIRMATION variable, B-7 SHOW_SPLASH_SCREEN variable, B-8 SHOW_SUMMARY_PAGE variable, B-8
P
patch steps Oracle Database software, A-6 patches highly available Oracle Databases, A-4 Oracle Database software, A-5 special considerations, A-7 Oracle Fail Safe software, A-2 planned failover, A-7 prior to a rolling upgrade, A-1 prerequisites for installing MSCS, 1-1 for installing Oracle Fail Safe, 2-1 private disks alert files on, 1-4 software and file installations, 1-3 trace files on, 1-4 Pwd variable, B-3, B-9
R
rebooting
Index-3
SHOW_WELCOME_PAGE variable, B-8 silent deinstallation, B-1 Component section of response file and, B-8 General section of response file and, B-5 invoking, B-4 log files, B-2 response file definition, B-1 Session section of response file and, B-5 Session section response file variables, B-8 status logged in silentInstall.log file, B-2 silent installation, B-1 Component section of response file and, B-8 General section of response file and, B-5 invoking, B-4 log files, B-2 response file definition, B-1 Session section of response file and, B-5 session section response file variables, B-6 status logged in silentInstall.log file, B-2 silentInstall.log file, B-2 software installations and upgrades preparing cluster for, 1-1 recommended order, 1-2 space requirements for installations, 2-4 starting MSCS Cluster Administrator, 3-4 Oracle Fail Safe Manager, 3-1 Oracle Universal Installer, B-4
U
unregistering Oracle resource administrator DLL files, C-2 upgrade steps Oracle Database software, A-5 Oracle Fail Safe software, A-3 other Oracle product software, A-8 upgrades highly available Oracle Databases, A-4 Oracle Fail Safe software, A-2 other Oracle products, A-8 performing, A-1 preparing users for, A-1 recommended order of, A-2 rolling, A-1 steps for other Oracle products, A-8 user name supplying when connecting to cluster, 3-3
V
variables DEINSTALL_LIST, B-8 DEPENDENCY_LIST, B-9 DomainUserName, B-3, B-9 FROM_LOCATION, B-6 FROM_LOCATION_CD_LABEL, B-6 in Session section of response file, B-5 INSTALL_TYPE, B-3, B-4, B-9 NEXT_SESSION, B-6 NEXT_SESSION_ON_FAIL, B-6 NEXT_SESSION_RESPONSE, B-7 OPTIONAL_CONFIG_TOOLS, B-9 ORACLE_HOME, B-3, B-7, B-8 ORACLE_HOME_NAME, B-3, B-7, B-8 Pwd, B-3, B-9 SHOW_COMPONENT_LOCATIONS_ PAGE, B-7 SHOW_CUSTOM_TREE_PAGE, B-7 SHOW_DEINSTALL_CONFIRMATION, B-8 SHOW_DEINSTALL_PROGRESS, B-8 SHOW_END_SESSION_PAGE, B-7 SHOW_EXIT_CONFIRMATION, B-7 SHOW_INSTALL_PROGRESS_PAGE, B-7 SHOW_RELEASE_NOTES, B-7 SHOW_REQUIRED_CONFIG_TOOL_PAGE, B-7 SHOW_ROOTSH_CONFIRMATION, B-7 SHOW_SPLASH_SCREEN, B-8 SHOW_SUMMARY_PAGE, B-8 SHOW_WELCOME_PAGE, B-8 TOPLEVEL_COMPONENT, B-8 Verify Cluster operation running after installation, 1-4, 3-3
T
TCP/IP network protocol support, 1-1 templates for response files, B-1 tnsnames.ora file checking Oracle Net configuration data, 1-1 TOPLEVEL_COMPONENT variable, B-8 trace files location, 1-4 troubleshooting FS-10514 error message, 5-2 FS-10515 error message, 5-2 FSCMD scripts, 5-1 installations, 5-1 MSCS installations, 5-1 network configuration problems, 5-2 Oracle Fail Safe and MSCS deinstallations, 5-1 Oracle Services for MSCS installations, 5-1 user rights policy, 5-2 tutorial, 3-5 for Oracle Fail Safe Manager, 3-5 invoking, 1-4 Typical installation sample file, B-2 template file, B-2
W
Web server installing components for, 2-3
Index-4

OFS - Oracle Fail Safe

Transféré par

Informations du document

Description originale:

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

OFS - Oracle Fail Safe

Transféré par

Droits d'auteur :

Formats disponibles

Oracle Fail Safe

Installation Guide Release 3.4.2 for Microsoft Windows

Contributing Author: Contributor:

1 Introduction and Preinstallation Checklist

2 Installing Oracle Fail Safe

4 Deinstalling Oracle Fail Safe

5 Troubleshooting Installation Problems

5.3 5.4 5.5

Rolling Upgrades and Patches

B Silent Mode Installations and Deinstallations

C Manually Registering Oracle Resource DLL Files

For information about related products, refer to the following documentation:

Introduction and Preinstallation Checklist

1.1 Cluster Setup Prerequisites

Introduction and Preinstallation Checklist

1.2 Software Compatibility

1.3 Recommended Order for Software Installation

On each cluster node, install:

1-2 Oracle Fail Safe Installation Guide

Recommended Order for Software Installation

Cluster Disks Executable Application Files:

Executable Application Files:

Application Data and Log Files:

Introduction and Preinstallation Checklist

Adding a Node to an Existing Cluster

1.4 Adding a Node to an Existing Cluster

1.5 Adding a Sample Database

1.6 Postinstallation Procedures

If you installed optional Oracle software:

1-4 Oracle Fail Safe Installation Guide

Introduction and Preinstallation Checklist

1-6 Oracle Fail Safe Installation Guide

Installing Oracle Fail Safe

2.1 Review the PreInstallation Checklist

Installing Oracle Fail Safe 2-1

Install the Oracle Fail Safe Software

2.2 Install the Oracle Fail Safe Software

2-2 Oracle Fail Safe Installation Guide

Install the Oracle Fail Safe Software

Select an installation type:

Installing Oracle Fail Safe 2-3

Install the Oracle Fail Safe Software

2-4 Oracle Fail Safe Installation Guide

3.1.1 Start Oracle Fail Safe Manager

Getting Started 3-1

Figure 31 Adding a Cluster to the Tree View

3-2 Oracle Fail Safe Installation Guide

3.1.2 Connect to the Cluster

3.1.3 Run Verify Cluster

The Oracle homes are identical on all nodes

3.1.4 Verify the OracleMSCSServices Service Entry

Perform steps 1 and 2 on each cluster node.

3-4 Oracle Fail Safe Installation Guide

Oracle Fail Safe Manager Tutorial and Online Help

Figure 33 Oracle Services for MSCS in the Cluster Administrator Window

3.2 Oracle Fail Safe Manager Tutorial and Online Help

Getting Started 3-5

Oracle Fail Safe Manager Tutorial and Online Help

3-6 Oracle Fail Safe Installation Guide

Deinstalling Oracle Fail Safe

Deinstalling Oracle Fail Safe Release 3.n Software

4.1 Deinstalling Oracle Fail Safe Release 3.n Software

Deinstalling Oracle Fail Safe 4-1