Skip Headers
Oracle® Enterprise Manager Lifecycle Management Administrator's Guide
12c Release 3 (12.1.0.3)

E27046-20
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

35 Example Scenario: Using Oracle Site Guard

This chapter uses the Oracle Business Intelligence Enterprise Edition (EE) enterprise deployment topology as an example to illustrate the steps required to use Oracle Site Guard to manage disaster recovery on the production site and standby site. To use Oracle Site Guard, complete the following tasks:

35.1 Task 1: Setting Up Oracle Business Intelligence Enterprise Deployment

Set up your Oracle Business Intelligence enterprise deployment, as described in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence guide.

Ensure that the following requirements are met:

35.2 Task 2: Discovering Targets for the Primary Site and the Standby Site

Discover the targets for the Oracle BI Enterprise Edition Primary Site and the Standby Site on the Enterprise Manager Cloud Control. For more information, see "Discovering Targets on the Primary Site and the Standby Site".

The following targets are available:

  • Administration Server

  • Managed Servers (bi_server1 and bi_server2)

  • OPMN managed system components (WEBHOST1 and WEBHOST2)

  • Oracle RAC Database instances (CUSTDBHOST1 and CUSTDBHOST2)

Note:

Oracle Business Intelligence OPMN managed system components are not discovered in Enterprise Manager Cloud Control. To manage Oracle Business Intelligence OPMN managed system components, create custom scripts, as described in "Creating Pre-Scripts and Post-Scripts for Start or Stop Operations".

Figure 35-1 and Figure 35-2 show the available Oracle Fusion Middleware Farm and RAC Database target.

Figure 35-1 Oracle Fusion Middleware Targets

Description of Figure 35-1 follows
Description of "Figure 35-1 Oracle Fusion Middleware Targets"

Figure 35-2 Database Targets

Description of Figure 35-2 follows
Description of "Figure 35-2 Database Targets"

35.3 Task 3: Creating Production and Standby Systems for Oracle Business Intelligence

Complete the steps listed in "Creating Primary and Standby Sites". Enter BISystem1 and BISystem2 as the name for the production and standby systems respectively.

Note:

You can also create production and standby systems for Oracle Business Intelligence, using Fusion instances that are configured through Fusion application.

Figure 35-3 shows the BISystem1 system.

Figure 35-3 Generic System for the Production and Standby Site

Description of Figure 35-3 follows
Description of "Figure 35-3 Generic System for the Production and Standby Site"

35.4 Task 4: Creating Credentials

For more information, see "Creating Credentials".

35.5 Task 5: Configuring the Software Library

For more information, see "Configuring the Software Library"

35.6 Task 6: Creating Oracle Site Guard Configuration

Add the configuration for the BISystem1 and BISystem2 using one of the following options:

35.6.1 Associating Oracle Business Intelligence Sites Using Enterprise Manager Cloud Control Console

To associate BISystem2 with BISystem1, complete the following steps:

  1. Log in to Enterprise Manager as an EM_CLOUD_ADMINISTRATOR user.

  2. Select Targets, and from the drop-down menu, select Systems.

    The Systems page is displayed.

  3. Select BISystem1.

  4. Click Generic System > Site Guard > Configure.

    The Site Guard Configuration page is displayed.

  5. In the Standby System(s) section, click Add.

    The Search and Select: Standby Systems page is displayed.

  6. Choose BISystem2, and click Select.

  7. Click Save.

    The Site Guard configuration saved successfully dialog box is displayed.

  8. Click OK.

35.6.2 Associating Oracle Business Intelligence Sites Using EMCLI Commands

To add the configuration for the primary and standby sites, run the following emcli commands in the command-line interface:

emcli create_siteguard_configuration 
      -primary_system_name="BISystem1"
      -standby_system_name="BISystem2"

See Appendix F, "create_siteguard_configuration" for more information.

To display information about the association between existing primary sites and standby sites, run the following emcli commands in the command-line interface:

emcli get_siteguard_configuration
        -primary_system_name="BISystem1"
        -standby_system_name="BISystem2"

35.7 Task 7: Associating Credentials for Site

Associate the credentials for the BISystem1 and BISystem2 using one of the following options:

35.7.1 Associating Credentials for Oracle Business Intelligence Sites Using Enterprise Manager Cloud Control Console

