Oracle Fail Safe Tutorial Release 3.3.1 for Windows April 2002 Part No. Not Orderable This tutorial provides step-by-step instructions on using Oracle Fail Safe to make resources highly available.
Oracle Fail Safe Tutorial, Release 3.3.1 for Windows Part No. Not Orderable Copyright 1999, 2002, Oracle Corporation. All rights reserved. The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable: Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the Programs. Oracle is a registered trademark, and Oracle9i and JInitiator are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners.
Contents Send Us Your Comments... ix Preface... xi Intended Audience... Documentation Accessibility... Structure... Related Documents... Conventions... xi xi xii xiii xiv 1 Using This Tutorial 2 Invoking Oracle Fail Safe Manager and Verifying the Cluster 2.1 Invoking Oracle Fail Safe Manager... 2-2 2.2 Populating the Tree View... 2-3 2.3 Adding a Cluster to a Populated Tree View... 2-4 2.4 Using the Add Cluster to Tree Dialog Box... 2-5 2.5 Connecting to the Cluster... 2-6 2.6 Using the Connect to Cluster Dialog Box... 2-7 2.7 Verifying the Cluster... 2-8 2.8 Viewing the Results of the Verify Cluster Operation... 2-9 3 Creating a Group 3.1 Invoking the Create Group Wizard... 3-2 iii
3.2 Naming and Describing the Group... 3-3 3.3 Specifying the Failback Policy... 3-4 3.4 Specifying the Preferred Nodes... 3-5 3.5 Finishing Creating a Group... 3-6 3.6 Responding to the Virtual Address Question... 3-7 4 Adding a Virtual Address to a Group 4.1 Opening the Add Resource to Group Wizard... 4-2 4.2 Specifying the Resource Type and Group... 4-3 4.3 Describing the Network... 4-4 4.4 Finishing Adding the Virtual Address... 4-5 4.5 Viewing the Group Properties... 4-6 5 Creating a Sample Single-Instance Database 5.1 Opening the Create Sample Database Dialog Box... 5-2 5.2 Using the Create Sample Database Dialog Box... 5-3 5.3 Starting the Default Oracle Intelligent Agent... 5-4 5.4 Viewing the Progress of the Clusterwide Operation... 5-5 6 Verifying a Standalone Single-Instance Database 6.1 Using the Verify Standalone Database Command... 6-2 6.2 Using the Verify Standalone Database Dialog Box... 6-3 6.3 Viewing the Progress of the Clusterwide Operation... 6-4 7 Adding a Single-Instance Database to a Group 7.1 Invoking the Add Resource to Group Wizard... 7-2 7.2 Using the Add Resource to Group Wizard... 7-3 7.3 Specifying the Database Identity... 7-4 7.4 Selecting a Database Authentication Method... 7-5 7.5 Adding the Account to the Windows ORA_<SID>_DBA Group... 7-6 7.6 Specifying a Password File... 7-7 7.7 Finishing Adding the Database... 7-8 7.8 Shutting Down the Database... 7-9 7.9 Viewing the Progress of the Clusterwide Operation... 7-10 iv
8 Verifying a Group 8.1 Using the Verify Group Command... 8-2 8.2 Viewing Progress... 8-3 9 Balancing the Workload 9.1 Initial Set Up for Performing a Planned Failover... 9-2 9.2 Moving the Sales Group... 9-3 9.3 Confirming the Move Group Operation... 9-4 9.4 Finishing Moving the Group... 9-5 9.5 Moving the Marketing Group... 9-6 9.6 Moving the Customers Group... 9-7 9.7 Checking the Preferred Owner Nodes List... 9-8 9.8 Rearranging the Preferred Nodes List... 9-9 9.9 Viewing the Balanced Workload... 9-10 10 Identifying the Location of Fail-Safe Databases to Client Applications 10.1 Updating the tnsnames.ora File... 10-2 11 Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11.1 Using the Add Resource to Group Wizard... 11-3 11.2 Specifying the Resource and Group... 11-4 11.3 Specifying the Forms Server Identity... 11-5 11.4 Specifying the Forms Server Parameters... 11-6 11.5 Specifying the Forms Server Path... 11-7 11.6 Specifying the Database Used by the Forms Server... 11-8 11.7 Finishing Creating and Adding the Forms Server... 11-9 11.8 Monitoring the Clusterwide Operation... 11-10 11.9 Adding an Oracle HTTP Server to the Group... 11-11 11.10 Specifying the Resource and Group... 11-12 11.11 Specifying the Oracle HTTP Server Name... 11-13 11.12 Specifying Default Files... 11-14 11.13 Specifying the Virtual Directory... 11-15 11.14 Specifying the Virtual Address... 11-17 v
11.15 Finishing Creating and Adding the Web Server... 11-18 11.16 Monitoring the Clusterwide Operation... 11-19 11.17 Adjusting the WebForm.htm File... 11-20 11.18 Viewing the Fail-Safe Form, Part One... 11-21 11.19 Viewing the Fail-Safe Form, Part Two... 11-22 12 Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12.1 Invoking the Add Resource to Group Wizard... 12-3 12.2 Specifying the Resource and Group... 12-4 12.3 Specifying the Reports Server Identity... 12-5 12.4 Specifying the Reports Server Disks and Directories... 12-6 12.5 Specifying the Database Used by the Reports Server... 12-7 12.6 Specifying an Account for the Reports Server to Use... 12-8 12.7 Finishing Creating and Adding a Reports Server... 12-9 12.8 Monitoring the Clusterwide Operation... 12-10 12.9 Adding an Oracle HTTP Server to the Group... 12-11 12.10 Specifying the Resource and Group... 12-12 12.11 Specifying the Oracle HTTP Server Name... 12-13 12.12 Specifying Default Files... 12-14 12.13 Specifying the First Virtual Directory... 12-15 12.14 Specifying the Second Virtual Directory... 12-16 12.15 Specifying the Virtual Address... 12-17 12.16 Finish Creating and Adding the Oracle HTTP Server... 12-18 12.17 Monitoring the Clusterwide Operation... 12-19 12.18 Adjusting the WebReport.htm File... 12-20 12.19 Viewing the Fail-Safe Report, Page One... 12-21 12.20 Viewing the Fail-Safe Report, Page Two... 12-22 13 Removing a Resource from a Group 13.1 Using the Remove from Group Command... 13-2 13.2 Confirmation Request... 13-3 13.3 Monitoring the Clusterwide Operation... 13-4 vi
14 Deleting a Standalone Resource from the Cluster 14.1 Using the Delete Standalone Command... 14-2 14.2 Confirming the Delete Standalone Command... 14-3 15 Deleting a Sample Database from the Cluster 15.1 Using the Delete Sample Database Command... 15-2 15.2 Confirming the Delete Sample Database Command... 15-3 15.3 Authenticating Your Privileges to Delete the Database... 15-4 15.4 Starting the Default Oracle Intelligent Agent... 15-5 15.5 Viewing the Progress of the Clusterwide Operation... 15-6 16 Deleting a Group from the Cluster 16.1 Using the Delete Group Command... 16-2 16.2 Confirming the Delete Group Command... 16-3 vii
viii
Send Us Your Comments Oracle Fail Safe Tutorial, Release 3.3.1 for Windows Part No. Not Orderable Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this publication. Your input is an important part of the information used for revision. Did you find any errors? Is the information clearly presented? Do you need more information? If so, where? Are the examples correct? Do you need more examples? What features did you like most about this manual? If you find any errors or have any other suggestions for improvement, please indicate the title and part number of the documentation and the chapter, section, and page number (if available). You can send comments to us in the following ways: Electronic mail: nedc-doc_us@oracle.com FAX: 603.897.3825. Attn: Oracle Fail Safe Documentation Postal service: Oracle Corporation Oracle Fail Safe Documentation One Oracle Drive Nashua, NH 03062-2804 USA If you would like a reply, please give your name, address, telephone number, and electronic mail address (optional). If you have problems with the software, please contact your local Oracle Support Services. ix
x
Preface Intended Audience Oracle Fail Safe supports a wide variety of high-availability business solutions on Windows clusters. Oracle Fail Safe support includes Oracle databases, Web servers, Oracle Forms and Reports Servers, and all applications that can be configured as a Windows service. This guide provides step-by-step procedures to help you learn how to implement high-availability solutions with Oracle Fail Safe. This guide is intended for anyone who wants to learn the basic operations of Oracle Fail Safe on Windows systems. Documentation Accessibility Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. 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. Standards will continue to evolve over time, and Oracle Corporation 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 additional information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/ xi
Structure This guide contains 16 lessons: Chapter 1 This chapter contains an introduction and configuration information. Chapter 2 This chapter contains instructions on verifying a cluster. Chapter 3 This chapter contains instructions on creating a group. Chapter 4 This chapter contains instructions on adding a virtual address to a group. Chapter 5 This chapter contains instructions on creating a sample single-instance database. Chapter 6 This chapter contains instructions on verifying a standalone single-instance database. Chapter 7 This chapter contains instructions on adding a single-instance database to a group. Chapter 8 This chapter contains instructions on verifying a group. Chapter 9 This chapter contains instructions on balancing the workload across the cluster nodes. Chapter 10 This chapter contains instructions on updating the tnsnames.ora file. xii
Chapter 11 This chapter contains instructions on adding an Oracle Forms Server and an Oracle HTTP Server to a group. Chapter 12 This chapter contains instructions on adding an Oracle Reports Server and an Oracle HTTP Server to a group. Chapter 13 This chapter contains instructions on removing a resource from a group. Chapter 14 This chapter contains instructions on deleting a standalone resource from the cluster. Chapter 15 This chapter contains instructions on deleting a sample database. Chapter 16 This chapter contains instructions on deleting a group from the cluster. Related Documents In addition to this document, the Oracle Fail Safe documentation set includes the following: Oracle Fail Safe Release Notes Oracle Fail Safe Concepts and Administration Guide Oracle Services for MSCS Error Messages Oracle Fail Safe Installation Guide For online assistance, Oracle Fail Safe Manager provides online help topics, a quick tour, and this tutorial. On the Help menu in Oracle Fail Safe Manager, click "Search for Help on" to access the online help topics. Refer to the following documentation for information about related products: For more information about cluster systems, see the Microsoft Cluster Server (MSCS) documentation. xiii
For more information about other related products, see the documentation for those products. Conventions The following conventions are also used in this manual: Convention... Meaning Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.... Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted boldface text Boldface type in text indicates a term defined in the text. < > Angle brackets enclose user-supplied names. [ ] Brackets enclose optional clauses from which you can choose one or none. xiv
1 Using This Tutorial This chapter provides information that you need to know before using this tutorial. Intended Uses This tutorial is designed to be used in one of two ways: As a quick overview of the steps needed to configure resources (such as single-instance databases, Oracle Forms Servers, Oracle Reports Servers, and Oracle HTTP Servers) to be highly available using Oracle Fail Safe As a step-by-step introduction to using Oracle Fail Safe Manager If you intend to use the tutorial this way, first ask your cluster administrator for at least five IP addresses that you can use on the cluster for virtual addresses. In addition, it is best to follow the lessons in order. This tutorial provides the basic steps for configuring resources to make them highly available; it does not provide detailed information on the concepts behind high availability. You may find it helpful to refer to the Oracle Fail Safe Concepts and Administration Guide while using this tutorial. Cluster Setup This tutorial is intended to be run on a two-node cluster. Terminology The following terminology is frequently used in this tutorial: Cluster: A group of independent computing systems that operates as a single virtual system. Using This Tutorial 1-1
Failover: The process of taking cluster resources offline on one node and bringing them back online on another node. This process can either be planned (upgrades or maintenance) or unplanned (system failure). Group: A logical collection of cluster resources that forms a minimal unit of failover. In a failover situation, the group is moved to a failover node. A group resides on only one cluster node at a time. Resource: A physical or logical component that is available to a computing system. For example, disks, the network IP address, Forms Servers, Reports Servers, and Web servers are resources. Virtual address: A network address at which the resources of a group can be accessed, regardless of the hardware server hosting those resources. Virtual server: A group with one or more virtual addresses. Requirements The following lists specify the requirements for the lessons of the tutorial. See the Oracle Fail Safe Release Notes for a list of supported software releases. Creating a Sample Single-Instance Database A supported release of the Oracle database software is installed. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group Oracle9i Application Server is installed on both cluster nodes. (The installation must be an enterprise deployment installation.) Oracle JInitiator release 1.1.8.7 or higher is installed on the client where you intend to view the form served by the Oracle Forms Server. (To install this version of JInitiator, double-click <Oracle_Home>\fs\fsmgr\jinit1187.exe, where <Oracle_Home> is the Oracle home where you installed Oracle Fail Safe. Oracle HTTP Server is installed on both cluster nodes. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group Oracle9i Application Server is installed on both cluster nodes. (The installation must be an enterprise deployment installation.) Oracle JInitiator release 1.1.8.7 or higher is installed on the client where you intend to view the form served by the Reports Server. (To install this version of JInitiator, double-click <Oracle_Home>\fs\fsmgr\jinit1187.exe, where <Oracle_ Home> is the Oracle home where you installed Oracle Fail Safe. 1-2 Oracle Fail Safe Tutorial
Oracle HTTP Server is installed on both cluster nodes. Using This Tutorial 1-3
1-4 Oracle Fail Safe Tutorial
2 Invoking Oracle Fail Safe Manager and Verifying the Cluster This chapter describes the steps necessary to invoke Oracle Fail Safe Manager and to verify the cluster. Invoking Oracle Fail Safe Manager and Verifying the Cluster 2-1
Invoking Oracle Fail Safe Manager 2.1 Invoking Oracle Fail Safe Manager To invoke Oracle Fail Safe Manager from the taskbar, click the Start button, select Programs, then the Oracle home into which you installed Oracle Fail Safe Manager, then select Oracle Fail Safe Manager. In this example, the Oracle home is Ofs. 2-2 Oracle Fail Safe Tutorial
Populating the Tree View 2.2 Populating the Tree View When you invoke Oracle Fail Safe Manager, the Manager opens and if no clusters have been added to the tree view previously, the Add Cluster to Tree dialog box opens. If this dialog box opens, enter the cluster alias of the cluster you want to manage. If the tree view is already populated, but the cluster you want to manage is not in the tree view, see Section 2.3. Invoking Oracle Fail Safe Manager and Verifying the Cluster 2-3
Adding a Cluster to a Populated Tree View 2.3 Adding a Cluster to a Populated Tree View If the tree view already contains a list of clusters, but not the one you want to manage, you can add a cluster to the populated tree view. On the File menu, select Add Cluster to Tree. 2-4 Oracle Fail Safe Tutorial
Using the Add Cluster to Tree Dialog Box 2.4 Using the Add Cluster to Tree Dialog Box Enter the alias for the cluster that you want to manage in the Cluster Alias field, then click OK. Invoking Oracle Fail Safe Manager and Verifying the Cluster 2-5
Connecting to the Cluster 2.5 Connecting to the Cluster After the tree view is populated with one or more cluster aliases, you must connect to the cluster or clusters before you can manage them with Oracle Fail Safe Manager. In the tree view, select the cluster to which you want Oracle Fail Safe Manager to connect. Then, on the File menu, select Connect to Cluster. Oracle Fail Safe opens the Connect to Cluster dialog box. 2-6 Oracle Fail Safe Tutorial
Using the Connect to Cluster Dialog Box 2.6 Using the Connect to Cluster Dialog Box Enter a user name and password for a domain account that has Administrator privileges on all nodes of the cluster to which you want to connect. Next, enter the account domain name. Select Save As Local Preferred Credentials if you want Oracle Fail Safe Manager to save the connection information in a file on the local system (the password will be encrypted). If you save local preferred credentials, the next time you open Oracle Fail Safe Manager, you can automatically connect to the cluster by expanding the tree view for that cluster. Invoking Oracle Fail Safe Manager and Verifying the Cluster 2-7
Verifying the Cluster 2.7 Verifying the Cluster Before beginning work with Oracle Fail Safe Manager, verify that the cluster hardware and software are correctly configured by using the Verify Cluster command. If this is your first time using Oracle Fail Safe with this cluster, a window asking you to verify the cluster opens immediately after you connect to the cluster. To verify the cluster, click the Verify Cluster button. If this is not your first time using Oracle Fail Safe with this cluster, on the Troubleshooting menu, select Verify Cluster. 2-8 Oracle Fail Safe Tutorial
Viewing the Results of the Verify Cluster Operation 2.8 Viewing the Results of the Verify Cluster Operation Oracle Fail Safe displays the progress of the Verify Cluster operation. Invoking Oracle Fail Safe Manager and Verifying the Cluster 2-9
Viewing the Results of the Verify Cluster Operation 2-10 Oracle Fail Safe Tutorial
3 Creating a Group This chapter describes the steps necessary to create a group with Oracle Fail Safe Manager. Creating a group is the first step in making most resources (such as single-instance databases, Forms Servers, Reports Servers, and Oracle HTTP servers) highly available. Creating a Group 3-1
Invoking the Create Group Wizard 3.1 Invoking the Create Group Wizard In the tree view, select the cluster on which you want to create a group. Then, on the Groups menu, select Create to open the Create Group Wizard. 3-2 Oracle Fail Safe Tutorial
Naming and Describing the Group 3.2 Naming and Describing the Group The Create Group Wizard steps you through the process of creating a group. Enter FSTutorial as the name of the group, and if you want, enter a description of the group. Creating a Group 3-3
Specifying the Failback Policy 3.3 Specifying the Failback Policy The Failback policy determines whether a group that has previously failed over is returned to the node on which you prefer it to run when that node comes back online. Select "Allow failback." Then select "Fail back between" and enter 2 and then 3. This specifies that if a previously unavailable node comes back online, failback will be scheduled to occur between the hours of 2 a.m. and 3 a.m. See the Oracle Fail Safe Concepts and Administration Guide for more information on the various failback policy options. 3-4 Oracle Fail Safe Tutorial
Specifying the Preferred Nodes 3.4 Specifying the Preferred Nodes A preferred node is the node on which you want the group to run when all cluster nodes are running. When a previously unavailable node comes back online, the cluster software reads the preferred nodes list to determine if the group should be failed back to a preferred node. The first running node in the preferred nodes list is the one to which the group will fail back. If you do not specify a preferred nodes list, failback is disabled and the group will never fail back. Move one of the nodes in the Available Nodes list to the Preferred Nodes list. Creating a Group 3-5
Finishing Creating a Group 3.5 Finishing Creating a Group Before the group is created, you have an opportunity to review the properties you have selected. If the properties are incorrect, click Cancel and then Back to make corrections. If the properties are correct, click OK, and Oracle Fail Safe will create the group. 3-6 Oracle Fail Safe Tutorial
Responding to the Virtual Address Question 3.6 Responding to the Virtual Address Question After creating the group, Oracle Fail Safe asks if you want to add a virtual address to the group. When a group contains a virtual address, the group is accessible by clients at the same network address, regardless of which cluster node is hosting the group. If you click Yes, Oracle Fail Safe opens the Add Virtual Address Wizard immediately. Typically, you would click Yes. However, for the purposes of this tutorial, click No. In Chapter 4, the tutorial will show you how to create a virtual address as a separate step. Creating a Group 3-7
Responding to the Virtual Address Question 3-8 Oracle Fail Safe Tutorial
4 Adding a Virtual Address to a Group This chapter describes the steps necessary to add a virtual address to a group with Oracle Fail Safe Manager. Oracle Fail Safe Manager does not allow you to add any other resources (other than a generic service) to a group until at least one virtual address has been added to the group. Without a virtual address, clients cannot connect to resources that have been added to a group. Adding a Virtual Address to a Group 4-1
Opening the Add Resource to Group Wizard 4.1 Opening the Add Resource to Group Wizard In the tree view, select the group to which you want to add a virtual address. Next, on the Resources menu, select Add to Group to open the Add Resource to Group Wizard. 4-2 Oracle Fail Safe Tutorial
Specifying the Resource Type and Group 4.2 Specifying the Resource Type and Group On the first page of the wizard, select the Virtual Address resource type, the FSTutorial group, and then click Next. Adding a Virtual Address to a Group 4-3
Describing the Network 4.3 Describing the Network When you add a virtual address to a group, you need to define the network on which the virtual address runs. If you do not know which addresses are available as virtual addresses on your cluster, ask your cluster administrator. Enter the data on the wizard page as follows: 1. In the Network section of the page, select "Show networks accessible by clients," and in the Network box, select Public. 2. In the Virtual Address section of the page, enter the host name for the virtual address that you want to create in the Host Name box (your value will be different than the one shown in the image), and then press the Tab key. When you press the Tab key, Oracle Fail Safe resolves the host name to an IP address. Your values for the virtual address will be different from the ones shown in the image. Also, do not use the cluster alias; in this example, the cluster alias is ntclu-150. 3. Click Finish. 4-4 Oracle Fail Safe Tutorial
Finishing Adding the Virtual Address 4.4 Finishing Adding the Virtual Address Oracle Fail Safe asks you to check the properties you have selected for the virtual address. If they are correct, click OK. Otherwise, click Cancel and then Back to change the properties. After you add at least one virtual address to the group, you are ready to add a resource to the group (such as an Oracle single-instance database, Oracle Forms Server, Oracle Reports Server, Web server, or other resource). Adding a Virtual Address to a Group 4-5
Viewing the Group Properties 4.5 Viewing the Group Properties Frequently, you will need the virtual address or addresses of a group when you are adding resources to the group. These addresses are displayed in the wizard you use to add a resource to a group. You can also see a list of these addresses in the Virtual Addresses property page. This property page shows the virtual address that you just added to the group. 4-6 Oracle Fail Safe Tutorial
5 Creating a Sample Single-Instance Database This lesson shows you how to create a sample single-instance database called SAMPLEDB. The rest of this tutorial assumes you have created this database. Creating a Sample Single-Instance Database 5-1
Opening the Create Sample Database Dialog Box 5.1 Opening the Create Sample Database Dialog Box In the tree view, select the cluster (or an object on the cluster) on which you want to create the sample database. Then, on the Resources menu, select Create Sample Database to open the Create Sample Database dialog box. 5-2 Oracle Fail Safe Tutorial
Using the Create Sample Database Dialog Box 5.2 Using the Create Sample Database Dialog Box Enter a service name of SAMPLEDB, select a disk and node combination on which to build the sample database, and then select the version of the Oracle database that you want to create and the Oracle home in which to create it. For the disk resource, Oracle Corporation recommends you select a disk other than that which is used for the quorum resource. (To view the disk used for the quorum resource, select the cluster alias in the tree view, then click the Quorum tab.) Click OK. The sample database always uses the SYS account with a password of change_on_ install. Do not use the sample database as a production database. Creating a Sample Single-Instance Database 5-3
Starting the Default Oracle Intelligent Agent 5.3 Starting the Default Oracle Intelligent Agent Oracle Fail Safe opens a Creating Sample Database window to display the progress of the operation. This may take a few minutes. During the operation, Oracle Fail Safe opens a Clusterwide Operation Query window to ask if you want to restart the default Oracle Intelligent Agent. Click Yes. 5-4 Oracle Fail Safe Tutorial
Viewing the Progress of the Clusterwide Operation 5.4 Viewing the Progress of the Clusterwide Operation When the operation completes, Oracle Fail Safe opens a Clusterwide Operation Status window to let you know whether the operation has completed successfully. Click OK. Creating a Sample Single-Instance Database 5-5
Viewing the Progress of the Clusterwide Operation 5-6 Oracle Fail Safe Tutorial
6 Verifying a Standalone Single-Instance Database If you add a standalone database (that you did not create using Create Sample Database) to a group, you should verify the database before adding it to a group. When you verify a standalone database, Oracle Fail Safe uses data that you supply to attempt to fix any problems it finds clusterwide. Because Oracle Fail Safe created it, you do not need to verify the database that you created in Chapter 5. However, for the purpose of demonstration, you will do so in this lesson. Verifying a Standalone Single-Instance Database 6-1
Using the Verify Standalone Database Command 6.1 Using the Verify Standalone Database Command In the tree view, select the SAMPLEDB.us.oracle.com database. Then, in the Troubleshooting menu, select Verify Standalone Database. 6-2 Oracle Fail Safe Tutorial
Using the Verify Standalone Database Dialog Box 6.2 Using the Verify Standalone Database Dialog Box The contents of the database information fields are retrieved automatically. If a value is too long for a field, you may not see the entire value. In the Account box, select the "Use operating system authentication" option. (If a window opens with a question similar to the following, click Yes: "To use operating system authentication, the user, domain\administrator must be added to the dba group ORA_OFS1_DBA. Should Oracle Fail Safe add this user for you?") Verifying a Standalone Single-Instance Database 6-3
Viewing the Progress of the Clusterwide Operation 6.3 Viewing the Progress of the Clusterwide Operation Oracle Fail Safe displays the results of the Verify Standalone Database operation. (During the operation, a message window may ask if you want to start the SAMPLEDB instance. If this message is displayed, click Yes.) 6-4 Oracle Fail Safe Tutorial
7 Adding a Single-Instance Database to a Group This lesson shows how to add a single-instance database to a group. When you add a single-instance database to a group, you make that database highly available. If the node on which the database is currently running is taken offline or fails, the database is restarted on a surviving cluster node. In this lesson, you will add the sample database that you created in Chapter 5 to the FSTutorial group that you created in Chapter 3. Adding a Single-Instance Database to a Group 7-1
Invoking the Add Resource to Group Wizard 7.1 Invoking the Add Resource to Group Wizard In the tree view, select the SAMPLEDB.us.oracle.com database, then on the Resources menu, select Add to Group. 7-2 Oracle Fail Safe Tutorial
Using the Add Resource to Group Wizard 7.2 Using the Add Resource to Group Wizard The Add Resource to Group Wizard steps you through the process of adding the database to the group. On this page, select Oracle Database (if it is not already selected) and then select the FSTutorial group from the Group Name pull-down menu. Click Next. Adding a Single-Instance Database to a Group 7-3
Specifying the Database Identity 7.3 Specifying the Database Identity Typically, the Service Name, Instance Name, Database Name, and Parameter File fields are retrieved automatically. However, if the parameter file disk is not on the same node as the database instance, then the database name will not be prefilled. If this is the case, enter the database name in the Database Name field. Click Next. 7-4 Oracle Fail Safe Tutorial
Selecting a Database Authentication Method 7.4 Selecting a Database Authentication Method Oracle Services for MSCS must have access to the database. Oracle Services for MSCS accesses the database from two accounts, the account running the Oracle Services for MSCS service and the account running the Cluster Server service. The account running the Oracle Services for MSCS service accesses the database during configuration and verification operations; the account running the Cluster Server service accesses the database when monitoring database status and when placing the database online or taking it offline. You can choose for the services to access the database using the account or accounts under which they are running (which is called operating system authentication) or to access the database using the SYS account. Note: This page will not be presented if the account (or accounts) under which the services are running is already a member of either the ORA_DBA or ORA_<SID>_DBA Windows operating system group. Select the "Use operating system authentication" option. Adding a Single-Instance Database to a Group 7-5
Adding the Account to the Windows ORA_<SID>_DBA Group 7.5 Adding the Account to the Windows ORA_<SID>_DBA Group When you select the "Use operating system authentication" option, Oracle Fail Safe opens a window to confirm that you want to add the account or accounts under which the Oracle Server for MSCS and Cluster Server services are running to the ORA_<SID>_DBA group. Click Yes. Then click Next in the Database Authentication Wizard page. In this example, Oracle Services for MSCS and MSCS are both running under the nedcdomain\cluadmin account and OFS1 is the SID of the SAMPLEDB database. If they were running under different accounts, both would be added to the ORA_ OFS1_DBA group. (The values presented to you when you follow this tutorial may be different.) 7-6 Oracle Fail Safe Tutorial
Specifying a Password File 7.6 Specifying a Password File On this page, you can choose whether or not Oracle Services for MSCS will create a password file for the database on each cluster node. If you choose not to have Oracle Services for MSCS create a password file on each cluster node, then database administrators who want to access the database must be members of the ORA_DBA or ORA_<SID>_DBA Windows operating system group and will only be able to perform database administration tasks from the node on which the database resides; applications such as Recovery Manager will not be able to access the database from a noncluster node. This lesson specifies that Oracle Services for MSCS will create a password file. Select the "Yes, create the password file" option, and enter and confirm the password for the SYS account. The default password for the SYS account is change_on_install. Adding a Single-Instance Database to a Group 7-7
Finishing Adding the Database 7.7 Finishing Adding the Database Oracle Fail Safe asks you to check the properties you have selected for the database. If they are correct, click OK. Otherwise, click Cancel and then click Back to change the properties. 7-8 Oracle Fail Safe Tutorial
Shutting Down the Database 7.8 Shutting Down the Database If the database is running, Oracle Fail Safe displays a window to warn you that it must shut down the database. Click Yes to shut down the database and continue the process. Adding a Single-Instance Database to a Group 7-9
Viewing the Progress of the Clusterwide Operation 7.9 Viewing the Progress of the Clusterwide Operation Oracle Fail Safe displays the progress of the Add Database to Group operation. 7-10 Oracle Fail Safe Tutorial
8 Verifying a Group A group verification checks that the selected group is configured correctly. Over time, as your system becomes more complex and hardware and software configurations change, you may find that resource dependencies have changed. The Verify Group command makes it easy to restore the configuration to working order. When you use a Verify Group command, Oracle Fail Safe attempts to correct any configuration problems it finds. It is not necessary to verify a group immediately after you create it, but it is done in this lesson to demonstrate the operation. Verifying a Group 8-1
Using the Verify Group Command 8.1 Using the Verify Group Command In the tree view, right-click the FsTutorial group name, then select Verify Group. 8-2 Oracle Fail Safe Tutorial
Viewing Progress 8.2 Viewing Progress Because the Verify group operation is applied clusterwide and involves numerous steps, it can take a few minutes to complete. Oracle Fail Safe Manager displays the progress of the operation to you. When the operation is complete, click OK in the Cluster Operation Status window and Close in the Verifying Group FsTutorial window. Verifying a Group 8-3
Viewing Progress 8-4 Oracle Fail Safe Tutorial
9 Balancing the Workload Oracle Fail Safe Manager makes it easy to balance the workload across the nodes in the cluster using a process called planned failover. You can use planned failover to adjust the initial setup of the cluster, or to adjust the setup if the cluster environment changes. Balancing the Workload 9-1
Initial Set Up for Performing a Planned Failover 9.1 Initial Set Up for Performing a Planned Failover Create three groups: Sales, Marketing, and Customers. Create Sales and Marketing on one node (NTCLU-151 is used in this example); create Customers on the other node (NTCLU-152 is used in this example). Enable failback for each group, and set the current node of each group at the top of the Preferred Owner Nodes list. See Chapter 3 for instructions on creating a group. For the purposes of this example, you do not need to add virtual addresses to the new groups. The following figure shows the initial configuration of the cluster: Suppose that you have recently added more CPUs to NTCLU-152. Node NTCLU-152 can better handle the load of the Sales and Marketing groups, and NTCLU-151 would now be a better place for the Customers group. You can move the groups to the new, more capable system with minimal interruption in service to your users. 9-2 Oracle Fail Safe Tutorial
Moving the Sales Group 9.2 Moving the Sales Group Because NTCLU-152 is the more robust system, the first step is to move Sales and Marketing groups to NTCLU-152. To move the Sales group from NTCLU-151 to NTCLU-152, right-click on the Sales group and select Move to a Different Node. (Your node names will be different.) Balancing the Workload 9-3
Confirming the Move Group Operation 9.3 Confirming the Move Group Operation A confirmation window asks if you want to move the Sales group to NTCLU-152. Click Yes. 9-4 Oracle Fail Safe Tutorial
Finishing Moving the Group 9.4 Finishing Moving the Group The Moving Group window displays the progress of the move operation. When the move is finished, click Yes in the Clusterwide Operation Status window, then click Close in the Moving Group window. Balancing the Workload 9-5
Moving the Marketing Group 9.5 Moving the Marketing Group To move the Marketing group from NTCLU-151 to NTCLU-152, right-click on the Marketing group and select Move to a Different Node. Complete the move operation as described in Section 9.3 and Section 9.4. 9-6 Oracle Fail Safe Tutorial
Moving the Customers Group 9.6 Moving the Customers Group To move the Customers group from NTCLU-152 to NTCLU-151, right-click on the Customers group and select Move to a Different Node. Complete the move operation as described in Section 9.3 and Section 9.4. Balancing the Workload 9-7
Checking the Preferred Owner Nodes List 9.7 Checking the Preferred Owner Nodes List Check the Preferred Owner Nodes list. Select the Sales group from the tree view and click the Nodes tab. The data on this page indicates that NTCLU-151 is the preferred owner node. However, now that you have rearranged the configuration, you probably want NTCLU-152 to be the preferred owner node. With the current settings, if NTCLU-152 fails and the Sales group fails over to NTCLU-151, the Preferred Nodes list indicates that you prefer the Sales group to reside on NTCLU-151; failback will not occur when NTCLU-152 comes online. 9-8 Oracle Fail Safe Tutorial
Rearranging the Preferred Nodes List 9.8 Rearranging the Preferred Nodes List Rearrange the Preferred Nodes list so that NTCLU-152 is first in the list and NTCLU-151 is second. Select NTCLU-152 from the Available Nodes list and click the right-arrow button, then select NTCLU-152 from the Preferred Nodes list and click the up-arrow button. The Preferred Nodes list should list NTCLU-152 first and NTCLU-151 second. Repeat this process for Customers and Marketing, ensuring that the node on which you want each group to reside when both cluster nodes are up is first in their respective Preferred Nodes list. Balancing the Workload 9-9
Viewing the Balanced Workload 9.9 Viewing the Balanced Workload When you finish the planned failover, the Oracle Fail Safe Manager tree view should appear similar to the following image when you expand both of the Nodes folders for NTCLU-150 and the Groups folder below each Nodes folder in the tree view, then click any one of the Groups folders. 9-10 Oracle Fail Safe Tutorial
10 Identifying the Location of Fail-Safe Databases to Client Applications Ordinarily, end-user applications identify the location of a database by its physical node address. When you add a database to a group, the location of the database in the group is identified by the virtual address of the group. Identifying the Location of Fail-Safe Databases to Client Applications 10-1
Updating the tnsnames.ora File 10.1 Updating the tnsnames.ora File If your end-user applications use tnsnames.ora to locate databases, use a tool such as Oracle Net Assistant to change the host value in tnsnames.ora on client systems from the physical node address to the virtual address of the group. Oracle Fail Safe makes this update for you on the server systems and the client system from which you are running Oracle Fail Safe Manager. 10-2 Oracle Fail Safe Tutorial
11 Creating and Adding a Forms Server and an Oracle HTTP Server to a Group This lesson demonstrates how to make an Oracle Forms application deployed on the Web highly available. This is done by making both the Oracle Forms Server and the Oracle HTTP Server highly available. Oracle Fail Safe can add an existing Forms Server to a group, or it can create and add a Forms Server to a group; both are done using the Add Resource to Group Wizard. This lesson will first create and add a Forms Server to a group, then create and add an Oracle HTTP Server to the same group so that the form can be viewed on the Web. Because this lesson requires preparation, you might find it helpful to print this introduction before continuing. Use the following table to record data that is specific to your configuration. The first column lists the items needed for this lesson. The second column lists the values used in this tutorial. In the third column, enter the values that correspond to your configuration. Item Tutorial Value Your Value Virtual address of Forms_Group: IP address 138.2.26.156 Virtual address of Forms_Group: Node name NTCLU-156 Directory specification for Forms Server files Oracle home where Oracle HTTP Server is installed Directory specification for Oracle home of Oracle ias V:\Forms ORADB D:\Oracle\806\ Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-1
Item Tutorial Value Your Value Directory specification for HTTP Server files V:\HTTPServer\htdocs Before running this lesson, perform the following operations: 1. Make sure the system software requirements have been met, as described in Chapter 1. 2. Create a group called Forms_Group and add a virtual address to it, as described in Chapter 3 and Chapter 4. 3. If you have not already done so, install the demo database objects that ship with Oracle Fail Safe, using the database that you created in Chapter 5, by performing the following operation: a. Connect to your database as system/manager. b. Run <Oracle_Home>\fs\fssvr\demos60.sql using a tool such as SQL Worksheet. 4. Create a \Forms directory on a cluster disk that you have designated for the Forms Server. 5. Create an \HTTPServer directory on a cluster disk. In this directory, create an \htdocs directory. 6. Copy calcform.fmx from <Oracle_Home>\fs\fssvr on one of the cluster nodes to the \Forms directory. 7. Copy WebForm.htm from <Oracle_Home>\fs\fssvr on one of the cluster nodes to the \HTTPServer\htdocs directory. This will be the default page for the Web server. 11-2 Oracle Fail Safe Tutorial
Using the Add Resource to Group Wizard 11.1 Using the Add Resource to Group Wizard In the tree view, select the Forms_Group, then on the Resources menu, click Add to Group. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-3
Specifying the Resource and Group 11.2 Specifying the Resource and Group Select Oracle Forms Server as the resource type and select Forms_Group as the group to which to add the Forms Server. Click Next. 11-4 Oracle Fail Safe Tutorial
Specifying the Forms Server Identity 11.3 Specifying the Forms Server Identity Enter the name Forms_Tutorial in the Forms Server Name box and 9010 in the Port Number box. Click Next. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-5
Specifying the Forms Server Parameters 11.4 Specifying the Forms Server Parameters Accept the default values of Socket for the connection mode and 1 for the pool value. Click Next. 11-6 Oracle Fail Safe Tutorial
Specifying the Forms Server Path 11.5 Specifying the Forms Server Path Click Add and enter the directory specification for the location where you copied the calcform.fmx file earlier, then click OK. If the disk you specify is not on the same node as the Forms_Group, Oracle Fail Safe will open a window to ask if the group containing the disk can be moved to the same node as the Forms_Group. Click Yes. Then, in the Add Resource to Group - Forms Path Wizard page, click Next. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-7
Specifying the Database Used by the Forms Server 11.6 Specifying the Database Used by the Forms Server Specify the database or databases that the forms using the Forms Server will access. In the Available box, select the database you created in Chapter 5 and click the right arrow. Click Finish. 11-8 Oracle Fail Safe Tutorial
Finishing Creating and Adding the Forms Server 11.7 Finishing Creating and Adding the Forms Server Oracle Fail Safe asks you to check the properties you have selected for the Forms Server. If they are correct, click OK. Otherwise, click Cancel and then Back to change the properties in the wizard. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-9
Monitoring the Clusterwide Operation 11.8 Monitoring the Clusterwide Operation After you complete the wizard, Oracle Fail Safe begins to configure the resources in the group. You can watch the progress of this operation and view the status of the individual resources within the group as Oracle Fail Safe configures and tests the cluster environment. 11-10 Oracle Fail Safe Tutorial
Adding an Oracle HTTP Server to the Group 11.9 Adding an Oracle HTTP Server to the Group To view forms through a Web browser, you need a Web server. In this portion of the lesson, you will add an Oracle HTTP Server to Forms_Group. Select Forms_Group from the tree view, then on the Resources menu, select Add to Group. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-11
Specifying the Resource and Group 11.10 Specifying the Resource and Group Select Oracle HTTP Server as the resource type and select Forms_Group as the group to which to add the Oracle HTTP Server. Click Next. 11-12 Oracle Fail Safe Tutorial
Specifying the Oracle HTTP Server Name 11.11 Specifying the Oracle HTTP Server Name Enter Forms_Site in the Oracle HTTP Server Name box. The Version/Home box should be filled in automatically. In the Cluster Disk box, enter the cluster disk on which you created the HTTP Server directory at the beginning of this lesson. Click Next. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-13
Specifying Default Files 11.12 Specifying Default Files In the Document Root field, enter the path to the \htdocs directory that you created at the beginning of the lesson. Click the top Add button in the wizard window to open the Enter a File Name dialog box. In the File Name box, enter WebForm.htm and click OK. Do not click Next. 11-14 Oracle Fail Safe Tutorial
Specifying the Virtual Directory 11.13 Specifying the Virtual Directory A virtual directory maps a name to a physical directory specification. You specify virtual directories to hide your file structure from end users. If a physical directory changes, the URL specified by end users does not change. Follow these steps to add the virtual directory needed to run the applet: 1. Click the lower Add button in the wizard window to open the Virtual Directory Mapping dialog box. 2. In the Virtual Directory box, enter /web_code. 3. In the Physical Directory box, enter the directory where you installed Oracle ias, followed by \Forms60\java. 4. Select "Allow CGI execution" to ensure that CGI can be executed in the virtual directory. 5. Click OK. Oracle Fail Safe warns you to make sure that the files are installed in the same location on all possible owner nodes for the resource. If Oracle ias was installed in the same location on both cluster nodes, you can safely ignore this warning. 6. Click Next. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-15
Specifying the Virtual Directory 11-16 Oracle Fail Safe Tutorial
Specifying the Virtual Address 11.14 Specifying the Virtual Address On this page, you specify the virtual address at which users can access the Web site where the form will be displayed. In the top portion of this page, select the available IP address, click the right arrow, and specify a port of 1067. (If port 1067 is already in use by another application on your cluster, enter a different port.) Click Finish. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-17
Finishing Creating and Adding the Web Server 11.15 Finishing Creating and Adding the Web Server Oracle Fail Safe asks you to check the properties you have selected for the Oracle HTTP Server. If they are correct, click OK. Otherwise, click Cancel and then Back to change the properties in the wizard. 11-18 Oracle Fail Safe Tutorial
Monitoring the Clusterwide Operation 11.16 Monitoring the Clusterwide Operation After you complete the wizard, Oracle Fail Safe begins to configure the resources in the group. You can watch the progress of this operation and view the status of the individual resources in the group as Oracle Fail Safe configures and tests them in the cluster environment. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-19
Adjusting the WebForm.htm File 11.17 Adjusting the WebForm.htm File The WebForm.htm file that you copied to the \Forms directory must be customized with your data before you can view the form on the Web. If necessary, edit the following values in WebForm.htm: Replace the value of the serverport parameter ("9000") with the value of your Forms Server port number (in this tutorial, "9010"). Replace the version number of the type parameter ("1.1.8.7") with the version number of your version of Jinitiator. 11-20 Oracle Fail Safe Tutorial
Viewing the Fail-Safe Form, Part One 11.18 Viewing the Fail-Safe Form, Part One In a Web browser, enter the virtual address and port number of the Oracle HTTP Server as the URL. When prompted, enter the user name and password for the database system account, and the full database name of the database where you installed the sample database objects. (By default, the user name and password are system and manager, respectively.) Click Connect. Creating and Adding a Forms Server and an Oracle HTTP Server to a Group 11-21
Viewing the Fail-Safe Form, Part Two 11.19 Viewing the Fail-Safe Form, Part Two You can now test the high availability of the configuration by performing the following operations: 1. After the form loads, alter some data in the form. Click the Action menu of the Java applet, and click Save. 2. Using Oracle Fail Safe, perform a planned failover and move Forms_Group to the other node. See Chapter 9 for instructions on performing a planned failover. 3. In the Web browser, click Reload to refresh the form and display the changes you made to the data. 11-22 Oracle Fail Safe Tutorial
12 Creating and Adding a Reports Server and an Oracle HTTP Server to a Group This lesson demonstrates how to make an Oracle Reports application deployed on the Web highly available. This is done by making both the Oracle Reports Server and an Oracle HTTP Server highly available. If you want to deploy a non-web Oracle Reports application, you need only follow this lesson to Section 12.8. If you schedule jobs for the Reports Server using the Reports Queue Manager, the job scheduling will be highly available. Because this lesson requires preparation, you might find it helpful to print this introduction before continuing. Use the following table to record data that is specific to your configuration. The first column lists the items needed for this lesson. The second column lists the values used in this tutorial. In the third column, enter the values that correspond to your configuration. Item Tutorial Value Your Value Virtual address of Reports_Group: IP address Virtual address of Reports_Group: Network name Directory specification for Reports Server source files Directory specification for Reports Server cache files Directory specification for Reports Server scheduled jobs 138.2.26.157 ntclu-157 W:\Reports_Source W:\Reports_Cache W:\Reports_Jobs Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-1
Item Tutorial Value Your Value Directory specification for HTTP Server files User account (including user name, password, and domain) on the cluster configured for printing Directory specification for Oracle Developer release 6i home directory Oracle home where Oracle HTTP Server is installed W:\HTTPServer\htdocs Allyn internal NEDCDOMAIN D:\Oracle\806 ORADB Before running this lesson, perform the following operations: 1. Make sure the system software requirements have been met, as described in Chapter 1. 2. Create a group called Reports_Group and add a virtual address to it, as described in Chapter 3 and Chapter 4. 3. If you have not already done so, install the demo database objects that ship with Oracle Fail Safe, using the database that you created in Chapter 5, by performing the following operations: a. Connect to your database as system/manager. b. Run <Oracle_Home>\fs\fssvr\rdemos60.sql using a tool such as SQL Worksheet. 4. Create a \Reports_Source directory, a \Reports_Cache directory, and a \Reports_Jobs directory on a cluster disk. 5. Create an \HTTPServer directory on a cluster disk. In this directory, create an \htdocs directory. 6. Copy sample.rdf file from <Oracle_Home>\fs\fssvr on one of the cluster nodes to the \Reports_Source directory. 7. Copy WebReport.htm from <Oracle_Home>\fs\fssvr on one of the cluster nodes to the \HTTPServer\htdocs directory. This will be the default page for the Web server. 12-2 Oracle Fail Safe Tutorial
Invoking the Add Resource to Group Wizard 12.1 Invoking the Add Resource to Group Wizard In the tree view, select the Reports_Group, then on the Resources menu, select Add to Group. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-3
Specifying the Resource and Group 12.2 Specifying the Resource and Group Select Oracle Reports Server as the resource type and select Reports_Group as the group to which to add the Reports Server. Click Next. 12-4 Oracle Fail Safe Tutorial
Specifying the Reports Server Identity 12.3 Specifying the Reports Server Identity Enter Reports_Tutorial as the name for the Reports Server. Accept the default port of 1949. Click Next. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-5
Specifying the Reports Server Disks and Directories 12.4 Specifying the Reports Server Disks and Directories Enter the directory specifications for the Reports Server cache directory, source directory, and jobs directory that you created before beginning the lesson. Click Next. 12-6 Oracle Fail Safe Tutorial
Specifying the Database Used by the Reports Server 12.5 Specifying the Database Used by the Reports Server Select the database that you created in Chapter 5 from the Available box, then click the right arrow to move the database to the Selected box. This tells Oracle Fail Safe that the reports served by the Reports_Tutorial server access the selected database. Click Next. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-7
Specifying an Account for the Reports Server to Use 12.6 Specifying an Account for the Reports Server to Use For the Reports Server to run properly, it must have access to one or more printers. By default, the Windows SYSTEM user does not have access to printers. Therefore, specify a user account and password that the Reports Server can use to access a printer. Click Finish. 12-8 Oracle Fail Safe Tutorial
Finishing Creating and Adding a Reports Server 12.7 Finishing Creating and Adding a Reports Server Oracle Fail Safe asks you to check the properties you have selected for the Reports Server. If they are correct, click OK. Otherwise, click Cancel and then Back to change the properties in the wizard. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-9
Monitoring the Clusterwide Operation 12.8 Monitoring the Clusterwide Operation After you complete the wizard, Oracle Fail Safe configures the resources in the group. You can watch the progress of this operation and view the status of the individual resources within the group as Oracle Fail Safe configures and tests them in the cluster environment. If you were using the Reports Server to generate text files, you would now be ready to schedule jobs with the Reports Queue Manager. The rest of this lesson shows how to configure a Web server so that your reports will be highly available on the Web. 12-10 Oracle Fail Safe Tutorial
Adding an Oracle HTTP Server to the Group 12.9 Adding an Oracle HTTP Server to the Group To view reports through a Web browser, you need to add a Web server to the group. In this portion of the lesson, you will add an Oracle HTTP Server to Reports_Group. Select Reports_Group from the tree view, then on the Resources menu, select Add to Group. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-11
Specifying the Resource and Group 12.10 Specifying the Resource and Group Select Oracle HTTP Server as the resource type and select Reports_Group as the group to which to add the Oracle HTTP Server. Click Next. 12-12 Oracle Fail Safe Tutorial
Specifying the Oracle HTTP Server Name 12.11 Specifying the Oracle HTTP Server Name Enter Reports_Site in the Oracle HTTP Server Name box. Select the Version/Home that reflects the version and home of the Oracle HTTP Server software that you want to use. In the Cluster Disk box, enter the cluster disk on which you created the HTTPServer directory at the beginning of this lesson. Click Next. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-13
Specifying Default Files 12.12 Specifying Default Files At the top of the wizard window, enter the path to the \htdocs directory that you created at the beginning of the lesson. Click the top Add button in the wizard window. In the File Name box, enter WebReport.htm and click OK. The WebReport.htm file is the file that you copied from <Oracle_Home>\fs\fssvr to the \htdocs directory earlier. It contains the URL needed to present the report on the Web. Do not click Next. 12-14 Oracle Fail Safe Tutorial
Specifying the First Virtual Directory 12.13 Specifying the First Virtual Directory A virtual directory maps a name to a physical directory specification. You specify virtual directories to hide your file structure from end users. If a physical directory changes, the URL specified by end users does not change. Follow these steps to specify the first virtual directory: 1. Click the lower Add button in the wizard window to open the Virtual Directory Mapping dialog box. 2. In the Virtual Directory box, enter /web_cgi. 3. In the Physical Directory box, enter the directory specification for the bin directory of the Oracle home where you installed Oracle Developer release 6i. This directory contains the rwcgi60.exe cgi file that you need to run your report on the Web. 4. Select "Allow CGI execution" to ensure that CGI can be executed in the virtual directory. 5. Click OK. Oracle Fail Safe warns you to make sure that the files are installed in the same location on both cluster nodes. If Oracle Developer 6i was installed in the same location on both cluster nodes, you can safely ignore this warning. 6. Do not click Next. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-15
Specifying the Second Virtual Directory 12.14 Specifying the Second Virtual Directory Follow these steps to add the second virtual directory: 1. Click the lower Add button in the wizard window to open the Virtual Directory Mapping dialog box. 2. In the Virtual Directory box, enter /output. 3. In the Physical Directory box, enter the directory specification for the \Reports_ Cache directory that you created earlier. This is the directory where the Oracle Reports Server output files will be written. 4. Click OK. 5. Click Next. 12-16 Oracle Fail Safe Tutorial
Specifying the Virtual Address 12.15 Specifying the Virtual Address On this page, you specify the virtual address at which users can access the Web site where the report will be displayed. In the top portion of this page, select the available IP address, click the right arrow, and enter a port of 4001. (If port 4001 is already in use by another application on your cluster, enter a different port.) Click Finish. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-17
Finish Creating and Adding the Oracle HTTP Server 12.16 Finish Creating and Adding the Oracle HTTP Server Oracle Fail Safe asks you to check the properties you have selected for the Oracle HTTP Server. If they are correct, click OK. Otherwise, click Cancel and then Back to change the properties in the wizard. 12-18 Oracle Fail Safe Tutorial
Monitoring the Clusterwide Operation 12.17 Monitoring the Clusterwide Operation After you complete the wizard, Oracle Fail Safe begins to configure the resources in the group. You can watch the progress of this operation and view the status of the individual resources in the group as Oracle Fail Safe configures and tests them in the cluster environment. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-19
Adjusting the WebReport.htm File 12.18 Adjusting the WebReport.htm File The WebReport.htm file that you copied to the Reports_Source directory must be customized with your data before you can view the report on the Web. If necessary, edit the following values in WebReport.htm: Replace "ntclu-157:4001" with the network name and port you specified in the Add Oracle HTTP Server to Group Wizard. Replace "system/manager@sampledb.us.oracle.com" with the user name, password, and database name for the database account that you used to install the demo database objects. 12-20 Oracle Fail Safe Tutorial
Viewing the Fail-Safe Report, Page One 12.19 Viewing the Fail-Safe Report, Page One After you configure a Reports Server and an Oracle HTTP Server for high availability, you can view the report. In a Web browser, enter the virtual address and port number of the Oracle HTTP Server as the URL. Click the text in the window browser as directed. Creating and Adding a Reports Server and an Oracle HTTP Server to a Group 12-21
Viewing the Fail-Safe Report, Page Two 12.20 Viewing the Fail-Safe Report, Page Two You can now test the high availability of the configuration by performing the following operations: 1. Note the date and time in the report presented in the Web browser. 2. Using Oracle Fail Safe, perform a planned failover and move Reports_Group to the other node. See Chapter 9 for more information. 3. In the Web browser, click Reload to reload the report. The date and time will show the current time. 12-22 Oracle Fail Safe Tutorial
13 Removing a Resource from a Group When you are done experimenting with a resource, you probably want to delete it from the cluster. Before you can delete it from the cluster, you must first remove it from the group to which you added it. Note that you can only use the Remove from Group command to remove those resources from a group that you added with the Add Resource to Group Wizard. Removing a Resource from a Group 13-1
Using the Remove from Group Command 13.1 Using the Remove from Group Command In the tree view, select Forms_Tutorial. Then, on the Resources menu, select Remove from Group. 13-2 Oracle Fail Safe Tutorial
Confirmation Request 13.2 Confirmation Request When you remove the Forms_Tutorial from the group, Oracle Fail Safe asks, "Are you sure you want to remove the resource Forms_Tutorial from the group?" Click Yes. (Note that when you remove a database from a group, Oracle Fail Safe warns you that the database will be shut down and all users will be disconnected.) Removing a Resource from a Group 13-3
Monitoring the Clusterwide Operation 13.3 Monitoring the Clusterwide Operation Oracle Fail Safe opens a window and begins the remove operation. The upper portion of the window displays the status of individual resources in the group, and the lower portion of the window displays the progress of the remove operation. Because the Forms_Tutorial and the Forms_Site use the same cluster disk, Oracle Fail Safe reports a warning to indicate that the cluster disk used by the Forms_ Tutorial cannot be removed from the group because it is also used by the Forms_ Site. This is expected. Click OK in the Clusterwide Operation Status window, then click Close in the Removing Resource window. 13-4 Oracle Fail Safe Tutorial
14 Deleting a Standalone Resource from the Cluster You can use the Delete Standalone command to delete any standalone resource (except a standalone sample database) from the cluster. See Chapter 15 for information on deleting a sample database from the cluster. Deleting a Standalone Resource from the Cluster 14-1
Using the Delete Standalone Command 14.1 Using the Delete Standalone Command In the tree view, under Standalone Resources, select Forms_Tutorial. Then, in the Resources menu, select Delete Standalone. 14-2 Oracle Fail Safe Tutorial
Confirming the Delete Standalone Command 14.2 Confirming the Delete Standalone Command Oracle Fail Safe asks you to confirm that you want to delete the resource permanently. Click Yes to delete the resource. Deleting a Standalone Resource from the Cluster 14-3
Confirming the Delete Standalone Command 14-4 Oracle Fail Safe Tutorial
15 Deleting a Sample Database from the Cluster Use the Delete Sample Database command to delete any database that you created with the Create Sample Database command. Do not use the Delete Sample Database command to delete databases created using other means. For those databases, use the Delete Resource command, as described in Chapter 14. Deleting a Sample Database from the Cluster 15-1
Using the Delete Sample Database Command 15.1 Using the Delete Sample Database Command If the database is still in a group, remove it, using the method described in Chapter 13. Then, in the tree view, select SAMPLEDB.us.oracle.com. On the Resources menu, select Delete Sample Database. 15-2 Oracle Fail Safe Tutorial
Confirming the Delete Sample Database Command 15.2 Confirming the Delete Sample Database Command Oracle Fail Safe asks you to confirm that you want to permanently destroy the sample database. Click Yes to delete the database resource. Deleting a Sample Database from the Cluster 15-3
Authenticating Your Privileges to Delete the Database 15.3 Authenticating Your Privileges to Delete the Database Depending on the privileges you have, Oracle Fail Safe may open a window to confirm that you have privileges to delete the sample database. If this window opens, enter and confirm the password for the SYS account. 15-4 Oracle Fail Safe Tutorial
Starting the Default Oracle Intelligent Agent 15.4 Starting the Default Oracle Intelligent Agent Oracle Fail Safe opens the Deleting Sample Database SAMPLEDB.us.oracle.com window to display the progress of the operation. During the operation, Oracle Fail Safe opens a Clusterwide Operation Query window to ask if you want to restart the default Oracle Intelligent Agent. Click Yes. Deleting a Sample Database from the Cluster 15-5
Viewing the Progress of the Clusterwide Operation 15.5 Viewing the Progress of the Clusterwide Operation When the operation completes, Oracle Fail Safe opens a Clusterwide Operation Status window to let you know whether the operation has completed successfully. Click OK in the Clusterwide Operation Status window, then click Close in the Deleting Sample Database window. 15-6 Oracle Fail Safe Tutorial
16 Deleting a Group from the Cluster If you created a group using Oracle Fail Safe Manager, you can delete that group using Oracle Fail Safe Manager. Oracle Fail Safe requires that all resources, except the virtual address (network name and IP address), be removed from the group first. Groups created by MSCS Cluster Administrator cannot be deleted using Oracle Fail Safe Manager. Deleting a Group from the Cluster 16-1
Using the Delete Group Command 16.1 Using the Delete Group Command After removing the resources from the FsTutorial group, delete the group from the cluster by right-clicking FsTutorial and selecting Delete Group. 16-2 Oracle Fail Safe Tutorial