dg_configure_observers

このVerbを適用できるのはデータベース・バージョン12.2以上のみです。このVerbで使用できるサブコマンドが複数あります。

dg_configure_observers -start

指定したプライマリ・データベースに関連付けられているData Guard構成の指定したホストおよびOracleホームで、1つ以上のファスト・スタート・フェイルオーバー・オブザーバを起動します。

書式

emcli dg_configure_observers -start
		-primary_target_name="<primary target name>"
		-primary_target_type="oracle_database|rac_database"
		-observer_input_file="<full pathname of input file>"
		[-primary_db_creds_name="<primary database credential name>"]
		[-primary_host_creds_name="<primary database host credential name>"]

[ ]  indicates that the parameter is optional.

オプション

  • primary_target_name

    プライマリ・データベースのEnterprise Managerターゲット名。単一インスタンス・データベースまたはクラスタ・データベースのいずれも可能です。

  • primary_target_type

    プライマリ・データベースのターゲット・タイプ。指定できる値は次のとおりです:
    • oracle_database: 単一インスタンス・データベース

    • rac_database: クラスタ・データベース

  • observer_input_file

    各オブザーバを起動するための情報を含むファイルの名前。このファイルの形式は次のとおりです。
    *observer.<i>.observer_name=<#<i>observer name>
    *observer.<i>.observer_host=<Host name where #<i> observer will be started.>
    *observer.<i>.observer_orale_home=<Oracle home location on the host where #<i> observer will be started.>
    *observer.<i>.observer_host_cred_name=<host named credential for user who can access the #<i> observer Oracle home>
    *observer.<i>.observer_host_wallet_cred_name=<named credential of the Oracle wallet configured in the #<i> observer Oracle home>
    observer.<i>.is_Master=<Y||N>
    observer.<i>.observer_runtime_data_file=<Runtime data file path and name for the #<i> observer. If not specified, the file fsfo.dat will be created under the oracle base.>
    observer.<i>.observer_log_file=<The full path of the #<i> observer log file.>
    
    
    Where
    <i>:(0,1,2)
    (*)- Mandatory parameters.
  • primary_db_creds_name

    SYSDBAまたはSYSDGロールを持つユーザーのプライマリ・データベースの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

  • primary_host_creds_name

    プライマリ・データベースのOracleホームにアクセスできるオペレーティング・システム・ユーザーのプライマリ・データベース・ホストの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

例1

次の例では、プライマリ・データベース'database'に関連付けられたData Guard構成のオブザーバ'oemcli1'および'oemcli2'を起動します。これにより、Enterprise Managerの代替オブザーバと、プライマリ・データベース'database'に関連付けられたData Guard構成の関連する修正処理ジョブも削除されます。

emcli dg_configure_observers
	-start -delete_alternate_observer
	-primary_target_name=database
	-primary_target_type=oracle_database
	-primary_db_creds_name=DB_CRED
	-primary_host_creds_name=HOST_CRED
	-observer_input_file=/scratch/startObs.props

例2

次の例では、プライマリ・データベース'database'に関連付けられたData Guard構成の、observer_input_fileの'/scratch/startObs.props'で提供されているオブザーバを起動します。

emcli dg_configure_observers
	-start -primary_target_name=database
	-primary_target_type=oracle_database
	-primary_db_creds_name=DB_CRED
	-primary_host_creds_name=HOST_CRED
	-observer_input_file=/scratch/startObs.props