To associate the credentials for BISystem1, complete the following steps:

  1. Log in to Enterprise Manager as an EM_CLOUD_ADMINISTRATOR user.

  2. Select Targets and then select Systems.

    The Systems page is displayed.

  3. Select BISystem1.

  4. Click Generic System > Site Guard > Configure.

    The Site Guard Configuration page is displayed.

  5. Click Credentials.

  6. In the Normal Host Credentials section, click Add.

    The Add Normal Host Credentials page is displayed.

  7. Enter the following details:

    Element Description
    Target Select the target name.
    Use Preferred Credentials If you are using preferred credentials, then select the checkbox.
    Named Credential If you are using named credentials, then select the credential name.

    Click Save.

  8. In the Privileged Host Credentials section, click Add.

    The Add Privileged Host Credentials page is displayed.

  9. Enter the following details:

    Element Description
    Target Select the target name.
    Use Preferred Credentials If you are using preferred credentials, then select the checkbox.
    Named Credential If you are using named credentials, then select the credential name.

    Click Save.

  10. In the Oracle WebLogic Administration Credentials section, click Add.

    The Add Oracle WebLogic Administration Credentials page is displayed.

  11. Enter the following details:

    Element Description
    Target Select the target name.
    Use Preferred Credentials If you are using preferred credentials, then select the checkbox.
    Named Credential If you are using named credentials, then select the credential name.

    Click Save.

  12. In the Database Credentials section, click Add.

    The Add Database Credentials page is displayed.

  13. Enter the following details:

    Element Description
    Target Select the target name
    Use Preferred Credentials If you are using preferred credentials, then select the checkbox.
    Named Credential If you are using named credentials, then select the credential name.

    Click Save.

  14. Choose the standby system, and click Select.

  15. Use the above steps to associate the credentials for BISystem2.

35.7.2 Associating Credentials for Oracle Business Intelligence Sites Using EMCLI Commands

You must associate the named credentials for the following targets:

  • Host (for normal user and users with root privileges)

  • Host (users with root privileges)

  • Oracle WebLogic Server

  • Oracle Database

Create the named credentials by running the credential framework emcli commands for the following:

Creating Credentials for Host Targets

Specify credentials for the host on which Oracle Business Intelligence Enterprise Edition (EE) is installed and configured. Run the following emcli commands in the command-line interface:

BISystem1 for Host (Normal User)

emcli create_siteguard_credential_association 
        -system_name="BISystem1"
        -credential_type="HostNormal"
        -credential_name="NC_HOSTNORMAL" 
        -credential_owner="sysman"

BISystem1 for Host (Users with Root Privileges)

emcli create_siteguard_credential_association 
        -system_name="BISystem1"
        -credential_type="HostPrivileged"
        -credential_name="NC_HOSTSUDO" 
        -credential_owner="sysman"

BISystem2 for Host (Normal User)

emcli create_siteguard_credential_association 
        -system_name="BISystem2"
        -credential_type="HostNormal"
        -credential_name="NC_HOSTNORMAL" 
        -credential_owner="sysman"

BISystem2 for Host (Users with root Privileges)

emcli create_siteguard_credential_association 
        -system_name="BISystem2"
        -credential_type="HostPrivileged"
        -credential_name="NC_HOSTSUDO" 
        -credential_owner="sysman"

See Appendix F, "create_siteguard_credential_association" for more information.

Creating Credentials for Oracle WebLogic Server Targets

Specify the credentials for Oracle WebLogic Server by running the following emcli commands in the command-line interface:

BISystem1

emcli create_siteguard_credential_association 
        -system_name="BISystem1"
        -credential_type="WLSAdmin"
        -credential_name="NC_WLSADMIN"
        -credential_owner="sysman"

BISystem2

emcli create_siteguard_credential_association 
        -system_name="BISystem2"
        -credential_type="WLSAdmin"
        -credential_name="NC_WLSADMIN" 
        -credential_owner="sysman"

See Appendix F, "create_siteguard_credential_association" for more information.

Creating Credentials for Oracle Database Targets

Specify credentials for Oracle Database by running the following emcli commands in the command-line interface:

BISystem1

emcli create_siteguard_credential_association 
        -system_name="BISystem1"
        -credential_type="DatabaseSysdba"
        -credential_name="NC_BIDBINSTANCES" 
        -credential_owner="sysman"

BISystem2

emcli create_siteguard_credential_association 
        -system_name="BISystem2"
        -credential_type="DatabaseSysdba"
        -credential_name="NC_BIDBINSTANCES" 
        -credential_owner="sysman"

See Appendix F, "create_siteguard_credential_association" for more information.

Validate that the credentials that are associated with the system, by running the following emcli commands in the command-line interface:

emcli get_siteguard_credential_association 
        -system_name="system_name"

Figure 35-4 shows the credentials associated with BISystem1.

Figure 35-4 Credentials Associated with BISystem1

Description of Figure 35-4 follows
Description of "Figure 35-4 Credentials Associated with BISystem1"

35.8 Task 8: Creating Pre-Scripts and Post-Scripts

Oracle Site Guard provides options to include user- specified scripts in the disaster recovery operation workflow. Create the following pre-scripts and post-scripts:

Note:

After you create the required script, save them to the destination directory on each of the hosts from where the script is executed.

For example, /u01/ape/oracle/admin/bi_instance/sgscripts

For more information, see "Associating Pre-Scripts and Post-Scripts".

35.8.1 Creating Pre-Scripts and Post-Scripts for Start or Stop Operations

You can create Start and Stop scripts for the Oracle Business Intelligence OPMN managed system components. To manage these system components, create the following Start and Stop scripts:

