1

Oracle® Fail Safe TutorialRelease 3.1.2January 2001

This tutorial steps you through the process of configuring Oracle databases, Oracle FormsServers, Oracle Reports Servers, Oracle Application Servers, and Oracle HTTP Servers for highavailability using Oracle Fail Safe. It also steps you through the process of managing theseitems in a cluster environment.

2

Oracle Fail Safe Tutorial

Release 3.1.2

Copyright © 2000, 2001 Oracle Corporation. All rights reserved.

The Programs (which include both the software and documentation) containproprietary information of Oracle Corporation; they are provided under a licenseagreement containing restrictions on use and disclosure and are also protectedby copyright, patent, and other intellectual and industrial property laws. Reverseengineering, disassembly, or decompilation of the Programs 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 inwriting. Oracle Corporation does not warrant that this document is error free.Except as may be expressly permitted in your license agreement for thesePrograms, no part of these Programs may be reproduced or transmitted in anyform or by any means, electronic or mechanical, for any purpose, without theexpress written permission of Oracle Corporation.

If the Programs are delivered to the U.S. Government or anyone licensing orusing the programs on behalf of the U.S. Government, the following notice isapplicable:

Restricted Rights Notice Programs delivered subject to the DOD FARSupplement are "commercial computer software" and use, duplication, anddisclosure of the Programs, including documentation, shall be subject to thelicensing restrictions set forth in the applicable Oracle license agreement.Otherwise, Programs delivered subject to the Federal Acquisition Regulationsare "restricted computer software" and use, duplication, and disclosure of thePrograms shall be subject to the restrictions in FAR 52.227-19, CommercialComputer Software - Restricted Rights (June, 1987). Oracle Corporation, 500Oracle 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'sresponsibility to take all appropriate fail-safe, backup, redundancy, and othermeasures to ensure the safe use of such applications if the Programs are usedfor such purposes, and Oracle Corporation disclaims liability for any damagescaused by such use of the Programs.

Oracle is a registered trademark, and JInitiator, SQL*Net, Oracle Developer,Oracle Forms, Net8, Oracle7, Oracle8, and Oracle8i are trademarks orregistered trademarks of Oracle Corporation. Other names may be trademarksof their respective owners.

3

Table of Contents

LESSON 1: USING THIS TUTORIAL.......................................................................................4

LESSON 2: INVOKING ORACLE FAIL SAFE MANAGER AND VERIFYING THE CLUSTER ........6

LESSON 3: CREATING A GROUP ........................................................................................ 10

LESSON 4: ADDING A VIRTUAL ADDRESS TO A GROUP .................................................... 16

LESSON 5: CREATING A SAMPLE DATABASE.................................................................... 21

LESSON 6: VERIFYING A STANDALONE DATABASE........................................................... 24

LESSON 7: ADDING A SAMPLE DATABASE TO A GROUP .................................................. 27

LESSON 8: VERIFYING A GROUP ....................................................................................... 34

LESSON 9: BALANCING THE WORKLOAD .......................................................................... 36

LESSON 10: IDENTIFYING THE LOCATION OF FAIL-SAFE DATABASES TO CLIENTAPPLICATIONS ................................................................................................................... 42

LESSON 11: CREATING AND ADDING A FORMS SERVER AND AN ORACLE APPLICATIONSERVER TO A GROUP ......................................................................................................... 43

LESSON 12: CREATING AND ADDING A REPORTS SERVER AND AN ORACLE HTTP SERVERTO A GROUP ....................................................................................................................... 61

LESSON 13: CREATING AND ADDING AN ORACLE WEBDB LISTENER TO A GROUP .......... 84

LESSON 14: REMOVING A RESOURCE FROM A GROUP..................................................... 93

LESSON 15: DELETING A RESOURCE FROM THE CLUSTER............................................... 95

LESSON 16: DELETING A SAMPLE DATABASE FROM THE CLUSTER................................. 96

LESSON 17: DELETING A GROUP FROM THE CLUSTER ..................................................... 99

CONCLUSION .................................................................................................................... 100

4

Lesson 1-1: Using This TutorialIntroduction

Intended UsesThis tutorial is designed to be used in one of two ways:• As a quick overview of the steps needed to configure resources (such as databases, Oracle

Developer Forms Servers, Oracle Developer Reports Servers, and Web servers) to be highlyavailable 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 threeIP addresses that you can use on the cluster for virtual addresses. In addition, it is best tofollow the lessons in order.

NavigationTo navigate through the tutorial, click Next Page or Previous Page at the top of the window. Togo to a particular lesson, click List of Lessons at the top of the window, then click the desiredlesson.If you prefer to work with a printed version of this tutorial, you can print the tutorial.pdf file locatedat: <oracle-home>\fs\bin\doc\fstutorial.pdf, where <oracle-home> is the home into which youinstalled Oracle Fail Safe.

TerminologyThe following terminology is frequently used in this tutorial:• Cluster: A group of independent computing systems that operates as a single virtual

system.• 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 afailover situation, the group is moved to a failover node. A group resides on only one clusternode at a time.

• Resource: A physical or logical component that is available to a computing system. Forexample, disks, the network IP address, Forms Servers, Reports Servers, and Web serversare resources.

• Virtual address: A network address at which a group’s resources can be accessed,regardless of the hardware server hosting those resources.

• Virtual server: A group with one or more virtual addresses.

Software RequirementsThe following list specifies software requirements for Lessons 5, 11, and 12:

• Creating a Sample Database (Lesson 5):− The Oracle Database Component (part of the Oracle Fail Safe installation) is installed.− The Sample Databases (also part of the Oracle Fail Safe installation) are installed.

