SharePlex 11.4 - インストールおよびセットアップガイド

ora_cleansp

説明

設定の非アクティベーションを含む、システム上の現在のレプリケーション状態を削除するには、ora_cleanspユーティリティを使用します。

サポート対象データベース

UnixおよびLinux上のOracle

ora_cleanspの他の代替手法

ora_cleanspを実行する前に、以下の代替手法を検討してください。

• レプリケーションを初期状態に戻さずに設定のアクティビティを停止するには、sp_ctrlでabort configコマンドまたはpurge configコマンドを使用できる場合があります。
• 変数データディレクトリのファイルを消去せずにSharePlexテーブルを切り捨てるには、製品ディレクトリのbinサブディレクトリ（UnixおよびLinux システム）からcleanup.sqlスクリプトを実行できます。
• UnixおよびLinuxシステムでは、SharePlex製品ディレクトリのbinサブディレクトリからcleanup.sqlスクリプトを実行することで、SharePlexテーブルを切り捨てることなく、変数データディレクトリのファイルをパージできます。

シェル要件

このユーティリティを使用するには、Korn（ksh）シェルがシステムにインストールされていなければなりません。ユーティリティは処理中にこのシェルを呼び出します。

ora_cleanspの仕組み

ora_cleanspは以下のように2段階でレプリケーションを初期状態に戻します。

内部テーブルの切り捨て: 最初にora_cleanspは、安全に切り捨てることができるSharePlex内部テーブルを切り捨てます。SharePlex Oracleユーザ、パスワード、デモオブジェクトは削除しません。

変数データディレクトリのクリーンアップ: 次にora_cleanspは、SharePlex変数データディレクトリから以下のコンポーネントを削除します。

• rimサブディレクトリ内のキューファイル。
• logサブディレクトリ内のログファイル。イベントログは、ora_cleanspプロシージャを反映する1つのエントリを保持します。
• dataサブディレクトリ内のstatusdbファイルの内容。
• dumpおよびstateサブディレクトリの内容。
• SP_OPO_SAVE_OOS_TRANSACTIONパラメーターが有効な場合、oosサブディレクトリにあるすべてのトランザクション。

ora_cleanspは、設定ファイル、コンフリクト解決ファイル、トランスフォーメーションファイル、ヒントファイル、paramdb、oramsglistファイルなど、ユーザが作成したファイルを維持します。

ora_cleanspは設定を非アクティベーションします。ora_cleanspを実行した後にレプリケーションを開始するには、設定をアクティベーションする必要があります。

ora_cleanspを実行するには:

重要! レプリケーションを初期状態に戻すには、すべてのソースシステムとターゲットシステムでora_cleanspを実行する必要があります。ora_cleanspがシステム上で実行されたかどうか、またいつ実行されたかを確認するには、そのシステムのイベントログを表示します。

1. SharePlex管理者としてログインします。

2. [UnixおよびLinuxのみ] SharePlex変数データディレクトリを指すようにSP_SYS_VARDIR環境変数を設定します。複数の変数データディレクトリを使用してsp_copの複数のインスタンスを実行している場合は、クリーンアップしたい変数データディレクトリに対してSP_SYS_VARDIRを設定します。

   kshシェル:

   $export SP_SYS_VARDIR=/SharePlex_vardir_absolute_path

   cshシェル:

   $setenv SP_SYS_VARDIR /SharePlex_vardir_absolute_path
3. SharePlex製品ディレクトリのbinサブディレクトリからsp_ctrlを実行します。

4. sp_copを停止します。

   sp_ctrl> shutdown
5. UnixおよびLinuxシステムで、ps -ef | grep sp_コマンドのいずれかを使用して、すべてのSharePlexプロセスが停止していることを確認します。
6. UnixおよびLinuxシステムで、kill -9コマンドのいずれかを使用して、すべての孤立したSharePlexプロセスを強制終了します。

7. [Unix および Linux のみ] まだ実行していない場合は、oratabファイルを表示して、インスタンスのORACLE_HOMEおよびORACLE_SIDの値を確認します。

   $cd /etc
   $ more oratab

8. [UnixおよびLinuxのみ] ORACLE_HOMEおよびORACLE_SID環境変数を設定します。

   kshシェル:

   $export ORACLE_HOME=[oratabファイルからの値]
   $export ORACLE_SID=[oratabファイルからの値]

   cshシェル:

   $ setenv ORACLE_HOME [oratabファイルからの値]
   $ setenv ORACLE_SID [oratabファイルからの値]

9. オペレーティングシステムのコマンドラインで、ディレクトリをSharePlex製品ディレクトリのbinサブディレクトリに変更します。

   注意: これは現在の作業ディレクトリである必要があります。

10. OracleインスタンスでSharePlexユーザアカウントとしてora_cleanspを実行します。注意: 別のユーザとして実行すると、ora_cleanspはSharePlexテーブルを切り捨てません。

    さらに、UnixとLinuxでは、connection.yamlファイルで定義されているデータベース/データソース名（Oracle_SID）を含めます。

    UnixおよびLinux:

    $ ./ora_cleansp database_name/SharePlex_username[/SharePlex_password]

    （Oracle PDBの場合）: $./ora_cleansp tns_alias for pdb/SharePlex_username[/SharePlex_password]

11. ユーティリティを実行した後、イベントログを表示して結果を確認します。

    注意: ユーティリティが .../save_SharePlex_versionディレクトリを削除できないというエラーメッセージを生成した場合、メッセージを無視してこのディレクトリを削除することができます。