Post-Script for Start Operation on BISystem1

Create a post-script for the start operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem1"
        -operation="Start"
        -script_type="Post-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh"
        -host_name="BIHOST1"
        -host_name="BIHOST2"
        -role="Primary"
        –credential_type="HostNormal" 

See Appendix F, "create_siteguard_script" for more information.

You can associate a post-script for the start operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following path of the script:

/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh

Target Host Select BIHOST1 and BIHOST2.
Script Type Enter Post-Script.
Operation Type Enter Start.
Role Enter Primary.
Credential Type Enter Normal Host Credentials.

Pre-Script for Stop Operation on BISystem1

Create a pre- script for the stop operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem1"
        -operation="Stop"
        -script_type="Pre-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/stopbisystemcomponents.sh"
        -host_name="BIHOST1"
        -host_name="BIHOST2"
        -role="Primary"
        –credential_type="HostNormal"

See Appendix F, "create_siteguard_script" for more information.

You can associate a post-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following path of the script:

/u01/app/oracle/admin/bi_instance/sgscripts/stopbisystemcomponents.sh

Target Host Select BIHOST1 and BIHOST2.
Script Type Enter Pre-Script.
Operation Type Enter Stop.
Role Enter Primary.
Credential Type Enter Normal Host Credentials.

Post-Script for Start Operation on BISystem2

Create a post-script for the start operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem2"
        -operation="Start"
        -script_type="Post-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh"
        -host_name="STBYBI1"
        -host_name="STBYBI2"
        -role="Primary"
        –credential_type="HostNormal"

See Appendix F, "create_siteguard_script" for more information.

You can associate a pre-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following path of the script:

/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh

Target Host Select STBYBI1 and STBYBI2.
Script Type Enter Pre-Script.
Operation Type Enter Start.
Role Enter Primary.
Credential Type Enter Normal Host Credentials.

Pre-Script for Stop Operation on BISystem2

Create a post-script for the stop operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem2"
        -operation="Stop"
        -script_type="Pre-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/stopbisystemcomponents.sh"
        -host_name="STBYBI1"
        -host_name="STBYBI2"
        -role="Primary"
        –credential_type="HostNormal" 

See Appendix F, "create_siteguard_script" for more information.

You can associate a pre-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgscripts/stopbisystemcomponents.sh
Target Host Select STBYBI1 and STBYBI2
Script Type Enter Pre-Script
Operation Type Enter Stop
Role Enter Primary
Credential Type Enter Normal Host Credentials

35.8.2 Creating Pre-Scripts and Post-Scripts for Switchover or Failover Operations

You can create the following pre-scripts and post-scripts for switchover and failover operations:

35.8.2.1 Pre-Script for Switchover Operation on BISystem1

Create a pre-script for the switchover operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem1"
        -operation="Switchover"
        -script_type="Pre-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/stopbisystemcomponents.sh"
        -host_name="BIHOST1"
        -host_name="BIHOST2"
        -role="Primary"
        –credential_type="HostNormal"

See Appendix F, "create_siteguard_script" for more information.

You can associate a pre-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgscripts/stopbisystemcomponents.sh
Target Host Select BIHOST1 and BIHOST2.
Script Type Enter Pre-Script
Operation Type Enter Switchover
Role Enter Primary
Credential Type Enter Normal Host Credentials

35.8.2.2 Post-Script for Switchover Operation on BISystem1

Create a post-script for the switchover operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem1"
        -operation="Switchover"
        -script_type="Post-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh"
        -host_name="BIHOST1"
        -host_name="BIHOST2"
        -role="Standby"
        –credential_type="HostNormal"

See Appendix F, "create_siteguard_script" for more information.

You can associate a pre-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh
Target Host Select BIHOST1 and BIHOST2.
Script Type Enter Post-Script
Operation Type Enter Switchover
Role Enter Standby
Credential Type Enter Normal Host Credentials

35.8.2.3 Post-Script for Failover Operation on BISystem1

Create a post-script for the failover operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem1"
        -operation="failover"
        -script_type="Post-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh"
        -host_name="BIHOST1"
        -host_name="BIHOST2"
        -role="Standby"
        –credential_type="HostNormal"

See Appendix F, "create_siteguard_script" for more information.

You can associate a pre-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh
Target Host Select BIHOST1 and BIHOST2.
Script Type Enter Post-Script
Operation Type Enter Failover
Role Enter Standby
Credential Type Enter Normal Host Credentials

35.8.2.4 Pre-Script for Switchover Operation on BISystem2

Create a pre-script for the switchover operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem2"
        -operation="Switchover"
        -script_type="Pre-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/stopbisystemcomponents.sh"
        -host_name="STBYBI1"
        -host_name="STBYBI2"
        -role="Primary"
        –credential_type="HostNormal"

See Appendix F, "create_siteguard_script" for more information.