• Creating and Adding a Forms Server and an Oracle Application Server to a Group(Lesson 11):

− Oracle Developer release 6i is installed on both cluster nodes. (The installation must

5

be either a complete development installation or a server deployment installation.)− Oracle JInitiator release 1.1.7.15.1 or higher is installed on the client where you intend

to view the form served by the Forms Server. (Double-click<Oracle_Home>\fs\fsmgr\jinit117151.exe on the system where you installed OracleFail Safe Manager to install this version of JInitiator.)

− Oracle Application Server release 4.0.8 is installed on both cluster nodes.− The Oracle Database Component, Oracle Forms Component, Oracle Application

Server Component, and the Sample Databases (part of the Oracle Fail Safe Serverinstallation) are installed.

• Creating and Adding a Reports Server and an Oracle HTTP Server to a Group(Lesson 12):

− Oracle Developer release 6i is installed on both cluster nodes. (The installation mustbe either a complete development installation or a server deployment installation.)

− Oracle JInitiator release 1.1.7.15.1 or higher is installed on the client where you intendto view the report served by the Reports Server. (Double-click<Oracle_Home>\fs\fsmgr\jinit117151.exe on the system where you installed OracleFail Safe Manager to install this version of JInitiator.)

− Oracle HTTP Server release 1.3.9 is installed in an Oracle Home directory on bothcluster nodes.

− Oracle Database Component, Oracle Reports Component, Oracle HTTP ServerComponent, and the Sample Databases (part of the Oracle Fail Safe Serverinstallation) are installed.

• Creating and Adding an Oracle WebDB Listener to a Group (Lesson 13):− Oracle Database Component, Oracle WebDB Component, and the Sample

Databases (part of the Oracle Fail Safe Server installation) are installed.− A sample database has been created, and the PL/SQL Toolkit packages have been

installed.− Oracle WebDB release 2.1 or later has been installed on the database.

6

Lesson 2-1: Invoking Oracle Fail Safe Manager and Verifying the ClusterInvoking 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 click Oracle FailSafe Manager. (In this example, the Oracle home is FailSafe.)

7

Lesson 2-2: Invoking Oracle Fail Safe Manager and Verifying the ClusterConnecting to the Cluster

When you invoke Oracle Fail Safe Manager, the Connect to Cluster dialog box opens.Enter a user name and password for a domain account that has Administrator privileges on bothnodes of the cluster to which you want to connect. Next, enter the cluster alias and the accountdomain name. (A user name, password, and domain are not required if the account that youused to log on to your PC has Administrator privileges on the cluster.)

8

Lesson 2-3: Invoking Oracle Fail Safe Manager and Verifying the ClusterVerifying the Cluster

Before beginning work with Oracle Fail Safe Manager, verify that the cluster hardware andsoftware are correctly configured by using the Verify Cluster command. On the Troubleshootingmenu, click Verify Cluster. (If this is your first time using Oracle Fail Safe, a window asking youto verify the cluster will open immediately after you connect to the cluster.)

9

Lesson 2-4: Invoking Oracle Fail Safe Manager and Verifying the ClusterViewing the Results of the Clusterwide Operation

Oracle Fail Safe displays the progress of the Verify Cluster operation.

10

Lesson 3-1: Creating a GroupInvoking the Create Group Wizard

Creating a group is the first step in making a resource (database, Forms Server, Reports Server,and so on) highly available. On the Groups menu, click Create to open the Create GroupWizard.

11

Lesson 3-2: Creating a GroupNaming and Describing the Group

The Create Group Wizard steps you through the process of creating a group. Enter Tutorial as aname for the group, and if you want, enter a description of the group.

12

Lesson 3-3: Creating a GroupSpecifying the Failback Policy

Select Allow Failback. Failback is an operation whereby a group that has previously failed over isreturned to the node on which you prefer it to run. Select Fail Back between, and enter 2 and 3hours, respectively. This means that failback will occur between 2 a.m. and 3 a.m.

13

Lesson 3-4 Creating a GroupSpecifying the Preferred Node

When a previously unavailable node comes back online, the cluster software reads the preferrednodes list to determine if the group should be failed back to a preferred node. The first runningnode in the preferred nodes list is the one to which the group will fail back. If you do not specify apreferred nodes list, failback is disabled and the group will never fail back. If you specify apreferred nodes list, you can also specify when failback occurs.Move one of the nodes in the Available Nodes list to the Preferred Nodes list.

14

Lesson 3-5: Creating a GroupFinish Creating the 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 propertiesare correct, click OK, and Oracle Fail Safe creates the group.

15

Lesson 3-6: Creating a GroupResponding 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 networkaddress, 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 the next lesson, thetutorial will show you how to add a virtual address as a separate step.The next lesson of the tutorial will show you how to create a virtual address.

16

Lesson 4-1: Adding a Virtual Address to a GroupOpening the Add Resource to Group Wizard

Oracle Fail Safe Manager does not allow you to add any other resources (except a genericservice) to a group until at least one virtual address has been added to the group. Without avirtual address, clients cannot connect to resources that have been added to a group. Becauseyou did not add a virtual address to the group in the previous lesson, add one now. On theResources menu, click Add to Group to open the Add Resource to Group Wizard.

17

Lesson 4-2: Adding a Virtual Address to a GroupSpecifying the Resource Type and Group

On the first page of the wizard, select the Virtual Address resource type, the Tutorial group, andthen click Next.

18

Lesson 4-3: Adding a Virtual Address to a GroupDescribing the Network