Following is the content of /scratch/startObs.props:
observer.0.observer_name=oemcli1
observer.0.observer_host=host1.us.oracle.com
observer.0.observer_oracle_home=/scratch/oracle_base1/product/12.2.0/dbhome_1
observer.0.observer_host_cred_name=HOST1_CRED
observer.0.observer_host_wallet_cred_name=WC2
observer.0.observer_runtime_data_file=/scratch/oracle_base1/oemcli1/obs_omemcli1_122.dat
observer.0.observer_log_file=/scratch/oracle_base1/oemcli1/oemcli1_122.log
observer.0.is_Master=Y
observer.1.observer_name=oemcli2
observer.1.observer_host=host2.us.oracle.com
observer.1.observer_oracle_home=/scratch/oracle_base1/product/12.2.0/dbhome_1
observer.1.observer_host_cred_name=HOST2_CRED
observer.1.observer_host_wallet_cred_name=WC2
observer_host_wallet_cred_name資格証明を作成するには、次に示すようにcreate_named_credential Verbを使用します。
emcli create_named_credential
	-cred_name=WC2 -cred_type=GenericPassword
	-auth_target_type='<system>'
	-attributes="GENERIC_PASSWORD:<Oracle Wallet Password>"

dg_configure_observers -stop

指定したプライマリ・データベースに関連付けられているData Guard構成に対応するオブザーバを停止します。

書式

emcli dg_configure_observers -stop
	-primary_target_name="<primary target name>"
	-primary_target_type="oracle_database|rac_database"
	[-observer_input_file="<full pathname of input file>"]
	[-stop_all]
	[-primary_db_creds_name="<primary database credential name>"]
	[-primary_host_creds_name="<primary database host credential name>"]

[ ]  indicates that the parameter is optional.
オプション
  • primary_target_name

    プライマリ・データベースのEnterprise Managerターゲット名。単一インスタンス・データベースまたはクラスタ・データベースのいずれも可能です。

  • primary_target_type

    プライマリ・データベースのターゲット・タイプ。指定できる値は次のとおりです:
    • oracle_database: 単一インスタンス・データベース

    • rac_database: クラスタ・データベース

  • observer_input_file

    各オブザーバを停止するための情報を含むファイルの名前。このファイルの形式は次のとおりです。
    	observer.0.observer_name=<#1 observer name>
    	observer.1.observer_name=<#2 observer name>
    	observer.2.observer_name=<#3 observer name>
  • stop_all

    すべてのオブザーバを停止します。このオプションは、-observer_input_fileと一緒には使用できません。

  • primary_db_creds_name

    SYSDBAまたはSYSDGロールを持つユーザーのプライマリ・データベースの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

  • primary_host_creds_name

    プライマリ・データベースのOracleホームにアクセスできるオペレーティング・システム・ユーザーのプライマリ・データベース・ホストの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

例1

次の例では、プライマリ・データベース'database'に関連付けられたData Guard構成のオブザーバ'oemcli1'、'oemcli2'および'oemcli3'を停止します。
emcli dg_configure_observers
	-stop -primary_target_name=database
	-primary_target_type=oracle_database
	-primary_db_creds_name=DB_CRED
	-primary_host_creds_name=HOST_CRED
	-observer_input_file=/scratch/stopObs.props

The following is the content of /scratch/stopObs.props:
observer.0.observer_name=oemcli1
observer.1.observer_name=oemcli2
observer.2.observer_name=oemcli3

例2

次の例では、プライマリ単一インスタンス・データベース'database'に関連付けられたData Guard構成のすべてのオブザーバを停止します。
emcli dg_configure_observers
	-stop -primary_target_name=database
	-primary_target_type=oracle_database
	-primary_db_creds_name=DB_CRED
	primary_host_creds_name=HOST_CRED -stop_all

dg_configure_observers -setMaster

指定したプライマリ・データベースに関連付けられているData Guard構成のマスター・オブザーバを構成します。

書式
emcli dg_configure_observers -setMaster
	-primary_target_name="<primary target name>"
	-primary_target_type="oracle_database|rac_database"
	-master_observer_name=<name of the master observer>
	[-primary_db_creds_name="<primary database credential name>"]
	[-primary_host_creds_name="<primary database host credential name>"]

