7 Oracle Site Guardコマンドライン・インタフェース
注意:
EMCLIコマンドでは大/小文字が区別されます。EMCLIの詳細は、『Oracle Enterprise Managerコマンドライン・インタフェース』を参照してください。
この章では、次のEMCLIコマンドを取り上げます。
add_operation_plan_tags
タグを使用して、サイト間での操作計画をグループ化および検索できます。
操作計画にタグを追加するEMCLIコマンド。
形式
emcli add_operation_plan_tags -plan_name="Name of the operation plan" -tags="names of the tags separated by ;"
パラメータ | 説明 |
---|---|
|
操作計画の名前 |
|
操作計画に追加するタグのセミコロン区切りリスト。カンマ(,)は無効な文字です。 |
emcli add_operation_plan_tags -plan_name="austin-switchover-plan" -tags="rack1_austin;created_by_john" emcli add_operation_plan_tags -plan_name="austin-switchover-plan" -tags="created_by_john"
関連項目:
add_site_properties
ユーザー定義のプロパティをサイトに追加します。各プロパティは、サイトに関連付けられている名前と値で構成されます。サイト・プロパティを介して、共通の属性を共有するサイトをグループ化して検索できます。
形式
emcli add_site_properties -system_name="Name of the system (site)" -properties="property name=value pairs separated by ;"
パラメータ | 説明 |
---|---|
|
汎用システム(サイト)の名前。 |
|
サイトに追加されるproperty name=valueのペアのセミコロン(;)で区切られたリスト。 |
例
emcli add_site_properties -system_name="austin-system" -properties="customer=acme corp; data center=austin dc"
emcli add_site_properties -system_name="utah-system" -properties="rack=08-57wvx"
注意:
サイト・プロパティの名前と値のペアは、大/小文字が区別されません。名前と値はそれぞれ、最長256文字に制限されます。add_siteguard_aux_hosts
補助ホストとは、システムには属していないもののOracle Enterprise Manager Cloud Controlで管理されるホストです。
形式
add_siteguard_aux_hosts
-system_name="sytem name"
-host_name="host name"
パラメータ | 説明 |
---|---|
-system_name |
システムの名前。 |
-host_name |
ホストの名前。 |
emcli add_siteguard_aux_hosts
-system_name="sample-system"
-host_name="host1.example.com"
emcli add_siteguard_aux_hosts
-system_name="austin-system"
-host_name="host2.example.com"
-host_name="host3.example.com"
関連項目:
add_siteguard_script_credential_params
スクリプトに渡される資格証明のユーザー名とパスワードに、スクリプト内からアクセスできます。
このEMCLIコマンドは、Oracle Site Guardスクリプトに名前付き資格証明パラメータを追加します。次の例を参照してください。
emcli add_siteguard_script_credential_params
-script_id="id_associated_with_the_script"
-credential_name="name_of_the_credential"
-credential_owner="credential_owner"
注意:
-credential_owner
パラメータは、オプションまたは条件付きのオプションです。
パラメータ | 説明 |
---|---|
-script_id |
スクリプトID。 |
-credential_name |
資格証明の名前。 |
-credential_owner |
資格証明の所有者の詳細。資格証明の所有者がログインしているユーザーと同じである場合、このパラメータの値は不要です。 |
emcli add_siteguard_script_credential_params
-script_id="1"
-credential_name="NAMED_CREDENTIAL_X"
emcli add_siteguard_script_credential_params
-script_id="2"
-credential_name="NAMED_CREDENTIAL_Y"
-credential_owner="SG_ADMIN"
add_siteguard_script_hosts
1つ以上のホストをOracle Site Guard構成スクリプトに追加します。
emcli add_siteguard_script_hosts
-script_id="script_id"
-host_name="host_name"
パラメータ | 説明 |
---|---|
-script_id |
スクリプトに関連付けられているID。 |
-host_name |
スクリプトに関連付けるホスト。複数のホスト名を指定できます。 |
emcli add_siteguard_script_hosts
-script_id="10"
-host_name ="host1.example.com"
関連項目:
configure_siteguard_lag
Oracle Site Guardシステムでのデータベースのラグ制限を構成します。
システム内の1つまたはすべてのデータベースに適用ラグおよびトランスポート・ラグを構成するEMCLIコマンド。
形式
emcli configure_siteguard_lag -system_name="system_name" -property_name="apply_lag or transport_lag" -value="maximum_lag_limit_in_seconds" [-target_name="database_target_name"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
しきい値の制限を構成するシステム。 |
|
プロパティ名。有効な値は、 |
|
構成するしきい値(秒単位)。 |
|
しきい値の制限を構成するデータベース・ターゲット名。このパラメータが指定されない場合、しきい値はシステムのすべてのデータベースに適用されます。 |
emcli configure_siteguard_lag -system_name="example-system" -property_name="apply_lag" -value="1000" emcli configure_siteguard_lag -system_name="example-system" -target_name="OID_db" -property_name="transport_lag" -value="2500"
関連項目:
get_siteguard_lag、update_siteguard_lagおよびdelete_siteguard_lagコマンド。
create_operation_plan
Oracle Site Guard操作計画を作成します。
新規操作計画を作成するEMCLIコマンド。
形式
emcli create_operation_plan -system_name="name_of_the_system" [-primary_system_name="name_of_primary_system"] [-standby_system_name="name_of_standby_system"] [-operation="name_of_the_operation"] [-plan_name="name_of_the_operation_plan"] [-like="name_of_the_operation_plan_from_which_the_steps_are_to_be_copied"] [-tags=list of tags separated by ; ]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
システムの名前。このオプションは、起動または停止の操作に対して使用されます。 |
|
プライマリ・サイトに関連付けられるシステムの名前。このオプションは、スイッチオーバーまたはフェイルオーバーの操作に対して使用されます。 |
|
スタンバイ・サイトに関連付けられるシステムの名前。このオプションは、スイッチオーバーまたはフェイルオーバーの操作に対して使用されます。 |
|
操作の機能。例: |
|
操作計画の名前。 |
|
ステップをコピーする操作計画の名前。このオプションを指定すると、システム名、操作およびロールが無視されます。 |
|
操作計画から削除するタグのセミコロン区切りリスト。カンマ(,)は無効な文字です。 |
emcli create_operation_plan -primary_system_name="austin" -standby_system_name="austin2" -operation="switchover" -name="austin-switchover-plan" emcli create_operation_plan -system_name="austin" -operation="start" -name="austin-start-plan" -role="Primary" emcli create_operation_plan -like="austin-start-plan" -name="austin-start-plan-copy"
関連項目:
create_siteguard_configuration
Oracle Site Guard構成を作成します。
新規サイト・ガード構成を作成するEMCLIコマンド。
形式
emcli create_siteguard_configuration -primary_system_name="name_of_primary_system" [-standby_system_name="name_of_standby_system"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
プライマリ・サイト・システムの名前。 |
|
スタンバイ・システムの名前。複数指定できます。 |
emcli create_siteguard_configuration -primary_system_name="example1" emcli create_siteguard_configuration -primary_system_name="example1" -standby_system_name="example2"
create_siteguard_credential_association
資格証明をサイト内のターゲットに関連付けます。
資格証明をサイト・ターゲットに関連付けるEMCLIコマンド。
形式
emcli create_siteguard_credential_association -system_name="name_of_the_system" -credential_type="type_of_credential" -credential_owner="credential_owner" [-target_name="name_of_the_target"] [-credential_name="name_of_the_credential"] [–use_preferred_credential="flag_to_use_preferred_credential"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
システムの名前。 |
|
資格証明のタイプ。 |
|
資格証明の所有者。資格証明の所有者がログインしているユーザーと同じである場合、この引数を指定する必要はありません(オプション)。 |
|
ターゲットの名前(オプション)。 |
|
資格証明の名前(オプション)。 |
|
名前付き資格証明のかわりに優先資格証明を使用するためのフラグ(オプション)。 |
emcli create_siteguard_credential_association -system_name="austin-system" -credential_type="HostNormal" -credential_name="HOST-SGCRED" -credential_owner="sysman" emcli create_siteguard_credential_association -system_name="utah-system" -credential_type="HostPrivileged" -use_preferred_credential -credential_owner="sysman" emcli create_siteguard_credential_association -system_name="austin-system" -target_name="austin-database-instance1;austin-database-instance2" -credential_type="DatabaseSysdba" -credential_name="HOST-DBCRED" -credential_owner="sysman"
create_siteguard_script
Oracle Site Guard構成用の前処理スクリプト、後処理スクリプトおよびストレージ・スクリプトを作成します。
構成用のスクリプトを作成するEMCLIコマンド。次の形式ガイドを参照してください。
emcli create_siteguard_script
-system_name="name_of_the_system"
-operation="name_of_the_operation"
-script_type="type_of_the_script"
-path="path_of_the_script"
-role="role_associated_with_the_system"
-host_name="name_of_the_host_where_the_scripts_are_run" <optional>
-component="path_of_the_entity_in_software_library" <optional>
-runtime_script="if_prechecks_to_check_availability_of_this_script" <optional>
-run_on="flag_specifying_the_host" <optional>
-all_hosts="flag_to_run_script_on_all_the_hosts_in_the_system" <optional>
-credential_type="type_of_the_credential" <optional>
-credential_name="name_of_the_credential" <optional>
-credential_owner="credential_owner"
パラメータ | 説明 |
---|---|
-system_name |
システムの名前。 |
-operation |
操作の名前。次の操作名のいずれかです。
|
-script_type |
スクリプトのタイプ。Mount 、UnMount 、Global-Pre-Script 、Global-Post-Script 、Pre Script 、Post-Script 、Storage-Failover またはStorage-Switchover を指定できます。
|
-path |
スクリプトへのパス。 |
-role |
システム・ロールに基づいてスクリプトを構成するためのフラグ。デフォルトでは、スクリプトは、特定のシステムのプライマリ・ロールおよびスタンバイ・ロールの両方に対して構成されます。例: Primary またはStandby 。
|
-host_name |
このスクリプトが実行されるホストの名前。複数指定できます。 |
-component |
ソフトウェア・ライブラリのエンティティへのパス。コンポーネントが指定されている場合、パスに含められるのはファイル名とそのパラメータのみです。 |
-runtime_script |
値はtrue またはfalse です。スクリプトがランタイム・スクリプトとして指定される場合、事前チェックはスクリプトの有無を確認しません。スクリプトが動的にマウントされるか、操作計画の実行の一部として生成される場合、このパラメータが使用されます。
デフォルトでは、ソフトウェア・ライブラリからステージングされたすべてのスクリプトがランタイム・スクリプトとして指定されます。ソフトウェア・ライブラリからステージングされないスクリプトのデフォルト値は、 |
-run_on |
使用可能なホストの1つのみでスクリプトを実行する(any と入力)か、すべてのホストで実行する(all と入力)か。デフォルト値はallです。
|
-all_hosts |
システム内のすべてのホストでスクリプトを実行できるようにするためのフラグ。このパラメータは、host_name を無視します。true またはfalse を入力します。
|
–credential_type |
HostNormal またはHostPrivileged (root 権限がある場合)を指定します。
|
-credential_name |
このスクリプトを実行するために使用される資格証明の名前。
パラメータ |
-credential_owner |
資格証明の所有者。target_storage_credential_name およびsource_storage_credential_name を指定した場合は、属性credential_owner を指定する必要があります。
|
emcli create_siteguard_script
-system_name="sample-system"
-operation="Switchover"
-script_type="Precheck-Script"
-role="Primary"
-credential_type="HostNormal"
-path="/tmp/precheckscript"
-all_hosts="true"
emcli create_siteguard_script
-system_name="sample-system"
-operation="Failover"
-script_type="Post-Script"
-role="Standby"
-credential_name="MY_NAMED_HOST_CREDENTIAL"
-path="/tmp/postscript"
-host_name="host1.example.com"
-host_name="host2.example.com"
-run_on="any"
-runtime_script="true"
emcli create_siteguard_script
-system_name="sample-system"
-operation="Switchover"
-script_type="Pre-Script"
-credential_type="HostNormal"
-path="stop_mycomponent.sh"
-component="/Components/MyScripts/LCM_Operations"
-all_hosts="true"
-role="Primary"
emcli create_siteguard_script
-system_name="sample-system"
-operation="Switchover"
-script_type="Global-Pre-Script"
-credential_type="HostNormal"
-path="/tmp/prescript"
-all_hosts="true"
-target_storage_credential_name="SGCRED-TARGET-STORAGE"
-source_storage_credential_name="SGCRED-SOURCE-STORAGE"
-credential_owner="sysman"
delete_operation_plan
Oracle Site Guard操作計画を削除します。
操作計画を削除するEMCLIコマンド。
形式
emcli delete_operation_plan -plan_name="name_of_operation_plan"
パラメータ | 説明 |
---|---|
|
削除対象の操作計画。 |
emcli delete_operation_plan -plan_name="austin-switchover"
関連項目:
delete_operation_plan_tags
Oracle Site Guard操作計画内のタグを削除します。
操作計画内のタグを削除するEMCLIコマンド。
形式
emcli delete_operation_plan_tags -plan_name="Name of the operation plan" [-tags="names of the tags separated by ;"] [-all="names of the tags separated by ;"]
パラメータ | 説明 |
---|---|
|
操作計画の名前。 |
|
操作計画から削除するタグのセミコロン区切りリスト。カンマ(,)は無効な文字です。 |
|
操作計画のすべてのタグが削除されます。この値は、 |
emcli delete_operation_plan_tags -plan_name="austin-switchover-plan" -tags="rack1_austin;created_by_john" emcli delete_operation_plan_tags -plan_name="austin-switchover-plan" -all
delete_site_properties
ユーザー定義のプロパティをサイトから削除します。削除される固有のプロパティは、すでにサイトに関連付けられている必要があります。
形式
emcli delete_site_properties -system_name="Name of the system (site)" -properties="property names list separated by ;" -all
パラメータ | 説明 |
---|---|
|
汎用システム(サイト)の名前。 |
|
サイトから削除するプロパティ名のセミコロン(;)で区切られたリスト。 |
|
このオプションが指定されている場合、サイトに割り当てられているすべてのプロパティが削除されます。このオプションは、「-properties」オプションを使用して行われた選択をオーバーライドします。 |
例
emcli delete_site_properties -system_name="austin-system" -properties="customer; data center"
emcli delete_site_properties -system_name="utah-system" -properties="rack"
emcli delete_site_properties -system_name="austin-system" -all
delete_siteguard_aux_host
Oracle Site Guardシステムに関連付けられている補助ホストを削除します。
delete_siteguard_aux_host
-system_name="system_name"
-host_name="name_of_the_host" <Optional>
パラメータ | 説明 |
---|---|
-system_name |
操作を実行しているシステム。 |
-host_name |
削除する補助ホストの名前。指定しない場合、システムに関連付けられているすべての補助ホストが削除されます。
ホスト名が |
emcli delete_siteguard_aux_host -system_name="sample-system" emcli delete_siteguard_aux_host -system_name="sample-system" -host_name="host1.example.com" emcli delete_siteguard_aux_host -system_name="austin-system" -host_name="host2.example.com"
関連項目:
delete_siteguard_configuration
システムおよび関連付けられているすべてのスタンバイ・システムの構成全体を削除します。
Oracle Site Guard構成を削除するEMCLIコマンド。このコマンドでは、システムおよびスタンバイ・システム内のスクリプト、資格証明アソシエーション、サイト・アソシエーションおよび操作計画を削除します。
形式
emcli delete_siteguard_configuration [-primary_system_name="name_of_the_primary_system"] [-standby_system_name="name_of_the_standby_system"] [-force="delete all Site Guard stale configurations"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
プライマリ・システムの名前。 |
|
スタンバイ・システムの名前。このパラメータを指定しない場合、指定したプライマリ・システムとすべてのスタンバイ・システムのサイト・ガード構成が削除されます。 |
|
失効構成を削除する必要があるかどうか。構成は、構成に関連する1つ以上のサイトが変更または削除された場合に失効する可能性があります。 |
emcli delete_siteguard_configuartion -primary_system_name="austin-system1" emcli delete_siteguard_configuration -standby_system_name="austin2-system2" emcli delete_siteguard_configuration -force="true"
delete_siteguard_credential_association
Oracle Site Guard構成から資格証明アソシエーションを削除します。
構成から資格証明アソシエーションを削除するEMCLIコマンド。
形式
emcli delete_siteguard_credential_association -system_name="name" -credential_type="type" [-target_name="name"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
サービスが存在しているシステム。 |
|
資格証明タイプ。 |
|
ターゲットの名前。 |
emcli delete_siteguard_credential_association -system_name="austin-system" -credential_type="HostNormal" emcli delete_siteguard_credential_association -system_name="austin-system" -credential_type="DatabaseSysdba" -target_name="austin-database-instance"
delete_siteguard_lag
システム内のデータベースの適用ラグおよびトランスポート・ラグのしきい値を削除します。
システム内のOracle Data Guardが有効化された1つ以上のデータベースに構成されている適用ラグおよびトランスポート・ラグのしきい値を削除するEMCLIコマンド。
形式
emcli delete_siteguard_lag -system_name="system name" -property_name="lag value" [-target_name="database target name"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
しきい値の制限を構成するシステム。 |
|
プロパティ名。有効な値は、 |
|
しきい値の制限が構成されているターゲット・データベースの名前。このパラメータが指定されない場合、しきい値はシステムのすべてのデータベースに適用されます。 |
emcli delete_siteguard_lag -system_name="austin-system" -property_name="apply_lag" emcli delete_siteguard_lag -system_name="austin-system" -target_name="OID_db" -property_name="transport_lag"
関連項目:
update_siteguard_lag、configure_siteguard_lagおよびget_siteguard_lagコマンド。
delete_siteguard_script
Oracle Site Guard構成からスクリプトを削除します。
サイト構成からスクリプトを削除するEMCLIコマンド。
形式
emcli delete_siteguard_script -script_id="script id"
パラメータ | 説明 |
---|---|
|
スクリプトに関連付けられたID。 |
emcli delete_siteguard_script -script_id="10"
delete_siteguard_script_credential_params
Oracle Site Guardスクリプトに渡された資格証明を削除します。
スクリプトにパラメータとして渡された名前付き資格証明を削除するEMCLIコマンド。
形式
emcli delete_siteguard_script_credential_params -script_id="Id associated with the script" [-credential_name="name of the credential"] [-credential_owner="credential owner"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
スクリプトに関連付けられたID。 |
|
資格証明の名前。この引数が指定されない場合、スクリプトに関連付けられているすべての資格証明が削除されます。 |
|
資格証明の所有者。資格証明の所有者がログインしているユーザーと同じである場合、このパラメータを指定する必要はありません。 |
emcli delete_siteguard_script_credential_params -script_id="1" -credential_name="NAMED_CREDENTIAL_X" emcli delete_siteguard_script_credential_params -script_id="2" -credential_name="NAMED_CREDENTIAL_Y" -credential_owner="SG_ADMIN" emcli delete_siteguard_script_credential_params -script_id="3"
delete_siteguard_script_hosts
Oracle Site Guardスクリプトに関連付けられているホストを削除します。
emcli delete_siteguard_script_hosts
-script_id="script id"
-host_name="host_name"
パラメータ | 説明 |
---|---|
-script_id |
スクリプトに関連付けられたID。 |
-host_name |
このスクリプトが実行されるホストの名前。
このパラメータは、2回以上指定できます。 |
emcli delete_siteguard_script_hosts -script_id="10" -host_name="host.example.com"
get_operation_plan_details
Oracle Site Guard操作計画の詳細を取得します。
設定されている操作計画に関する完全な詳細情報を出力するEMCLIコマンド。このコマンドをスクリプト・モードで使用すると、詳細がJSON形式で出力されます。
形式
emcli get_operation_plan_details -plan_name="plan_name"
パラメータ | 説明 |
---|---|
|
操作計画の名前。 |
emcli get_operation_plan_details -plan_name="austin-switchover"
関連項目:
get_operation_plans
構成済のOracle Site Guard操作計画をすべてリストします。
サイトに構成されているすべての操作計画をリストするEMCLIコマンド。出力には、計画名、操作名、プライマリ・サイト名、スタンバイ・サイト名、タグなどの情報が含まれています。
形式
emcli get_operation_plans [-plan_name="name_of_the_operation_plan"] [-operation="type_of_operation"] [-system_name="name_of_the_system"] [-primary_system_name="name_of_the_primary_system"] [-standby_system_name="name_of_the_standby_system"] [-tags="tag names separated by ;" ]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
操作計画の名前。 |
|
操作の名前。例: |
|
操作計画で使用するシステムの名前。これらの値を指定する場合、 |
|
操作計画で使用するプライマリ・システムの名前。 |
|
操作計画で使用するスタンバイ・システムの名前。 |
|
操作計画に追加するタグのセミコロン区切りリスト。カンマ(,)は無効な文字です。 |
emcli get_operation_plans -operation="switchover" -system_name="austin-system" emcli get_operation_plans -operation="switchover" -primary_system_name="austin-system" emcli get_operation_plans -operation="failover" -standby_system_name="austin2-system" emcli get_operation_plans -name="austin-switchover-plan" -system_name="austin-system" emcli get_operation_plans -tags="rack1_austin"
関連項目:
get_site_properties
タグを使用して、サイト間での操作計画をグループ化および検索できます。
サイトに割り当てられたユーザー定義のプロパティをリストするか、指定したプロパティ名と値に一致するサイトをリストします。
形式
emcli get_site_properties -system_name="Name of the system (site)" -properties="property names list or name=value pairs separated by ;"
パラメータ | 説明 |
---|---|
|
汎用システム(サイト)の名前。 |
|
検索するプロパティ名またはname=valueペアのセミコロン(;)で区切られたリスト。 |
例1
次の例では、指定されたサイトの指定されたプロパティ名の値を取得します。
emcli get_site_properties -system_name="austin-system" -properties="customer; data center"
例2
次の例では、指定されたサイトのすべてのプロパティの値を取得します。
emcli get_site_properties -system_name="utah-system"
例3
次の例では、指定されたプロパティに一致するすべてのサイトを取得します。
emcli get_site_properties -properties="data center=austin dc; rack=11-935zxp"
get_siteguard_aux_hosts
Oracle Site Guardシステムの補助ホストをすべてリストします。
システムに関連付けられているすべての補助ホストのリストを出力するEMCLIコマンド。
形式
emcli get_siteguard_aux_hosts -system_name="system_name"
パラメータ | 説明 |
---|---|
|
操作を実行しているシステム。 |
emcli get_siteguard_supported_targets -system_name="example-system"
関連項目:
get_siteguard_configuration
Oracle Site Guard構成の詳細をリストします。
設定されている構成を出力するEMCLIコマンド。出力には、プライマリ・サイトとスタンバイ・サイトの構成の詳細が含まれています。
形式
emcli get_siteguard_configuration [-system_name="name_of_the_system"] [-primary_system_name="name_of_the_primary_system"] [-standby_system_name="name_of_the_standby_system"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
操作計画で使用されているシステムの名前。これを指定する場合、 |
|
プライマリ・システムの名前。 |
|
スタンバイ・システムの名前。 |
emcli get_siteguard_configuartion -primary_system_name="austin-system" -standby_system_name="austin2-system" emcli get_siteguard_configuration -system_name="austin-system"
get_siteguard_credential_association
システムに構成されている資格証明をすべてリストします。
システムに構成されている資格証明アソシエーションをリストするEMCLIコマンド。出力には、ターゲット名、資格証明名および資格証明タイプが含まれています。
形式
emcli get_siteguard_credential_association -system_name="name_of_the_system" [-target_name="name_of_the_target"] [-credential_type="type_of_the_credential"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
システムの名前。 |
|
ターゲットの名前。 |
|
資格証明のタイプ。 |
emcli get_siteguard_credential_association -system_name="austin-system" -credential_type="HostNormal" emcli get_siteguard_credential_association -system_name="austin-system" -target_name="austin-database-instance" -credential_type="DatabaseSysdba"
get_siteguard_health_checks
操作計画のヘルス・チェックのスケジュールを取得します。
操作計画のヘルス・チェックのスケジュールを表示するEMCLIコマンド。
形式
emcli get_siteguard_health_checks -plan_name="name_of_the_operation_plan"
パラメータ | 説明 |
---|---|
|
ヘルス・チェックのスケジュールを表示する操作計画の名前。 |
emcli get_siteguard_health_checks -plan_name="austin-switchover"
get_siteguard_lag
データベース・システムのラグに構成されている制限を取得します。
システムの1つまたはすべてのデータベースのapply_lag
およびtransport_lag
ラグに構成されている制限を取得するEMCLIコマンド。
形式
emcli get_siteguard_lag -system_name="name_of_the_system" -property_name="lag_type" [-target_name="database_target_name"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
システムの名前。 |
|
プロパティの名前有効な値は、 |
|
データベースの名前。データベース名を指定しない場合、システム内のすべてのデータベースについてプロパティが取得されます。 |
emcli get_siteguard_lag -system_name="austin-system" -property_name="apply_lag" emcli get_siteguard_lag -system_name="austin-system" -target_name="OID_db" -property_name="transport_lag"
get_siteguard_script_credential_params
Oracle Site Guardスクリプトのパラメータとして使用されている資格証明をすべて取得します。
スクリプトのすべての資格証明パラメータを出力するEMCLIコマンド。
形式
emcli get_siteguard_script_credential_params -script_id="Id_associated_with_the_script" [-credential_name="name_of_the_credential"] [-credential_owner="credential_owner"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
スクリプトに関連付けられたID。 |
|
資格証明の名前。この引数が指定されない場合、スクリプトに関連付けられているすべての資格証明が削除されます。 |
|
資格証明の所有者。資格証明の所有者がログインしているユーザーと同じである場合、このパラメータを指定する必要はありません。 |
emcli get_siteguard_script_credential_params -script_id="1" -credential_name="NAMED_CREDENTIAL_X" emcli get_siteguard_script_credential_params -script_id="3" emcli get_siteguard_script_credential_params -script_id="3" -credential_owner="SG_ADMIN"
get_siteguard_script_hosts
Oracle Site Guardスクリプトに関連付けられているホストをすべてリストします。
スクリプトで使用されているホストをリストするEMCLIコマンド。出力には、ホスト名が含まれています。
形式
emcli get_siteguard_script_hosts -script_id="script_id"
パラメータ | 説明 |
---|---|
|
スクリプトに関連付けられたID。 |
emcli get_siteguard_script_hosts -script_id="10"
関連項目:
get_siteguard_scripts
システム内のOracle Site Guardスクリプトをすべてリストします。
システムに関連付けられているスクリプトを出力するEMCLIコマンド。出力には、スクリプトID、タイプ、操作、パスおよびロールが含まれています。
形式
emcli get_siteguard_scripts -system_name="system_name" -operation="operation_name" -script_type="type_of_the_script" [-role="role_of_the_system"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
システムの名前。 |
|
操作の名前。 |
|
スクリプトのタイプ。 |
|
システムに関連付けられたロールに基づいてスクリプトをフィルタ処理します。 |
emcli get_siteguard_scripts -system_name="austin-system" -operation="Switchover" -script_type="Pre-Script" emcli get_siteguard_scripts -system_name="austin-system" -operation="Switchover" -script_type="Pre-Script" -role="Primary"
get_siteguard_supported_targets
Oracle Site Guardシステム内のターゲットをすべてリストします。
システム内のすべてのサポート対象ターゲットのリストを出力するEMCLIコマンド。
形式
emcli get_siteguard_supported_targets -system_name="system name" [-target_type="target type"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
システムの名前。 |
|
ターゲットのタイプ。 |
emcli get_siteguard_supported_targets -system_name="austin-system" emcli get_siteguard_supported_targets -system_name="austin-system" -target_type="weblogic" emcli get_siteguard_supported_targets -system_name="austin-system" -target_type="database"
run_prechecks
Oracle Site Guard操作計画の事前チェックを実行します。
操作計画の事前チェックを実行するEMCLIコマンド。
形式
emcli run_prechecks -plan_name="name_operation_plan" [-database_lag_checks="true or false"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
操作計画の名前。 |
|
すべてのData Guard構成済データベースに対し、事前チェックの一部としてデータベース・ラグ・チェックを実行します。 |
emcli run_prechecks -plan_name="austin-switchover" emcli run_prechecks -plan_name="austin-switchover" -database_lag_checks="true"
schedule_siteguard_health_checks
操作計画のヘルス・チェックをスケジュールします。
emcli schedule_siteguard_health_checks
-plan_name="name of the operation plan"
-schedule= "start_time:yyyy/MM/dd HH:mm;
tz:java timezone ID;
frequency:interval/weekly/monthly/yearly;
repeat:tx;
end_time:yyyy/MM/dd HH:mm;
grace_period:xxx;"
-email="email_address_to_be_notified" <Optional>
-notify_on_failure <Optional>
パラメータ | 説明 |
---|---|
-plan_name |
ヘルス・チェックをスケジュールする操作計画の名前。 |
-schedule |
ヘルス・チェックを実行するためのスケジュール。
指定しないと、ヘルス・チェックは無期限に実行します。
値を |
-email |
ヘルス・チェック・レポートの通知に使用する電子メール・アドレス。この電子メール・アドレスは、現在のユーザーの構成された電子メール・アドレスである必要があります。 |
-notify_on_failure |
設定した場合、ヘルス・チェック・レポートは実行が失敗したときにのみ電子メールで送信されます。 |
emcli schedule_siteguard_health_checks
-plan_name="sample-switchover"
-schedule="start_time:2014/06/10 15:45"
emcli schedule_siteguard_health_checks
-plan_name="sample-switchover"
-schedule="start_time:2014/10/29 2:00;frequency:interval;repeat:1d"
-email="admin@example.com"
-notify_on_failure
emcli schedule_siteguard_health_checks
-plan_name="sample-failover"
-schedule="start_time:2014/08/10 01:00;frequency:interval;repeat:1w"
emcli schedule_siteguard_health_checks
-plan_name="austin-failover"
-schedule="start_time:2014/08/10 1:00;frequency:weekly;days:6,7; grace period:60;tz:America/New_York"
stop_siteguard_health_checks
Oracle Site Guard操作計画での将来のヘルス・チェック実行をすべて停止します。
操作計画でのヘルス実行を停止するEMCLIコマンド。
形式
emcli stop_siteguard_health_checks -plan_name="name_of_the_operation_plan"
パラメータ | 説明 |
---|---|
|
ヘルス・チェックの実行を停止する操作計画の名前。 |
emcli stop_siteguard_health_checks -plan_name="austin-switchover"
submit_operation_plan
実行対象のOracle Site Guard操作計画を送信します。
実行対象の操作計画を送信するEMCLIコマンド。
形式
emcli submit_operation_plan -plan_name="name_of_operation_plan" [-disable_run_prechecks="whether_or_not_to_run_prechecks"] [-stop_primary="whether_to_stop_the_primary_site_during_failover"] [-database_lag_checks="whether to run database lag checks"] [-database_trace_enable="whether to enable database tracing"] [-database_immediate_failover="whether to fail over the database immediately"] [-ignore_warnings]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
操作計画の名前。 |
|
事前チェックを実行しません。 |
|
フェイルオーバー操作中にプライマリ・サイトのターゲットを停止するかどうか。 |
|
すべてのData Guard構成済データベースに対し、事前チェックの一部としてデータベース・ラグ・チェックを実行します。 |
|
スイッチオーバーまたはフェイルオーバー操作中に追加のデータベース・トレース・メッセージをログに送信します。 |
|
データベースを即座にフェイルオーバーし、REDOログを適用しません。 |
|
フェイルオーバーを実行する際に致命的でない警告を無視します。 |
emcli submit_operation_plan -plan_name="example-switchover" emcli submit_operation_plan -plan_name="example-switchover" -disable_run_prechecks emcli submit_operation_plan -plan_name="austin-switchover" -disable_run_prechecks="true" -database_trace_enable="true" emcli submit_operation_plan -plan_name="austin-switchover" -database_lag_checks="true" emcli submit_operation_plan -plan_name="austin-failover" -stop_primary="true" -database_immediate_failover="true" emcli submit_operation_plan -plan_name="austin-failover" -ignore_warnings emcli submit_operation_plan -plan_name="austin-failover" -stop_primary -ignore_warnings
関連項目:
update_operation_plan
Oracle Site Guard操作計画を更新します。
操作計画を更新するEMCLIコマンド。
emcli update_operation_plan -plan_name="name of the plan" -step_number="plan step number to update" -target_host="name of the target host" -target_name="name of the target" -error_mode="the error mode" <Optional> -enabled="flag specifying whether the step should be enabled" <Optional> -execution_mode="execution mode" <Optional> -execution_group=when execution_mode is parallel, then targets sharing the same execution group will execute in parallel <Optional> -timeout="timeout in seconds" <Optional> -move="direction in which to move step" <Optional> -delete "whether step should be deleted" <Optional>
パラメータ | 説明 |
---|---|
-plan_name |
操作計画の名前。 |
-step_number |
更新する必要があるステップの番号。 |
-target_host |
システムの名前。これを指定すると、このターゲット・ホストに関連するすべてのステップが更新されます。 |
-error_mode |
操作の機能。stop またはcontinue のいずれかです。
|
-enabled |
true またはfalse のいずれかです。
|
-execution_mode |
実行モード。Serial またはParallel のいずれかです。
|
-execution_group |
ターゲットの実行グループ。このグループのすべてのメンバーがパラレル実行されます。1から10までの整数で指定し、各グループは順次実行されます。 |
-timeout |
ステップの実行のタイムアウト(秒)。1秒から86400秒(24時間)までの値で指定します。 |
-move |
順序を変更します。Up またはDown のいずれかです。
|
-delete |
ステップを削除するかどうか。true またはfalse のいずれかです。
|
emcli update_operation_plan
-name="sample-switchover"
-step_number="1"
-error_mode="Continue"
-enabled="true"
-execution_mode="Serial"
-execution_group="2"
-timeout="10800"
emcli update_operation_plan
-name="sample-switchover"
-step_number="5"
-move="Up"
emcli update_operation_plan
-name="sample-switchover"
-target_host="myhost.example.com"
-error_mode="Continue"
-enabled="true"
emcli update_operation_plan
-name="example-switchover"
-target_name="/Farm1/MyDomain"
-delete="true"
関連項目:
update_site_properties
サイトに割り当てられている既存のユーザー定義のプロパティを更新します。更新されるプロパティ名は、すでにそのサイトに割り当てられている必要があります。新規プロパティを追加するには、emcli add_site_propertiesコマンドを使用します。
形式
emcli update_site_properties -system_name="Name of the system (site)" -properties="property name=value pairs separated by ;"
パラメータ | 説明 |
---|---|
|
汎用システム(サイト)の名前。 |
|
サイトで更新するproperty name=valueのペアのセミコロン(;)で区切られたリスト。 |
例
emcli update_site_properties -system_name="austin-system" -properties="customer=acme corp; data center=austin dc"
emcli update_site_properties -system_name="utah-system" -properties="rack=08-57wvx"
update_siteguard_configuration
プライマリ・システムにスタンバイ・システムをさらに追加します。
スタンバイ・システムをプライマリ・システムに追加するEMCLIコマンド。1つのプライマリ・システムを、1つ以上のスタンバイ・システムに関連付けることができます。
形式
emcli update_siteguard_configuration -primary_system_name="primary_system_name"] -standby_system_name="standby_system_name"] [-reverse_role="whether_to_reverse_system_roles"] [-role="new role of standby system"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
プライマリ・システムの名前。 |
|
追加するスタンバイ・システムの名前。このパラメータは、2回以上指定できます。 |
|
スタンバイからプライマリにサイトのロールをリバースするかどうか。 このオプションを指定する場合、 |
|
スタンバイ・システムの新規ロール。 このオプションを指定する場合、
|
emcli update_siteguard_configuartion -primary_system_name="austin-system" -standby_system_name="austin2-system" emcli update_siteguard_configuration -primary_system_name="austin-system" -standby_system_name="austin2-system" -reverse_role emcli update_siteguard_configuration -primary_system_name="austin-system" -standby_system_name="utah-system" -role="ValidateStandby"
update_siteguard_credential_association
Oracle Site Guard資格証明アソシエーションを更新します。
システムの資格証明アソシエーションを更新するEMCLIコマンド。
形式
emcli update_siteguard_credential_association -system_name="name_of_the_system" -credential_type="type_of_the_credential" -credential_owner="credential_owner" [-target_name="name_of_the_target"] [-credential_name="name_of_the_credential"] [–use_preferred_credential="whether to use a preferred credential"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
システムの名前。 |
|
ターゲットの名前。 |
|
資格証明のタイプ。 |
|
資格証明の名前。 |
|
優先資格証明を使用している場合は、 |
|
資格証明の所有者。資格証明の所有者がログインしているユーザーと同じである場合、この引数を指定する必要はありません。 |
emcli update_siteguard_credential_association -target_name="austin-database-instance" -credential_type="DatabaseSysdba" -credential_name="HOST-DBCRED" -credential_owner="sysman"
emcli update_siteguard_credential_association -target_name="austin-database-instance" -credential_type="DatabaseSysdba" -credential_name="HOST-DBCRED" -credential_owner="sysman"
update_siteguard_lag
システム内のデータベースのラグのしきい値を更新します。
システム内の1つまたはすべてのデータベースの適用ラグおよびトランスポート・ラグのしきい値を更新するEMCLIコマンド。
形式
emcli update_siteguard_lag -system_name="system_name" -property_name="lag_type" -value="max_limit" [-target_name="database_target_name"]
注意:
[]
は、パラメータがオプションであるか、一定の条件下ではオプションであることを示します。
パラメータ | 説明 |
---|---|
|
しきい値の制限を構成するシステム。 |
|
しきい値の制限を構成するデータベース・ターゲット名。このパラメータが指定されない場合、しきい値はシステムのすべてのデータベースに適用されます。 |
|
プロパティ名。有効な値は、 |
|
更新するしきい値(秒単位)。 |
emcli update_siteguard_lag -system_name="example-system" -property_name="apply_lag" -value="1000" emcli update_siteguard_lag -system_name="example-system" -target_name="OID_db" -property_name="transport_lag" -value="2500"
関連項目:
get_siteguard_lag、
configure_siteguard_lagおよびdelete_siteguard_lagコマンド。
update_siteguard_script
Oracle Site Guardスクリプトに関連付けられているパスおよびフラグを更新します。
スクリプトに関連付けられているパスおよびall_hosts
フラグを更新するEMCLIコマンド。
emcli update_siteguard_script
-script_id="ID_associated_with_the_script"
-path="path_of_the_script" <Optional>
-component="path of the entity in Software library" <Optional>
-runtime_script="if_prechecks_to_check_availability_of_the_script" <Optional>
–credential_type="type_of_credential" <Optional>
-credential_name="name of the credential" <Optional>
-host_name="name_of_the_host_where_this_script_will_run" <Optional>
-run_on="whether to run on ANY or ALL hosts" <Optional>
-all_hosts="whether to run the script on all the hosts in the system" <Optional>
-credential_owner="credential_owner" <Optional>
パラメータ | 説明 |
---|---|
-script_id |
スクリプトID。 |
-path |
スクリプトへのパス。 |
-component |
ソフトウェア・ライブラリのエンティティへのパス。このパラメータの値が指定される場合、パスに含められるのはファイル名とそのパラメータのみです。 |
-runtime_script |
スクリプトがランタイム・スクリプトであるかどうか。スクリプトがランタイム・スクリプトとして指定される場合、事前チェックはスクリプトを確認しません。スクリプトが動的にマウントされるか、操作計画の実行の一部として生成される場合、このオプションを使用できます。
デフォルトでは、ソフトウェア・ライブラリからステージングされたすべてのスクリプトがランタイム・スクリプトとして指定されます。ソフトウェア・ライブラリからステージングされないスクリプトのデフォルト値は、falseです |
–credential_type |
資格証明のタイプ。HostNormal またはHostPrivileged のいずれかです。
|
-credential_name |
資格証明の名前。値が指定されない場合、パラメータcredential_type の値を指定する必要があります。
|
-host_name |
このスクリプトを実行するホストの名前。複数指定できます。 |
-run_on |
使用可能なホストの1つのみでスクリプトを実行する(any )か、すべてのホストで実行する(all )か。デフォルト値はall です。
|
-all_hosts |
スクリプトを、システム内のすべてのホストで実行できるようにするためのオプション・フラグ。true またはfalse を指定します。host_name パラメータに入力したすべての値をオーバーライドします
|
-credential_owner |
資格証明の所有者。資格証明の所有者がログインしているユーザーと同じである場合、この引数を指定する必要はありません。 |
emcli update_siteguard_script -script_id="10" -path="/tmp/script" -all_hosts="true" emcli update_siteguard_script -script_id="10" -path="stop_mycomponent.sh" -component="/Components/MyScripts/LCM_Operations" -all_hosts="true" emcli update_siteguard_script example.com-script_id="10" example.com-host_name="host1.example.com" example.com-host_name="host2.example.com" example.com-run_on="any" emcli update_siteguard_script example.com-script_id="10" example.com-all_hosts="false" example.com-credential_name="MY_NAMED_HOST_CREDENTIAL" example.com-host_name="host1.example.com" emcli update_siteguard_script example.com-script_id="16" example.com-path="/tmp/script" example.com-credential_type="HostPrivileged" example.com-runtime_script="true"