When you add a virtual address to a group, you need to define the network on which the virtualaddress runs. If you do not know which addresses are available as virtual addresses on yourcluster, ask your cluster administrator. Enter the data in this wizard page as follows:1. In the Network section of the page, accept the default selections.2. In the Virtual Address section of the page, enter the host name for the virtual address in the

Host Name box, and then press the Tab key. (When you press the Tab key, Oracle FailSafe resolves the host name to an IP address.)

3. Click Finish.

19

Lesson 4-4: Adding a Virtual Address to a GroupFinish Adding the Virtual Address

Oracle Fail Safe asks you to check the properties you have selected for the virtual address. Ifthey are correct, click OK. Otherwise, click Cancel and then Back to change the properties.After you add at least one virtual address to a group, you are ready to configure a resource (suchas an Oracle database, Oracle Forms Server, Oracle Reports Server, Oracle Application Server,or other resource) for high availability.

20

Lesson 4-5: Adding a Virtual Address to a GroupViewing the Group Properties

You frequently need the virtual address or addresses of a group when you are adding resourcesto a 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 sheet for the group.In the tree view, select the Tutorial group and then click the Virtual Addresses tab. This propertysheet shows the virtual address that you just added to the group.

21

Lesson 5-1: Creating a Sample DatabaseOpening the Create Sample Database Dialog Box

This lesson shows you how to create a sample database with which you can try out the featuresof Oracle Fail Safe before using them on a production database. (System software requirementsfor this lesson are described in Lesson 1.) On the Resources menu, select Create Sample, thenclick Database to open the Create Sample Database dialog box.

22

Lesson 5-2: Creating a Sample DatabaseUsing the Create Sample Database Dialog Box

Enter a service name of Tutorial_DB, select a disk and node combination on which to build thesample database, and select the version of the Oracle database you want to create and theOracle home in which to create it. Specify Internal for the user name and Internal for thepassword. Click OK to have Oracle Fail Safe create the Tutorial_DB sample database for you.

23

Lesson 5-3: Creating a Sample DatabaseViewing the Progress of the Clusterwide Operation

Oracle Fail Safe displays the progress of the Create Sample Database operation.

24

Lesson 6-1: Verifying a Standalone DatabaseUsing the Verify Standalone Database Command

If you add a standalone database to a group (and you did not create that database with theCreate Sample Database dialog box), you should verify the database before adding it to a group.When you verify a database, Oracle Fail Safe uses data that you supply to attempt to fix anyproblems it finds clusterwide. Because Oracle Fail Safe created it, you do not need to verify theTutorial_DB database. However, for the purposes of demonstration in this tutorial, we will do so.In the tree view, select the Tutorial_DB database. Then, in the Troubleshooting menu, click VerifyStandalone Database.

25

Lesson 6-2: Verifying a Standalone DatabaseUsing the Verify Standalone Database Dialog Box

The contents of all fields are retrieved automatically. If a value is too long for its field, you maynot see the entire value. Enter and confirm the password (if necessary), then click OK.

26

Lesson 6-3 Verifying a Standalone DatabaseViewing the Progress of the Clusterwide Operation

Oracle Fail Safe displays the results of the Verify Standalone Oracle Database operation.

27

Lesson 7-1: Adding a Sample Database to a GroupInvoking the Add Resource to Group Wizard

This lesson shows how to add a database to a group. When you add a database to a group, youmake that database highly available. If the node on which the database is currently running istaken offline or fails, the database will be restarted on the surviving cluster node.In the tree view, select the Tutorial_DB database, then on the Resources menu click Add toGroup.

28

Lesson 7-2: Adding a Sample Database to a GroupUsing the Add Resource to Group Wizard

The Add Resource to Group Wizard steps you through the process. On this page, select OracleDatabase (if it is not already selected) and select the Tutorial group. Click Next.

29

Lesson 7-3: Adding a Sample Database to a GroupSpecifying the Database Identity

The Service Name, Instance Name, Database Name, and Parameter File fields are all retrievedautomatically. Click Next.

30

Lesson 7-4: Adding a Sample Database to a GroupSpecifying the Database Internal Account

Select “Use this account” to use the Internal account to access the database for configurationinformation and for polling the database to determine its state. Enter and confirm the password(Internal) for the database Internal account, then click Finish. A message window will inform youthat the database will be shut down. Click OK.

31

Lesson 7-5: Adding a Sample Database to a GroupFinishing

Oracle Fail Safe asks you to check the properties you have selected for the database. If they arecorrect, click OK. Otherwise, click Cancel and then click Back to change the properties.

32

Lesson 7-6: Adding a Sample Database to a GroupShutting Down the Database

If the sample database is running, Oracle Fail Safe will warn you before it shuts down thedatabase. Click Yes to continue the process or No to cancel.

33

Lesson 7-7: Adding a Sample Database to a GroupViewing the Progress of the Clusterwide Operation

Oracle Fail Safe displays the progress of the Add Database to Group operation.

34

Lesson 8-1: Verifying a GroupUsing the Verify Group Command

A group verification checks that a group is configured correctly. Over time, as your systembecomes more complex and hardware and software configurations change, you may find thatresource dependencies are incorrect or client applications can no longer access a group. TheVerify Group command makes it easy to restore the configuration to working order. When youuse a Verify Group command, Oracle Fail Safe attempts to correct any configuration problems itfinds. It is not necessary to verify a group immediately after you create it, but it is done in thislesson to demonstrate the operation.In the tree view, right-click the Tutorial group name, then click Verify Group.

35