オプション

  • primary_target_name

    プライマリ・データベースのEnterprise Managerターゲット名。単一インスタンス・データベースまたはクラスタ・データベースのいずれも可能です。

  • primary_target_type

    プライマリ・データベースのターゲット・タイプ。指定できる値は次のとおりです:
    • oracle_database: 単一インスタンス・データベース

    • rac_database: クラスタ・データベース

  • master_observer_name

    現在実行中のオブザーバの名前で、マスター・オブザーバとして構成する必要があります。

  • primary_db_creds_name

    SYSDBAまたはSYSDGロールを持つユーザーのプライマリ・データベースの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

  • primary_host_creds_name

    プライマリ・データベースのOracleホームにアクセスできるオペレーティング・システム・ユーザーのプライマリ・データベース・ホストの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

次の例では、プライマリ単一インスタンス・データベース'database'に関連付けられたData Guard構成のマスター・オブザーバとしてオブザーバ'oemcli2'を設定します。

emcli dg_configure_observers
	-setMaster -primary_target_name=database
	-primary_target_type=oracle_database
	-primary_db_creds_name=DB_CRED
	-primary_host_creds_name=HOST_CRED
	-master_observer_name=oemcli2

dg_configure_observers -show

指定したプライマリ・データベースに関連付けられているData Guard構成用に構成されているオブザーバのリストを表示します。

書式
emcli dg_configure_observers -show
	-primary_target_name="<primary target name>"
	-primary_target_type="oracle_database|rac_database"
	[-primary_db_creds_name="<primary database credential name>"]
	[-primary_host_creds_name="<primary database host credential name>"]

オプション

  • primary_target_name

    プライマリ・データベースのEnterprise Managerターゲット名。単一インスタンス・データベースまたはクラスタ・データベースのいずれも可能です。

  • primary_target_type

    プライマリ・データベースのターゲット・タイプ。指定できる値は次のとおりです:
    • oracle_database: 単一インスタンス・データベース

    • rac_database: クラスタ・データベース

  • primary_db_creds_name

    SYSDBAまたはSYSDGロールを持つユーザーのプライマリ・データベースの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

  • primary_host_creds_name

    プライマリ・データベースのOracleホームにアクセスできるオペレーティング・システム・ユーザーのプライマリ・データベース・ホストの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

次の例では、プライマリ単一インスタンス・データベース'database'に関連付けられたData Guard構成のすべてのオブザーバをリストします。

emcli dg_configure_observers -show	 
	-primary_target_name=database
	-primary_target_type=oracle_database
	-primary_db_creds_name=DB_CRED
	-primary_host_creds_name=HOST_CRED

dg_configure_observers -delete_alternate_observer

Enterprise Managerの代替オブザーバおよび関連する修正処理ジョブを削除します。Enterprise Managerの代替オブザーバ機能は、データベース・バージョン12.2以上ではサポートされていません。

書式
emcli dg_configure_observers -delete_alternate_observer
	-primary_target_name="<primary target name>"
	-primary_target_type="oracle_database|rac_database"
	[-primary_db_creds_name="<primary database credential name>"]
	[-primary_host_creds_name="<primary database host credential name>"]

オプション

  • primary_target_name

    プライマリ・データベースのEnterprise Managerターゲット名。単一インスタンス・データベースまたはクラスタ・データベースのいずれも可能です。

  • primary_target_type

    プライマリ・データベースのターゲット・タイプ。指定できる値は次のとおりです:
    • oracle_database: 単一インスタンス・データベース

    • rac_database: クラスタ・データベース

  • primary_db_creds_name

    SYSDBAまたはSYSDGロールを持つユーザーのプライマリ・データベースの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

  • primary_host_creds_name

    プライマリ・データベースのOracleホームにアクセスできるオペレーティング・システム・ユーザーのプライマリ・データベース・ホストの名前付き資格証明。優先資格証明はデフォルト値として使用されます。

次の例では、Enterprise Managerの代替オブザーバと、プライマリ単一インスタンス・データベース'database'に関連付けられたData Guard構成の関連する修正処理ジョブが削除されます。

emcli dg_configure_observers
	-delete_alternate_observer
	-primary_target_name=database
	-primary_target_type=oracle_database
	-primary_db_creds_name=DB_CRED
	-primary_host_creds_name=HOST_CRED