You can associate a pre-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgscripts/stopbisystemcomponents.sh
Target Host Select STBYBI1 and STBYBI12
Script Type Enter Pre-Script as the script type.
Operation Type Specify Switchover as the operation type.
Role Specify Primary
Credential Type Enter Normal Host Credentials

35.8.2.5 Post-Script for Switchover Operation on BISystem2

Create a post-script for the switchover operation by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem2"
        -operation="Switchover"
        -script_type="Post-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh"
        -host_name="STBYBI1"
        -host_name="STBYBI2"
        -role="Standby"
        –credential_type="HostNormal"

See Appendix F, "create_siteguard_script" for more information.

You can associate a pre-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh
Target Host Select STBYBI1 and STBYBI2
Script Type Enter Post-Script as the script type.
Operation Type Specify Switchover as the operation type.
Role Specify Primary.
Credential Type Specify Normal Host Credentials as the credential type.

35.8.2.6 Post-Script for Failover Operation on BISystem2

Create a post-script for the failover operation, by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem2"
        -operation="failover"
        -script_type="Post-Script"
        -path="/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh"
        -host_name="STBYBI1"
        -host_name="STBYBI2"
        -role="Standby"
        –credential_type="HostNormal"

See Appendix F, "create_siteguard_script" for more information.

Associate a pre-script for the stop operation by using Enterprise Manager Cloud Control Console, as described in "Associating Pre-Scripts and Post-Scripts Using Enterprise Manager Cloud Control Console".

Enter the following details in the Add Pre/Post Scripts page:

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgscripts/startbisystemcomponents.sh
Target Host Select STBYBI1 and STBYBI2
Script Type Enter Post-Script as the script type.
Operation Type Specify Failover as the operation type.
Role Specify Standby.
Credential Type Specify Normal Host Credentials as the credential type.

35.9 Task 9: Associating Storage Scripts

You can associate the storage scripts for BISystem1 and BISystem2 using one of the following options:

35.9.1 Associating Storage Scripts for Oracle Business Intelligence Sites Using Enterprise Manager Cloud Control Console

To associate the storage scripts for BISystem1, complete the following steps:

  1. Log in to Enterprise Manager as an EM_CLOUD_ADMINISTRATOR user.

  2. Select Targets and then select Systems.

    The Systems page is displayed.

  3. Select BISystem1.

  4. Click Generic System > Site Guard > Configure.

    The Site Guard Configuration page is displayed.

  5. Click the Storage Scripts tab.

  6. Click Add.

    The Add Storage Scripts page is displayed.

  7. Enter the following details:

    Element Description
    Script Path Enter the following script path:
    /u01/app/oracle/admin/bi_instance/sgstoragescripts/switchovertobisystem1.sh
    
    Target Host Select BIHOST1.
    Script Type Enter Storage-Switchover as the script type.
    Operation Type Specify Switchover as the operation type.
    Credential Type Specify Privileged Host Credentials as the credential type.

    Click Save.

  8. Use the above steps to associate the storage failover script for BISystem1. Ensure that you enter the following details:

    Element Description
    Script Path Enter the following script path:
    /u01/app/oracle/admin/bi_instance/sgstoragescripts/failovertobisystem1.sh
    
    Target Host Select BIHOST1.
    Script Type Enter Storage-Switchover as the script type.
    Operation Type Specify Failover as the operation type.
    Credential Type Specify Privileged Host Credentials as the credential type.

Create the storage switchover and failover Script for BISystem2, as described in "Associating Storage Scripts for Oracle Business Intelligence Sites Using Enterprise Manager Cloud Control Console". Ensure that you enter the following details:

Storage switchover script

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgstoragescripts/switchovertobisystem2.sh
Target Host Select STBYBI1.
Script Type Enter Storage-Switchover as the script type.
Operation Type Specify Switchover as the operation type.
Credential Type Specify Privileged Host Credentials as the credential type.

Storage failover script

Element Description
Script Path Enter the following script path:
/u01/app/oracle/admin/bi_instance/sgstoragescripts/failovertobisystem2.sh
Target Host Select STBYBI1.
Script Type Enter Storage-Failover as the script type.
Operation Type Specify Failover as the operation type.
Credential Type Specify Privileged Host Credentials as the credential type.

35.9.2 Associating Storage Scripts for Oracle Business Intelligence Sites Using EMCLI Commands

You must create storage scripts, as described in "Creating Storage Scripts" and then complete the following:

Storage Switchover Script for BISystem1

Associate a storage switchover script for BISystem1 by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem1"
        -operation="Switchover"
        -script_type="Storage-Switchover"
        -path="/home/oracle/zfs_storage_role_reversal.sh -t target.us.oracle.com -h source.us.oracle.com -j ProjectName -p TargetPoolName -q SourcePoolName -c Y -f Y -e 1800"
        -host_name="BIHOST1"
        –credential_type="HostPrivileged"

See Appendix F, "create_siteguard_script" for more information.

Storage Switchover Script for BISystem2