Lesson 8-2: Verifying a GroupViewing Progress

Because the Verify Group operation is applied clusterwide and involves numerous steps, it cantake a few minutes to complete. Oracle Fail Safe Manager displays the progress of the operationto you. Click OK in the status window and Close in the Clusterwide Operation: Verifying Group“Tutorial” window.

36

Lesson 9-1: Balancing the WorkloadPerforming a Planned Failover

Oracle Fail Safe Manager makes it easy to balance the workload across the nodes in thecluster.To follow this lesson, create three groups: Sales, Marketing, and Customers. Create Sales andMarketing on one node (NTCLU-61 is used in this example). Create Customers on the other node(NTCLU-62 in this example). Suppose that you have recently added more CPUs to NTCLU-62.Node NTCLU-62 can better handle the load of Sales and Marketing, and NTCLU-61 would now bea better place for Customers. You can move the groups to the new, more capable system withminimal interruption in service to your users. Because NTCLU-62 is the more robust system, thefirst step (shown in Lesson 9-2) will be to move the groups to NTCLU-62.

The current configuration looks like this:

37

Lesson 9-2: Balancing the WorkloadMoving the Sales Group

Drag and drop the Sales group from NTCLU-61 to NTCLU-62. (Your node names will be different.)

38

Lesson 9-3: Balancing the WorkloadMoving the Marketing Group

Drag and drop the Marketing group from NTCLU-61 to NTCLU-62.

39

Lesson 9-4: Balancing the WorkloadMoving the Customers Group

Drag and drop the Customers group from NTCLU-62 to NTCLU-61.

40

Lesson 9-5: Balancing the WorkloadChecking the Preferred Nodes List

Check the Preferred Nodes list to make sure that the first node in the list is the one on whichyou want the database to run when both nodes are up.Select the Sales group from the tree view and click the Nodes tab. The data on this pageindicates that NTCLU-61 is the preferred node. However, now that you have rearranged theconfiguration, you probably want NTCLU-62 to be the preferred node. With the current settings, ifNTCLU-62 fails and the Sales group fails over to NTCLU-61, the Preferred Nodes list indicatesthat you prefer the Sales group to reside on NTCLU-61. Failback will not occur when NTCLU-62comes online. Rearrange the Preferred Nodes list so that NTCLU-62 is first in the list andNTCLU-61 is second. (Select NTCLU-62 in the Preferred Nodes list and click the up arrow.)Repeat this process for Customers and Marketing, ensuring that the node on which you wanteach group to reside when both cluster nodes are up is first in the Preferred Nodes list.

41

Lesson 9-6: Balancing the WorkloadBalanced Workload

When you finish the planned failover, Oracle Fail Safe Manager updates the tree view to displaythe new state.

42

Lesson 10-1: Identifying the Location of Fail-Safe Databases to ClientApplicationsUpdating TNSNAMES.ORA

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 bythe virtual address of the group.If your end-user applications use TNSNAMES.ORA to locate databases, use a tool such asOracle Net8 Assistant to change the host value in TNSNAMES.ORA from the physical nodeaddress to the virtual address of the group.

43

Lesson 11-1: Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupPreparations

This lesson demonstrates how to make an Oracle Forms application deployed on the Web highlyavailable. This is done by making both the Oracle Forms Server and an Oracle Application Serverhighly available. (Note that an Oracle HTTP Server could be used instead of the OracleApplication Server, if desired.)Because this lesson requires preparation, you might find it helpful to print this topic beforecontinuing. To print this topic, click the Options button at the top of this window, then click PrintTopic.Use the following table to record data that is specific to your configuration. The first column liststhe items needed for this lesson. The second column lists the values used in this tutorial. In thethird column, enter the values that correspond to your configuration.

Item Tutorial Value Your ValueVirtual address of group Forms_Group IP address 138.2.26.68 ____________ network name ntclu-68 ____________Cluster disk and directory for FormsServer files

P:\Forms ____________

Oracle home where Oracle ApplicationServer was installed

OAS ____________

Directory specification for Oracle homewhere Oracle Developer 6I wasinstalled

D:\Orant ____________

1. Make sure the system software requirements have been met, as described in Lesson 1.2. Create a group called Forms_Group and add a virtual address to it, as described in Lesson 3

and Lesson 4.3. Install the demo database objects that ship with Oracle Developer release 6i, using the

Tutorial_DB database that you created in Lesson 5:− Copy \extras\forms\SQL\demos60.sql from the Oracle Developer 6i CD-ROM to your

system.− Connect to your database and run demos60.sql.

4. Create a \Forms directory on a cluster disk that you have designated for the Forms Server.5. Copy the calcform.fmx file in <Oracle_Home>\fs\fsmgr on one of the cluster nodes to the

\Forms directory that you created in step 4.6. Copy WebForm.htm from <Oracle_Home>\fs\fsmgr on one of the cluster nodes to the

\Forms directory that you created in step 4. This will be the default page for the Weblistener. If your system does not have Oracle Fail Safe Manager installed, you will need tocopy the WebForm.htm file from a system that does have Oracle Fail Safe Managerinstalled, or install Oracle Fail Safe Manager on a cluster node.

44

Lesson 11-2: Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupUsing the Add Resource to Group Wizard

Oracle Fail Safe can add an existing Forms Server to a group, or it can both create and add aForms Server to a group; both are done using the Add Resource to Group Wizard. This lessonwill first create and add a Forms Server to the Forms_Group group. Then it will add an OracleApplication Server Web listener to the group so that the form can be viewed on the Web.On the Resources menu, click Add to Group.

