Go to main content
1/12
Contents
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
1
Introduction to Oracle Site Guard
1.1
What is Oracle Site Guard
1.2
Benefits of Oracle Site Guard
1.3
What is New in This Release
2
Understanding Oracle Site Guard Concepts
2.1
Oracle Site Guard Terminology
2.2
Representation of a Site in Enterprise Manager Cloud Control Console
2.3
Oracle Site Guard Features
2.3.1
Extensibility
2.3.1.1
Types of Scripts for Extensibility
2.3.1.2
Sequence of Script Execution
2.3.1.3
Configuring Script Path
2.3.2
Prechecks and Health Checks
2.3.2.1
Prechecks
2.3.2.2
Health Checks
2.3.2.3
Customizing Prechecks and Health Checks
2.3.2.4
Lag Checks
2.3.3
Storage Integration
2.3.3.1
Oracle Sun ZFS
2.3.3.2
Integrating Other Storage Types
2.3.3.3
Mount and Unmount Scripts
2.3.4
Monitoring Executions and Managing Errors
2.3.4.1
Customizing Operations
2.3.4.2
Monitoring Executions
2.3.4.3
Operation Error Modes
2.3.4.4
Retrying Failed Operations
2.3.4.5
Suspending and Resuming Operations
2.3.5
Credential Management
2.3.5.1
Enterprise Manager Credential Framework
2.3.5.2
Oracle Site Guard Credential Configuration
2.3.6
Role-Based Access Control
2.3.7
Software Library Integration
2.3.8
Custom Credentials for Script Execution
2.3.9
Passing Credentials as Script Parameters
2.4
Oracle Site Guard Workflows
2.4.1
Switchover Workflow
2.4.2
Failover Workflow
2.4.3
Start Workflow
2.4.4
Stop Workflow
3
Installing Oracle Site Guard
3.1
Installing Oracle Site Guard
3.2
Prerequisites for Using Oracle Site Guard
3.2.1
Discovering Targets on the Primary Site and the Standby Site
3.2.2
Creating Oracle Site Guard Administrator Users
3.2.2.1
Creating a Oracle Site Guard Administrator User Using Enterprise Manager Cloud Control Console
3.2.2.2
Creating a Oracle Site Guard Administrator User Using Enterprise Manager Command-Line Interface
3.2.3
Creating Primary and Standby Sites
3.2.3.1
Creating a Generic System Using Enterprise Manager Cloud Control Console
3.2.3.2
Creating a Generic System Using EMCLI Commands
3.2.4
Creating Credentials
3.2.4.1
Creating Named Credentials
3.2.4.2
Creating Preferred Credential
3.2.5
Granting Credential Privileges to Oracle Site Guard Administrator Users
3.2.5.1
Granting Credential Privileges Using Enterprise Manager Cloud Control Console
3.2.6
Configuring Software Library Storage Location
3.2.6.1
Configuring Software Library Storage Location Using Enterprise Manager Cloud Control Console
3.2.6.2
Configuring Software Library Storage Location Using Enterprise Manager Command-Line Interface
3.2.7
Verifying Database and Data Guard Configurations
4
Configuring Oracle Site Guard
4.1
Overview
4.2
Configuring Sites
4.2.1
Configuring Sites Using Enterprise Manager Cloud Control Console
4.2.2
Configuring Sites Using EMCLI Commands
4.3
Creating Credential Associations
4.3.1
Creating Named or Preferred Credential Associations
4.3.1.1
Creating Named or Preferred Credential Associations Using Enterprise Manager Cloud Control Console
4.3.1.2
Creating Named or Preferred Credential Associations Using EMCLI Commands
4.4
Configuring Scripts
4.4.1
Configuring Custom Precheck Scripts, Pre Scripts, Post Scripts, Global Pre Scripts, and Global Post Scripts
4.4.1.1
Configuring Custom Precheck Scripts, Pre Scripts, Post Scripts, Global Pre Scripts, and Global Post Scripts Using Enterprise Manager Cloud Control Console
4.4.1.2
Configuring Custom Precheck Scripts, Pre Scripts, Post Scripts, Global Pre Scripts, and Global Post Scripts Using EMCLI Commands
4.4.2
Configuring Mount and Unmount Scripts
4.4.2.1
mount_umount.sh
4.4.3
Configuring Storage Scripts
4.4.3.1
zfs_storage_role_reversal.sh
4.4.3.2
Configuring Storage Scripts Using Enterprise Manager Cloud Control Console
4.4.3.3
Configuring Storage Scripts Using Enterprise Manager Command-Line Interface
4.4.4
Configuring Credentials as Parameters for Scripts
4.4.4.1
Adding Credential Parameters to a Script
4.4.4.2
Deleting Credential Parameters from a Script
4.4.4.3
Getting Credential Parameters for a Script
4.4.5
Cloning a Script Using Existing Scripts
4.5
Configuring Auxiliary Hosts
4.5.1
Adding an Auxiliary Host Using EMCLI Commands
4.5.2
Deleting an Auxiliary Host Using EMCLI Commands
4.5.3
Listing Auxiliary Targets Using EMCLI Commands
4.6
Configuring Database Lag Checks
4.6.1
Configuring Database Lag Checks Using EMCLI Commands
4.6.2
Updating Threshold Value for Database Lag Using EMCLI Commands
4.6.3
Deleting Threshold Value for Database Lag Using EMCLI Commands
4.6.4
Listing Database Lag Thresholds Using EMCLI Commands
5
Troubleshooting Oracle Site Guard
5.1
Operation Plan Failure
5.1.1
Targets Not Discovered in Operation Plan Workflow
5.1.2
Oracle WebLogic Server Managed-Server Target Not Identified
5.1.3
Manual Intervention Needed for Hung Operation Step
5.1.4
OPMN Managed System Components Not Discovered In Operation-Plan Workflow
5.1.5
Oracle RAC Database Not Discovered in Operation-Plan Workflow
5.1.6
Failure of Operation Step When Accessed with Sudo Privileges
5.1.7
Error While Creating Operation Plan Indicating Credential Association Not Configured
5.1.8
Inability to Associate Credentials for Targets Added to a Site
5.1.9
Error While Deleting Or Updating Operation Plans
5.1.10
Error Indicating Inability to Create Scalar Value While Creating Operation Plan
5.1.11
Error While Creating Operation Plan Indicating Missing Node Manager Credentials
5.2
Switchover or Failover Operations Failure
5.2.1
WebLogic Administration Server Does Not Start After Performing Switchover or Failover Operation
5.2.2
WebLogic Administration Server Fails to Restart After Performing Switchover or Failover Operations
5.2.3
Host Not Available During Switchover or Failover Operations
5.2.4
Switchover or Failover Operations Fail When Oracle RAC Database Instances Are Not Available
5.3
Precheck Failure
5.3.1
Failure of Prechecks
5.3.2
Prechecks Hang When Oracle Management Agent Is Not Available
5.4
Oracle WebLogic Server Failure
5.4.1
Node Manager Fails to Restart
5.4.2
Managed Server Fails to Start
5.4.3
Oracle Site Guard Does Not Include Oracle WebLogic Server Instances That Are Migrated to a Different Host
5.4.4
Error Displayed While Creating Operation Plan
5.4.5
WebLogic Administration Server Able to Communicate With Node Manager When Site Guard Cannot
5.4.6
Unable to Associate More Than One Node Manager Per Host
5.5
Database Failure
5.5.1
Prechecks for Database Switchover and Database Failover Operations Fail
5.5.2
Databases Protected by Data Guard Included in the Incorrect Operation-Plan Category
5.6
Storage Failures
5.6.1
Attempt to Log In to ZFS Storage Appliance Might Fail During Execution of Operation Plan
5.6.2
Storage Role Reversal Operation Might Fail During Execution of Operation Plan While Deleting Empty Project on Target Appliance
5.6.3
Storage Role Reversal Operation Might Fail During Execution of Operation Plan While Executing 'confirm reverse'
6
Performing Oracle Site Guard Operations
6.1
Overview
6.2
Managing Operation Plans
6.2.1
Creating Operation Plans
6.2.1.1
Creating an Operation Plan Using Enterprise Manager Cloud Control Console
6.2.1.2
Creating an Operation Plan Using EMCLI Commands
6.2.2
Creating New Operation Plans Using Existing Plans
6.2.3
Editing and Updating Operation Plans
6.2.3.1
Editing and Updating Operation Plans Using Enterprise Manager Cloud Control Console
6.2.3.2
Editing and Updating Operation Plans Using EMCLI Command
6.2.4
Deleting an Operation Plan
6.2.4.1
Deleting an Operation Plan Using Enterprise Manager Cloud Control Console
6.2.4.2
Deleting an Operation Plan Using Command-Line Interface
6.3
Running Prechecks
6.3.1
Running Precheck Utility Using Enterprise Manager Cloud Control Console
6.3.2
Running Precheck Utility Using Command-Line Interface
6.4
Scheduling Health Checks
6.4.1
Scheduling a Health Check Using Enterprise Manager Cloud Control Console
6.4.2
Scheduling a Health Check Using EMCLI
6.5
Executing Oracle Site Guard Operation Plans
6.5.1
Executing Oracle Site Guard Operation Plan Using Enterprise Manager Cloud Control Console
6.5.2
Executing Oracle Site Guard Operation Plan Using EMCLI Command
6.6
Monitoring Oracle Site Guard Operations
6.6.1
Monitoring an Operation Plan Using Enterprise Manager Cloud Control Console
6.6.1.1
Viewing an Operation Activity
6.6.1.2
Suspending, Resuming, or Stopping an Operation
6.6.2
Monitoring an Operation Plan Using EMCLI
6.7
Managing Execution Errors
6.8
Manually Reversing Site Roles
6.8.1
Manually Reversing Site Roles Using Enterprise Manager Cloud Control Console
6.8.2
Manually Reversing Site Roles Using EMCLI
7
Oracle Site Guard Command-Line Interface
7.1
add_siteguard_aux_hosts
7.2
add_siteguard_script_credential_params
7.3
add_siteguard_script_hosts
7.4
configure_siteguard_lag
7.5
create_operation_plan
7.6
create_siteguard_configuration
7.7
create_siteguard_credential_association
7.8
create_siteguard_script
7.9
delete_operation_plan
7.10
delete_siteguard_aux_host
7.11
delete_siteguard_configuration
7.12
delete_siteguard_credential_association
7.13
delete_siteguard_lag
7.14
delete_siteguard_script
7.15
delete_siteguard_script_credential_params
7.16
delete_siteguard_script_hosts
7.17
get_operation_plan_details
7.18
get_operation_plans
7.19
get_siteguard_aux_hosts
7.20
get_siteguard_configuration
7.21
get_siteguard_credential_association
7.22
get_siteguard_health_checks
7.23
get_siteguard_lag
7.24
get_siteguard_script_credential_params
7.25
get_siteguard_script_hosts
7.26
get_siteguard_scripts
7.27
get_siteguard_supported_targets
7.28
run_prechecks
7.29
schedule_siteguard_health_checks
7.30
stop_siteguard_health_checks
7.31
submit_operation_plan
7.32
update_operation_plan
7.33
update_siteguard_configuration
7.34
update_siteguard_credential_association
7.35
update_siteguard_lag
7.36
update_siteguard_script
8
Upgrading or Downgrading Oracle Site Guard
8.1
Upgrading Oracle Site Guard
8.2
Downgrading Oracle Site Guard
A
Extracting Credentials Passed as Parameters (Examples)
extract_credentials_sample_script.sh
extract_credentials_sample_script.py
extract_credentials_sample_script.pl
Scripting on this page enhances content navigation, but does not change the content in any way.