Associate a storage switchover script for BISystem2 by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem2"
        -operation="Switchover"
        -script_type="Storage-Switchover"
        -path="/home/oracle/zfs_storage_role_reversal.sh -t target.us.oracle.com -h source.us.oracle.com -j ProjectName -p TargetPoolName -q SourcePoolName -c Y -f Y -e 1800"
        -host_name="STBYBI1"
        –credential_type="HostPrivileged"

See Appendix F, "create_siteguard_script" for more information.

Storage Failover Script for BISystem1

Associate a storage failover script for BISystem1 by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem1"
        -operation="Failover"
        -script_type="Storage-Failover
        -path="/home/oracle/zfs_storage_role_reversal.sh -t target.us.oracle.com -h source.us.oracle.com -j ProjectName -p TargetPoolName -q SourcePoolName -c Y -f Y -e 1800"
        -host_name="BIHOST1"
        –credential_type="HostPrivileged"

See Appendix F, "create_siteguard_script" for more information.

Storage Failover Script for BISystem2

Associate a storage failover script for BISytem2 by running the following emcli commands in the command-line interface:

emcli create_siteguard_script
        -system_name= "BISystem2"
        -operation="Failover"
        -script_type="Storage-Failover"
        -path="/home/oracle/zfs_storage_role_reversal.sh -t target.us.oracle.com -h source.us.oracle.com -j ProjectName -p TargetPoolName -q SourcePoolName -c Y -f Y -e 1800"
        -host_name="STBYBI1"
        –credential_type="HostPrivileged"

See Appendix F, "create_siteguard_script" for more information.

35.10 Task 10: Creating Operation Plans

You must create the following operation plans:

For more information, see Executing Oracle Site Guard Operations.

35.10.1 Operation Plan to Start Operation on BISystem1

You can create an operation plan for a start operation on BISystem1, using one of the following methods:

Start Operation on BISystem1 Using EMCLI

Create a start operation plan by running the following emcli commands in the command-line interface:

emcli create_operation_plan
        _system_name="BISystem1"
        -operation="Start"
        -name="start-bisystem1"
        -role="Primary"

See Appendix F, "create_operation_plan" for more information.

Start Operation on BISystem1 Using Enterprise Manager Cloud Control Console

Create a start operation plan for BISystem1 by following these steps in the Enterprise Manager Cloud Control console:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISytem1 home page, from the Generic System menu, select Site Guard, then Operations.

  4. Click Create. The Create New Operation Plan screen is displayed.

  5. Enter start-bisystem1 as the plan name.

  6. From the list, select Start as the operation type.

  7. The Primary System element on the page displays BISystem1 as the system for which this plan is created.

  8. Click Save.

35.10.2 Operation Plan to Stop Operation on BISystem1

You can create an operation plan for a stop operation on BISystem1, using one of the following methods:

Stop Operation on BISystem1 Using EMCLI

Create a stop operation plan by running the following emcli commands in the command-line interface:

emcli create_operation_plan
        -system_name="BISystem1"
        -operation="Stop"
        -name="stop-bisystem1"
        -role="Primary"

See Appendix F, "create_operation_plan" for more information.

Stop Operation on BISystem1 Using Enterprise Manager Cloud Control Console

Create a stop operation plan for BISystem1 by following these steps in the Enterprise Manager Cloud Control console:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISytem1 home page, from the Generic System menu, select Site Guard, then Operations.

  4. Click Create. The Create New Operation Plan screen is displayed.

  5. Enter stop-bisystem1 as the plan name.

  6. From the list, select Stop as the operation type.

  7. The Primary System element on the page displays BISystem1 as the system for which this plan is created.

  8. Click Save.

35.10.3 Operation Plan to Start Operation on BISystem2

You can create an operation plan for a start operation on BISystem2, using one of the following methods:

Start Operation on BISystem2 Using EMCLI

Create a start operation plan by running the following emcli commands in the command-line interface:

emcli create_operation_plan
        -system_name="BISystem2"
        -operation="Start"
        -name="start-bisystem2"
        -role="Standby"

See Appendix F, "create_operation_plan" for more information.

Start Operation on BISystem2 Using Enterprise Manager Cloud Control Console

Create a start operation plan for BISystem2 by following these steps in the Enterprise Manager Cloud Control console:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem2.

  3. On the BISytem1 home page, from the Generic System menu, select Site Guard, then Operations.

  4. Click Create. The Create New Operation Plan screen is displayed.

  5. Enter start-bisystem1 as the plan name.

  6. From the list, select Start as the operation type.

  7. From the list of Standby System, select either BISystem2 as the standby system.

  8. Click Save.

35.10.4 Operation Plan to Stop Operation on BISystem2

You can create an operation plan for a stop operation on BISystem2, using one of the following methods:

Stop Operation on BISystem2 Using EMCLI

Create a stop operation plan by running the following emcli commands in the command-line interface:

emcli create_operation_plan
        -system_name="BISystem2"
        -operation="Stop"
        -name="stop-bisystem2"
        -role="Standby"