45

Lesson 11-3: Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupSpecifying the Resource and Group

Select Oracle Forms Server as the resource type and select Forms_Group as the group to whichto add the Forms Server. Click Next.

46

Lesson 11-4: Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupSpecifying the Forms Server Identity

Enter the name Forms_Tutorial in the Forms Server Name box and accept the default port of9000. Click Next.

47

Lesson 11-5 Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupSpecifying the Forms Server Parameters

Accept the default values and click Next.

48

Lesson 11-6: Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupSpecifying the Path That the Forms Server Uses

Click Add and enter the directory specification for the location where you copied thecalcform.fmx file (described in Lesson 11-1). Click OK, then click Next.

49

Lesson 11-7: Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupSpecifying the Databases That the Forms Server Uses

Specify the database or databases that the forms using the Forms Server will access. In theAvailable box, select Tutorial_DB, then click the right arrow. Click Finish.

50

Lesson 11-8: Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupFinish Creating and Adding the Forms Server to the Group

Oracle Fail Safe asks you to check the properties you have selected for the Forms Server. If theyare correct, click OK. Otherwise, click Cancel and then Back to change the properties in thewizard.Don’t forget to retake this screen shot if values in 11-5 change.

51

Lesson 11-9: Creating and Adding a Forms Server and an Oracle ApplicationServer to a GroupMonitoring 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 resourceswithin the group as Oracle Fail Safe configures and tests the cluster environment.

52

Lesson 11-10: Creating and Adding a Forms Server and an OracleApplication Server to a GroupAdding an Oracle Application Server to the Group

To view forms through a Web browser, you must add an Oracle Application Server or an OracleHTTP Server to the Forms_Group. In this lesson, you will add an Oracle Application Server to thegroup. When you add an Oracle Application Server to a group, the wizard asks you to provideinformation about the Oracle Application Server Web listener. Select the Forms_Group from thetree view, then on the Resources menu, click Add to Group.

53

Lesson 11-11: Creating and Adding a Forms Server and an OracleApplication Server to a GroupSpecifying the Resource and Group

Select Oracle Application Server as the resource type and select Forms_Group as the group towhich to add the Oracle Application Server. Click Next.

54

Lesson 11-12: Creating and Adding a Forms Server and an OracleApplication Server to a GroupSpecifying the Oracle Application Server Web Listener ID

When you add an Oracle Application Server to a group, Oracle Fail Safe requests informationabout the Oracle Application Web listener. Because you are creating a new Oracle ApplicationServer Web listener, accept the default in the Node Name box. (If you were adding an existingOracle Application Server Web listener, you would select the node where that listener wasrunning.) In the Oracle Home box enter the name of the Oracle home where the OracleApplication Server that supports the Web listener is installed. In the Web Listener Name box,enter MyWeb. Click Next.

55

Lesson 11-13: Creating and Adding a Forms Server and an OracleApplication Server to a GroupSpecifying Default Files

This lesson uses WebForm.htm as the home page for the Web site. Therefore, in the RootDirectory box, enter the disk and directory to which you copied the WebForm.htm file Lesson 11-1.In the Initial File box, enter WebForm.htm. This is the file you copied from<Oracle_Home>\fs\fsmgr in Lesson 11-1. It contains the code needed to present the calcformform on the Web. Do not click Next.

56

Lesson 11-14: Creating and Adding a Forms Server and an OracleApplication Server to a GroupSpecifying Virtual Directories

Click Add and enter Web_Code as the virtual directory for the Java code needed to run theForms Java applet. Enter the drive where Oracle Developer release 6i is installed on your clusterand the directory specification <Oracle_Home>\Forms60\Java for the physical directory. (Avirtual directory maps a name to a physical directory specification. You specify a virtual directoryto hide your file structure from end users. If the physical directory changes, the URL specified byend users does not change.) Click OK. When you click Next, you will get a message warningyou to make sure that the files are installed in the same location on both cluster nodes. If OracleDeveloper release 6i was installed in the same location on both cluster nodes, you can safelyignore this warning. Click Next.

57

Lesson 11-15: Creating and Adding a Forms Server and an OracleApplication Server to a GroupSpecifying the Virtual Address

Select the available IP address and then click the right arrow. Enter a port of 1067. The networkname associated with the HTTP address is the address readers will use to access the Web site.Click Finish.

If port 1067 is already in use by another application on your cluster, select a different port. Also,specify this port in the URL in Lesson 11-17.

58

Lesson 11-16: Creating and Adding a Forms Server and an OracleApplication Server to a GroupFinish Creating and Adding the Web Listener to the Group

Oracle Fail Safe asks you to check the properties you have selected for the Oracle ApplicationServer Web listener. If they are correct, click OK. Otherwise, click Cancel and then Back tochange the properties in the wizard.

59

Lesson 11-17: Creating and Adding a Forms Server and an OracleApplication Server to a GroupMonitoring 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 resourceswithin the group as Oracle Fail Safe configures and tests these resources in the clusterenvironment. If the Oracle Application Server has not already been started on either cluster node,it will be started now. This can take 3 to 4 minutes to complete.

60

Lesson 11-18: Creating and Adding a Forms Server and an OracleApplication Server to a GroupViewing the Fail-Safe Form

After you configure a Forms Server and an Oracle Application Server for high availability, you cantest the configuration, as follows:1. Check the contents of WebForm.htm to make sure that the following information is correct:

• The serverPort parameter matches the port number of your Oracle Forms Server (inthis case, 9000).

• The version number of the type parameter matches your version of Jinitiator (in thiscase, 1.1.7.15).

