1. コマンドライン・インタフェース
  2. Verbリファレンス
  3. EM CLI Verb
  4. switch_database

switch_database

Oracleリスナーを新しいOracleホームに切り替えます

書式

emcli switch_database 
–input_file_loc=” path of input file” 
-dest_oh=<path of new Gold image based Oracle home> 
-host_creds=<Normal Named host credential> 
-privilege_creds=<Named credential with root privileges>

[ ]は、オプションのパラメータを意味します

複数のデータベース全体でターゲットのタイプ、切替え先のOracleホーム、および資格証明が一貫していると、ユーザーはレスポンス・ファイルを使用することなく同じタスクを実行できます。

オプション

  • input_file_loc: 入力ファイル・パスの場所

  • target_name: 切り替える必要のあるデータベース・ターゲットの名前。

  • target_type:

    • 単一インスタンス・データベースの場合: oracle_database

    • RAC/RAC Oneデータベースの場合: rac_database

  • dest_oh: データベースの切替え先にする必要のある新しいOracleホームのパス。

  • host_creds: ホストのOracleホーム所有者の名前付き資格証明。"<Named Credentials>:<Owner>"の形式に従います。

    "Owner"フィールドは、Enterprise Managerの名前付き資格証明の所有者です。

    "Owner"が指定されていない場合は、デフォルトでログインしているユーザーが指定されます。

  • privilege_creds: データベースのroot権限が付与されている名前付き資格証明。

  • dataguard_role: 明示的な必須パラメータ。これがスタンバイ切替え操作の場合、ユーザーは、このパラメータを"STANDBY"に設定する必要があります。

ノート:

コマンドラインでデータベース名が指定されている場合、入力ファイルは使用されなくなります。

それぞれのデータベースに入力ファイルが指定されていると、レスポンス・ファイルの入力はコマンドラインの入力をオーバーライドします。

ホストに優先資格証明が設定されている場合、ユーザーはemcliコマンド(または入力ファイル)に"host_creds"と"privilege_creds"の指定を含めないこともできます。

同様のDP初期化ステップに検証が含まれています。emcliに資格証明の指定が含まれていないときに、優先資格証明も設定されていないと、DPは処理されることなくエラーで終了します。

このフラグが指定されていない場合は、Data Guard構成のないデータベース切替え操作であると見なされます。

入力ファイルの例

input_file: このファイルは"xml"形式のファイルにして、各データベース・ターゲットの詳細を含めます

<root>
<target>
<target_name>racm</target_name>
<target_type>rac_database</target_type>
<dest_oh>/scratch/aimedb/home1</dest_oh>
<host_creds>AIMEDB_NORMAL:SYSMAN</host_creds>
<privilege_creds>AIMEDB_P:SYSMAN</privilege_creds>
</target>
<target
><target_name>racp</target_name>
<target_type>rac_database</target_type>
<dest_oh>/scratch/aimedb/home2</dest_oh>
<host_creds>AIMEDB_NORMAL:SYSMAN</host_creds>
<privilege_creds>AIMEDB_P:SYSMAN</privilege_creds>
</target>
</root>

例5-2 例

この例は、複数のデータベースが存在する場合のswitch_databaseの使用方法を示しています。

emcli switch_database 
–target_name=<DB target name>[,<DB target name2>]* 
-target_type=<oracle_database|rac_database>  
-dest_oh=<path of new Gold image based Oracle home> 
-host_creds=<Normal Named host credential> 
-privilege_creds=<Named credential with root privileges> 
–dataguard_role=<Standby|Primary> -startupAfterSwitch=false