See Appendix F, "create_operation_plan" for more information.

Stop Operation on BISystem2 Using Enterprise Manager Cloud Control Console

Create a stop operation plan for BISystem2 by following these steps in the Enterprise Manager Cloud Control console:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISytem2 home page, from the Generic System menu, select Site Guard, then Operations.

  4. Click Create. The Create New Operation Plan screen is displayed.

  5. Enter stop-bisystem2 as the plan name.

  6. From the list, select Stop as the operation type.

  7. From the list of Standby System, select either BISystem2 as the standby system.

  8. Click Save.

35.10.5 Operation Plan to Switchover Operation on BISystem2

You can create an operation plan for a switchover operation on BISystem2, using one of the following methods:

Switchover Operation on BISystem2 Using EMCLI

Create a switchover operation plan by running the following emcli commands in the command-line interface:

emcli create_operation_plan
        -primary_system_name="BISystem1"
        -standby_system_name="BISystem2" 
        -operation="Switchover""
        -name="switchover-to-bisystem2"

See Appendix F, "create_operation_plan" for more information.

Switchover Operation on BISystem2 Using Enterprise Manager Cloud Control Console

Create a switchover operation plan for BISystem2 by following these steps in the Enterprise Manager Cloud Control console:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISytem2 home page, from the Generic System menu, select Site Guard, then Operations.

  4. Click Create. The Create New Operation Plan screen is displayed.

  5. Enter switchover-to-bisystem2 as the plan name.

  6. From the list, select Switchover as the operation type.

  7. The Primary System element on the page displays BISystem1 as the system for which this plan is created.

  8. From the list of Standby System, select either BISystem2 as the standby system.

  9. Click Save.

35.10.6 Operation Plan to Switchover Operation on BISystem1

You can create an operation plan for a switchover operation on BISystem1, using one of the following methods:

Switchover Operation on BISystem1 Using EMCLI

Create a switchover operation plan by running the following emcli commands in the command-line interface:

emcli create_operation_plan
        -primary_system_name="BISystem2"
        -standby_system_name="BISystem1" 
        -operation="Switchover""
        -name="switchover-to-bisystem1"

See Appendix F, "create_operation_plan" for more information.

Switchover Operation on BISystem1 Using Enterprise Manager Cloud Control Console

Create a switchover operation plan for BISystem2 by following these steps in the Enterprise Manager Cloud Control console:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem2.

  3. On the BISytem2 home page, from the Generic System menu, select Site Guard, then Operations.

  4. Click Create. The Create New Operation Plan screen is displayed.

  5. Enter switchover-to-bisystem1 as the plan name.

  6. From the list, select Switchover as the operation type.

  7. The Primary System element on the page displays BISystem2 as the system for which this plan is created.

  8. From the list of Standby System, select either BISystem1 as the standby system.

  9. Click Save.

35.10.7 Operation Plan for Failover Operation on BISystem2

You can create an operation for a failover operation on BISystem2, using one of the following methods:

Failover Operation on BISystem2 Using EMCLI

Create a failover operation plan by running the following emcli commands in the command-line interface:

emcli create_operation_plan
        -primary_system_name="BISystem1"
        -standby_system_name="BISystem2" 
        -operation="Failover"
        -name="Failover-to-bisystem2"

See Appendix F, "create_operation_plan" for more information.

Failover Operation on BISystem2 Using Enterprise Manager Cloud Control Console

Create a failover operation plan for BISystem2 by following these steps in the Enterprise Manager Cloud Control console:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISytem1 home page, from the Generic System menu, select Site Guard, then Operations.

  4. Click Create. The Create New Operation Plan screen is displayed.

  5. Enter Failover-to-bisystem2 as the plan name.

  6. From the list, select Failover as the operation type.

  7. The Primary System element on the page displays BISystem1 as the system for which this plan is created.

  8. From the list of Standby System, select either BISystem2 as the standby system.

  9. Click Save.

35.10.8 Operation Plan to Failover Operation on BISystem1

You can create an operation plan for a failover operation on BISystem1, using one of the following methods:

Failover Operation on BISystem1 Using EMCLI

Create a failover operation plan by running the following emcli commands in the command-line interface:

emcli create_operation_plan
        -primary_system_name="BISystem2"
        -standby_system_name="BISystem1" 
        -operation="Failover"
        -name="Failover-to-bisystem1"

See Appendix F, "create_operation_plan" for more information.

Failover Operation on BISystem1 Using Enterprise Manager Cloud Control Console

Create a failover operation plan for BISystem1 by following these steps in the Enterprise Manager Cloud Control console:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem2.

  3. On the BISytem2 home page, from the Generic System menu, select Site Guard, then Operations.

  4. Click Create. The Create New Operation Plan screen is displayed.

  5. Enter Failover-to-bisystem1 as the plan name.

  6. From the list, select Failover as the operation type.

  7. The Primary System element on the page displays BISystem2 as the system for which this plan is created.

  8. From the list of Standby System, select either BISystem1 as the standby system.

  9. Click Save.