2. In a Web browser, using the format virtual-address:port (for example, ntclu-68:1067), enterthe virtual address and the port of the Oracle Application Web listener as the URL.

3. When prompted, enter the user name, password, and name of the database that the form isaccessing. (In this example, Tutorial_DB.us.oracle.com).

4. After the form loads, alter some data in the form and then, on the Action menu of the Javaapplet, click Save.

5. Using Oracle Fail Safe, drag and drop Forms_Group from its current node to the other node.(This results in a planned failover.)

6. In the Web browser, click Reload to refresh the form and display the changes you made tothe data.

61

Lesson 12-1: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupPreparations

This lesson demonstrates how to make an Oracle Reports application deployed on the Webhighly available. This is done by making both the Oracle Reports Server and an Oracle HTTPServer highly available. (Note that an Oracle Application Server could be used instead of theOracle HTTP Server, if desired.)If you want to deploy a non-Web Oracle Reports application, you need only follow this lesson toscreen 12-9. If you schedule jobs for the Reports Server using the Reports Queue Manager, thejob scheduling will be highly available.Because this lesson requires preparation, you might find it helpful to print this topic beforecontinuing. To print this topic, click the Options button at the top of this window, then click PrintTopic.Use the following table to record data that is specific to your configuration. The first column liststhe items needed for this lesson. The second column lists the values used in this tutorial. In thethird column, enter the values that correspond to your configuration.

Item Tutorial Value Your ValueVirtual address of group Reports_Group IP address 138.2.26.69 ____________ Network name ntclu-69 ____________Cluster disk and directory for ReportsServer source files

N:\Reports_Source ____________

Cluster disk and directory for ReportsServer cache files

N:\Reports_Cache ____________

Cluster disk and directory for ReportsServer scheduled jobs

N:\Reports_Jobs ____________

Cluster disk and directory for Apachefiles

N:\Apache ____________

User account (including user name,password, and domain) on the clusterconfigured for printing

AllyninternalNEDCDOMAIN

____________________________________

Directory specification for Oracle homewhere Oracle Developer 6i was installed

E:\Orant ____________

Oracle home where Oracle HTTP Serveris installed

APACHE ____________

1. Make sure the system software requirements have been met, as described in Lesson 1.2. Create a group called Reports_Group and add a virtual address to it, as described in Lesson

3 and Lesson 4.3. If you have not already done so, install the demo database objects that ship with Oracle

Developer release 6i, using the Tutorial_DB database that you created in Lesson 5:− Copy \extras\reports\SQL\rdemos60.sql from the Oracle Developer 6i CD-ROM to your

system.− Connect to your database and run rdemos60.sql.

62

4. Create a \Reports_Source directory, a \Reports_Cache directory, and a \Reports_Jobsdirectory on a cluster disk that you want to use for the reports server.

5. Create an \Apache directory on a cluster disk. In the Apache directory, create an \htdocsdirectory.

6. Copy the sample.rdf file in <Oracle_Home>\fs\fsmgr on one of the cluster nodes to the\Reports_Source directory that you created in step 4.

7. Copy WebReport.htm from <Oracle_Home>\fs\fsmgr on one of the cluster nodes to theApache\htdocs directory. This will be the default page for the Web server. If your systemdoes not have Oracle Fail Safe Manager installed, copy the WebReport.htm file from asystem that does have Oracle Fail Safe Manager installed, or install Oracle Fail SafeManager on a cluster node.

63

Lesson 12-2: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupInvoking the Add Resource to Group Wizard

This lesson creates and adds a Reports Server to the Reports_Group group. It then creates andadds an Oracle HTTP Server to the same group. The Oracle HTTP Server is used to view thereport output.On the Resources menu, click Add to Group.

64

Lesson 12-3: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying the Resource and Group

Select Oracle Reports Server as the resource type and select Reports_Group as the group towhich to add the Reports Server. Click Next.

65

Lesson 12-4: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying the Reports Server Identity

Enter Reports_Tutorial as the name for the Reports Server. Accept the default port. Click Next.

66

Lesson 12-5: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying the Reports Server Disks and Directories

Enter the directory specifications for the Reports Server cache directory, source directory, andjobs directory that you created in Lesson 12-1. Click Next.

67

Lesson 12-6: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying the Databases Used by the Reports Server

Select the Tutorial_DB database from the Available box, then click the right arrow to move thedatabase to the Selected box. This tells Oracle Fail Safe that the reports served by theReports_Tutorial server access the Tutorial_DB database. Click Next.

68

Lesson 12-7: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying 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 NT SYSTEM user does not have access to printers. Therefore, specify a useraccount and password that the Reports Server can use to access a printer. Click Finish.

69

Lesson 12-8: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupFinish Creating and Adding a Reports Server to a Group

Oracle Fail Safe asks you to check the properties you have selected for the Reports Server. Ifthey are correct, click OK. Otherwise, click Cancel and then Back to change the properties inthe wizard.

70

Lesson 12-9: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupMonitoring the Clusterwide Operation

After you complete the wizard, Oracle Fail Safe configures the resources in the group. You canwatch the progress of this operation and view the status of the individual resources within thegroup as Oracle Fail Safe configures and tests them in the cluster environment. If you were usingthe Reports Server to generate text files, you would now be ready to schedule jobs with theReports Queue Manager. However, the rest of this lesson shows how to configure a Web serverso that your reports will be highly available on the Web.

71

Lesson 12-10: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupAdding an Oracle HTTP Server to the Group

To view reports through a Web browser, you need a Web server. In this portion of the lesson, youwill add an Oracle HTTP Server to Reports_Group. Select Reports_Group from the tree view, thenon the Resources menu, click Add to Group.

72

Lesson 12-11: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying the Resource and Group

Select Oracle HTTP Server as the resource type and select Reports_Group as the group towhich to add the Oracle HTTP Server. Click Next.

73

Lesson 12-12: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying the Oracle HTTP Server ID

Enter Reports_Site in the Oracle HTTP Server Name box. The Version/Home box should be filledin automatically. In the Server Root box, enter the cluster disk on which you created the Apachedirectory in Lesson 12-1. This lesson uses the sample.rdf file as the home page for the Web site.Click Next.

74

Lesson 12-13: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying Default Files

Click Add in the upper half of the wizard window. In the File Name box, enter WebReport.htmand then click OK. The WebReport.htm file is the file that you copied from<Oracle_Home>\fs\fsmgr to the \Apache\htdocs directory in Lesson 12-1. It contains the URLneeded to present the report on the Web. Do not click Next.

75

Lesson 12-14: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying the First Virtual Directory

A virtual directory maps a name to a physical directory specification. You specify virtualdirectories to hide your file structure from end users. If a physical directory changes, the URLspecified by end users does not change.Follow these steps to specify the first of the virtual directories needed for accessing the report:1. Click Add in the lower half of the wizard window.2. In the Virtual Directory box, enter /web_cgi.3. In the Physical Directory box, enter the specification for the bin directory of the Oracle home

where you installed Oracle Developer release 6i. (This provides a pointer to the rwcgi60.execgi file needed to present your report on the Web.)

4. Check the Allow CGI execution check box, to ensure that CGI can be executed in the virtualdirectory.

5. Click OK.(A message is returned warning you to make sure that the files are installed in the samelocation on both cluster nodes. If Oracle Developer release 6i was installed in the samelocation on both cluster nodes, you can safely ignore this warning.)

6. Do not click Next.

76

Lesson 12-15: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying a Second Virtual Directory

Follow these steps to add a second virtual directory to specify where the Reports Server outputfile is located:1. Click Add in the lower half of the wizard window again.2. In the Virtual Directory box, enter /output.3. In the Physical Directory box, enter the directory specification for the Reports cache file that

you provided in Lesson 12-5.4. Click OK.5. Click Next.

77

Lesson 12-16: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupSpecifying the Virtual Address

On this page you specify the virtual address at which users can access the Web site where thereport will be displayed. In the top portion of this page, select the available IP address, click theright arrow, and then enter a port of 4000. Click Finish.

If port 4000 is already in use by another application on your cluster, select a different port. If youspecify a different port, edit WebReport.htm to specify the port you select.

78

Lesson 12-17: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupFinish Creating and Adding the Oracle HTTP Server to the Group

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 inthe wizard.

79

Lesson 12-18: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupMonitoring 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 resourceswithin the group as Oracle Fail Safe configures and tests them in the cluster environment.

80

Lesson 12-19: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupAdjusting the .HTM File

The WebReport.htm file that you copied to the Reports_Source directory must be customizedwith your data before you can view the report on the Web. Change the network name in this fileto the network name upon which the Oracle HTTP Server has a dependency. In the tree view,select the Oracle HTTP Server. Click the Virtual Addresses tab to display the host name and IPaddress. Open WebReport.htm and replace the value ntclu4-6:4000 with the host name and portnumber shown on the Virtual Addresses tab. If necessary, replace the value Tutorial_DB.worldwith the name and domain of your database.The following shows the text that you need to adjust in the WebReport.htm file:

<A HREF="http://ntclu4-6:4000/web_cgi/rwcgi60.exe?server=Reports_Tutorial+report=sample+userid=internal/internal@Tutorial_DB.world+destype=cache+desformat=HTML">Click here to generate and display report</A>

81

Lesson 12-20: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupAdjusting Registry Values

Before you can view the report on the Web, you must adjust the Windows NT registry values onall cluster nodes so that they reflect the changes you have made. At the command prompt, typeregedit, and under HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE, add these key values:REPORTS60_PHYSICAL_MAP: N:\Reports_CacheREPORTS60_VIRTUAL_MAP: /output

82

Lesson 12-21: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupViewing the Fail-Safe Report

After you configure a Reports Server and an Oracle HTTP Server for high availability, you canview the report. In a Web browser, enter the virtual address and port number of Oracle HTTPServer as the URL.Click the text in the browser window as directed.

83

Lesson 12-22: Creating and Adding a Reports Server and an Oracle HTTPServer to a GroupViewing the Fail-Safe Report

You can now test the high availability of the configuration as follows:1. Note the date and time in the report presented in the Web browser.2. Using Oracle Fail Safe, drag and drop the group from its current node to the other node.

(This results in a planned failover.)3. In the Web browser, click reload to reload the report in the Web browser with the current

time displayed.

84

Lesson 13-1: Creating and Adding an Oracle WebDB Listener to a GroupPreparations

This lesson demonstrates how to make an Oracle WebDB listener highly available. Systemsoftware requirements for this lesson are described in Lesson 1.Because this lesson requires preparation, you might find it helpful to print this topic beforecontinuing. To print this topic, click the Options button at the top of this window, then click PrintTopic.Use the following table to record data that is specific to your configuration. The first column liststhe items needed for this lesson. The second column lists the values used in this tutorial. In thethird column, enter the values that correspond to your configuration.

Item Tutorial Value Your ValueOracle WebDB listener name Tutorial_WebDB ____________Port number for the OracleWebDB listener