35.10.9 Listing Operation Plan

To list all operation plans, run the following emcli commands in the command-line interface:

emcli get_operation_plan
        -name="plan_name"

Figure 35-5 shows an example of all operation plans for BISystem1 and BISystem2.

Figure 35-5 Operation Plans for BISystem1 and BISystem2

Description of Figure 35-5 follows
Description of "Figure 35-5 Operation Plans for BISystem1 and BISystem2"

35.10.10 Listing Operation Plan Detail

To obtain information about an operation plan, run the following emcli commands in the command-line interface:

emcli get_operation_plan_details
        -name="plan_name"

See Appendix F, "get_operation_plan_details" for more information.

To see the list of operation plan and the details of each plan submitted for execution:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click the name of the system for which you want to track operation plans that are submitted for execution.

  3. On the home page of the system, from the Generic System menu, select Site Guard, then Operations.

  4. Click Operation Activities. A table listing all of the submitted operation plan executions is displayed.

  5. To view the details about each plan, click on the specific plan in the list.

35.11 Task 11: Updating an Operation Plan

You can update the operation plans that you created in BISystem1 and BISystem2 using one of the following methods:

35.11.1 Update an Operation Plan Using EMCLI

To update and operation plan on either of the systems, you can use EMCLI commands.

For example, if you want to change the sequence of a switchover plan running on BISystem1, run the following command:

emcli update_operation_plan -name="switchover_to_BISystem1"
        -step_number="5"
        -move="Up"

35.11.2 Update an Operation Plan Using Enterprise Manager Cloud Control Console

For information about updating operation plans using Enterprise Manager Cloud Control console, see "Updating an Operation Plan".

35.12 Task 12: Starting BISystem1

You can start BISystem1 using one of the following methods:

Start BISystem1 Using EMCLI

Start BISystem1 by submitting the start-bisystem1 operation using emcli commands in the command-line interface:

emcli submit_operation_plan 
              -name="start-bisystem1" 

See Appendix F, "submit_operation_plan" for more information.

Figure 35-6 shows the start-bisystem1 operation status.

Start BISystem1 Using Enterprise Manager Cloud Control Console

Start BISystem1 by submitting the start-bisystem1 operation using the Enterprise Manager Cloud Control console. Follow these steps:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISystem1 home page, from the Generic System menu, select Site Guard, then Operations. The Site Guard Operations page is displayed.

  4. Select start-bisystem2 from the list of operation plans.

  5. Click Execute. The Confirmation page is displayed.

  6. Ensure that Run Prechecks is selected.

  7. Submit the plan for execution. The confirmation message is displayed.

  8. Click on the link on the confirmation page to track the progress of the operation.

35.13 Task 13: Stopping BISystem1

You can stop BISystem1 using one of the following methods:

Stop BISystem1 Using EMCLI

Stop BISystem1 by submitting the stop-bisystem1 operation using emcli commands in the command-line interface:

emcli submit_operation_plan 
              -name="stop-bisystem1" 

See Appendix F, "submit_operation_plan" for more information.

Figure 35-7 shows the stop-bisystem1 operation status.

Stop BISystem1 Using Enterprise Manager Cloud Control Console

Stop BISystem1 by submitting the stop-bisystem1 operation using the Enterprise Manager Cloud Control console. Follow these steps:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISystem1 home page, from the Generic System menu, select Site Guard, then Operations. The Site Guard Operations page is displayed.

  4. Select stop-bisystem2 from the list of operation plans.

  5. Click Execute. The Confirmation page is displayed.

  6. Ensure that Run PreChecks is selected.

  7. Submit the plan for execution. The confirmation message is displayed.

  8. Click on the link on the confirmation page to track the progress of the operation.

35.14 Task 14: Running the Oracle Site Guard Pre-Check Utility

Oracle Site Guard runs the pre-check utility after you submit the operation plan.

To run the pre-check utility for an operation plan, run the following emcli commands in the command-line interface:

emcli run_prechecks
       -operation_plan="name"

See Appendix F, "run_prechecks" for more information.

Figure 35-8 shows an example of a pre-check utility emcli command in the command-line interface.

Figure 35-8 Pre-Check Utility

Description of Figure 35-8 follows
Description of "Figure 35-8 Pre-Check Utility"

Run Oracle Site Guard precheck utility by using the Enterprise Manager Cloud Control console. Follow these steps:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click the name of the system on which you want to run the precheck utility.

  3. On the home page of the system, from the Generic System menu, select Site Guard, then Operations. The Site Guard Operations page is displayed.

  4. Select the plan from the Plan Name column

  5. Select Run Prechecks.

  6. Click OK to confirm.

35.15 Task 15: Performing Site Switchover

You must complete the following:

35.15.1 Switchover to BISystem1

You can switchover to BISystem1 using one of the following methods:

Switchover to BISystem1 Using EMCLI

To perform a site switchover to BISystem1, run the following emcli commands in the command-line interface:

emcli submit_operation_plan 
        -name="switchover-to-bisystem1" 

See Appendix F, "submit_operation_plan" for more information.

Figure 35-9 shows the switchover operation status.

Figure 35-9 Switchover Status for BISystem1

Description of Figure 35-9 follows
Description of "Figure 35-9 Switchover Status for BISystem1"

Switchover to BISystem1 Using Enterprise Manager Cloud Control Console

Switchover to BISystem1 by submitting the switchover-bisystem1 operation using the Enterprise Manager Cloud Control console. Follow these steps:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISystem1 home page, from the Generic System menu, select Site Guard, then Operations. The Site Guard Operations page is displayed.

  4. Select switchover-bisystem1 from the list of operation plans.

  5. Click Execute. The Confirmation page is displayed.

  6. Ensure that Run PreChecks is selected.

  7. Submit the plan for execution. The confirmation message is displayed.

  8. Click on the link on the confirmation page to track the progress of the operation.

35.15.2 Switchover to BISystem2

You can switchover to BISystem2 using one of the following methods:

Switchover to BISystem2 Using EMCLI

To perform a site switchover to BISystem2, run the following emcli commands in the command-line interface:

emcli submit_operation_plan 
        -name="switchover-to-bisystem2"

See Appendix F, "submit_operation_plan" for more information.

Figure 35-10 shows the switchover operation status.

Figure 35-10 Switchover Status for BISystem2

Description of Figure 35-10 follows
Description of "Figure 35-10 Switchover Status for BISystem2"

Switchover to BISystem2 Using Enterprise Manager Cloud Control Console

Switchover to BISystem2 by submitting the switchover-bisystem2 operation using the Enterprise Manager Cloud Control console. Follow these steps:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISystem1 home page, from the Generic System menu, select Site Guard, then Operations. The Site Guard Operations page is displayed.

  4. Select switchover-bisystem2 from the list of operation plans.

  5. Click Execute. The Confirmation page is displayed.

  6. Ensure that Run PreChecks is selected.

  7. Submit the plan for execution. The confirmation message is displayed.

  8. Click on the link on the confirmation page to track the progress of the operation.

After you perform switchover, the associations in the Site Guard configuration will be updated, as shown in Figure 35-11.

Figure 35-11 Updated Site Guard Status

Description of Figure 35-11 follows
Description of "Figure 35-11 Updated Site Guard Status"

35.16 Task 16: Performing Site Failover

To perform a site failover, complete the following steps:

35.16.1 Failover to BISystem1

Perform a site failover to BISystem1 using one of the following methods:

Failover to BISystem1 Using EMCLI

To perform a site failover to BISystem1, run the following emcli commands in the command-line interface:

emcli submit_operation_plan 
        -name="failover-to-bisystem1"

See Appendix F, "submit_operation_plan" for more information.

Figure 35-12 shows the failover operation status.

Figure 35-12 Failover Status for BISystem1

Description of Figure 35-12 follows
Description of "Figure 35-12 Failover Status for BISystem1"

Failover to BISystem1 Using Enterprise Manager Cloud Console Control

Failover to BISystem1 by submitting the failover-bisystem1 operation using the Enterprise Manager Cloud Control console. Follow these steps:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem1.

  3. On the BISystem1 home page, from the Generic System menu, select Site Guard, then Operations. The Site Guard Operations page is displayed.

  4. Select failover-bisystem1 from the list of operation plans.

  5. Click Execute. The Confirmation page is displayed.

  6. Ensure that Run PreChecks is selected.

  7. Submit the plan for execution. The confirmation message is displayed.

  8. Click on the link on the confirmation page to track the progress of the operation.

35.16.2 Failover to BISystem2

Perform a failover to BISystem2 using one of the following methods:

Failover to BISystem2 Using EMCLI

To perform a site failover to BISystem2, run the following emcli commands in the command-line interface:

emcli submit_operation_plan 
        -name="failover-to-bisystem2"

See Appendix F, "submit_operation_plan" for more information.

Figure 35-13 shows the failover operation status.

Figure 35-13 Failover Status for BISystem2

Description of Figure 35-13 follows
Description of "Figure 35-13 Failover Status for BISystem2"

Failover to BISystem2 Using Enterprise Manager Cloud Control Console

Failover to BISystem2 by submitting the failover-bisystem2 operation using the Enterprise Manager Cloud Control console. Follow these steps:

  1. From the Targets menu, click Systems.

  2. On the Systems page, click BISystem2.

  3. On the BISystem2 home page, from the Generic System menu, select Site Guard, then Operations. The Site Guard Operations page is displayed.

  4. Select failover-bisystem2 from the list of operation plans.

  5. Click Execute. The Confirmation page is displayed.

  6. Ensure that Run PreChecks is selected.

  7. Submit the plan for execution. The confirmation message is displayed.

  8. Click on the link on the confirmation page to track the progress of the operation.