88 ____________

Cluster disk on which OracleFail Safe should place theOracle WebDB listenerconfiguration file

O:\ ____________

The Oracle WebDB databasethat the listener services

Tutorial_DB.us.oracle.com ____________

User account (including username and password) to connectto the Oracle WebDB database(optional)

webdbwebdb

________________________

Oracle home where WebDB isinstalled

WEBDB ____________

85

Lesson 13-2: Creating and Adding an Oracle WebDB Listener to a GroupInvoking the Add Resource to Group Wizard

This lesson creates and adds a WebDB listener to the Tutorial group.On the Resources menu, click Add to Group.

86

Lesson 13-3: Creating and Adding an Oracle WebDB Listener to a GroupSpecifying the Resource and Group

Select Oracle WebDB Listener as the resource type and select Tutorial as the group to which toadd the WebDB listener. Click Next.

87

Lesson 13-4: Creating and Adding an Oracle WebDB Listener to a GroupSpecifying the WebDB Listener Identity

Enter Tutorial_WebDB as the name of the WebDB listener. Accept the default Oracle Home andport number. Click Next.

88

Lesson 13-5: Creating and Adding an Oracle WebDB Listener to a GroupSpecifying the Database

In the box at the top of the Wizard window, select the database to which the WebDB listener willconnect. The database details are shown in the lower box. Click Next.

Selecting a database is optional; if you specify None, click Finish to move to Lesson 13-7.

89

Lesson 13-6: Creating and Adding an Oracle WebDB Listener to a GroupSpecifying the Database

You can enter the user name and password to connect to the Oracle WebDB database in theappropriate fields. Click Finish.

If you do not enter a user name and password, the [DAD_Default] section in wdbsvr.app must bemodified. You may modify the values by using the WebDB Listener property sheet in Oracle FailSafe Manager.

90

Lesson 13-7: Creating and Adding an Oracle WebDB Listener to a GroupFinish Creating and Adding a WebDB Listener to a Group

Oracle Fail Safe asks you to check the properties you have selected for the Oracle WebDBlistener. If they are correct, click OK. Otherwise, click Cancel and then Back to change theproperties in the wizard.

91

Lesson 13-8: Creating and Adding an Oracle WebDB Listener to a GroupMonitoring the Clusterwide Operation

After you complete the wizard, Oracle Fail Safe configures the resources in the group. You canwatch the progress of this operation and view the status of the individual resources within thegroup as Oracle Fail Safe configures and tests them in the cluster environment.

92

Lesson 13-9: Creating and Adding an Oracle WebDB Listener to a GroupUsing the Fail-Safe Listener

After you configure a WebDB listener for high availability, you can access your database at thevirtual address of the group. In a Web browser, enter the virtual address and port number of theWebDB listener as the URL.

93

Lesson 14-1: Removing a Resource from a GroupUsing the Remove from Group Command

When you are done experimenting with a resource, you probably want to delete it from thecluster. Before you can delete it from the cluster, you must first remove it from the group towhich you added it. Note that you can only use the Remove from Group command to removethose resources from a group that you added with the Add Resource to Group Wizard.

In the tree view, select Reports_Tutorial. Then, on the Resources menu, click Remove fromGroup.

94

Lesson 14-2: Removing a Resource from a GroupMonitoring the Clusterwide Operation

Oracle Fail Safe asks you to confirm that you want to remove the resource from the group. If youclick Yes, Oracle Fail Safe opens a window and begins the remove operation. The upper portionof the window displays the status of individual resources in the group, and the lower portion of thewindow displays the progress of the remove operation.(NOTE: This example will raise a warning when Oracle Fail Safe tries to remove Disk M from thecluster, because the Oracle HTTP Server also has a dependency on Disk M. The error will notaffect the removal of Reports_Tutorial, so you can ignore it.)

95

Lesson 15-1: Deleting a Resource from the ClusterUsing the Delete Standalone Command

You can use the Delete Standalone command to delete any standalone resource (except astandalone sample database) from the cluster. (See Lesson 16 for information on deleting asample database from the cluster.)

In the tree view, select Reports_Tutorial. Then, on the Resources menu, click Delete Standalone.

96

Lesson 16-1: Deleting a Sample Database from the ClusterUsing the Delete Standalone Database Command

Oracle Fail Safe Manager makes it easy to delete a sample database from the cluster. Firstremove the database from the group, using the method described in Lesson 14. Then, in the treeview, select Tutorial_DB. On the Resources menu, point to Delete Sample and then clickDatabase.

97

Lesson 16-2: Deleting a Sample Database from the ClusterAuthentication

Oracle Fail Safe opens a window to confirm that you have privileges to delete the sampledatabase. Enter and confirm the password for the Internal account.

98

Lesson 16-3: Deleting a Sample Database from the ClusterMonitoring the Clusterwide Operation

Oracle Fail Safe opens a window to display the progress of the delete sample databaseoperation.

99

Lesson 17-1: Deleting a Group from the ClusterUsing the Delete Group Command

If you created a group using Oracle Fail Safe Manager, you can delete that group using OracleFail 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 MicrosoftCluster Administrator cannot be deleted using Oracle Fail Safe Manager.In the tree view, right-click the Tutorial group, then click Delete Group.

100

ConclusionReferences

You have finished the Oracle FailSafe Manager Tutorial. For

additional information, see theOracle Fail Safe Concepts and

Administration Guide, the OracleFail Safe Quick Tour, and the Help

provided with Oracle Fail SafeManager. These are available fromthe Oracle Fail Safe Manager Help

menu.