SharePlex 11.4 - アップグレードガイド

このガイドについて

このガイドでは、SharePlex環境をアップグレードする手順を説明します。本書は、管理者、コンサルタント、アナリスト、およびSharePlex™のアップグレードを担当するその他のITプロフェッショナルを対象としています。

その他のSharePlex関連ドキュメント

SharePlexドキュメント一式については、https://support.quest.com/shareplex/technical-documentsをご覧ください。

この文書をPDF形式で見る

この文書はAdobe PDF形式でダウンロード、閲覧、保存することができます。このページの右上隅にある「ダウンロード」をクリックしてください。この操作により、資料全体がダウンロードされます。

アップグレードする前に

このセクションでは、SharePlexインストーラを選択し、アップグレード手順を開始する前に知っておく必要がある重要な情報について説明します。

必要な情報の収集

アップグレードするインストールについて、以下の情報が必要です。

• SharePlex製品ディレクトリの場所
• SharePlexのこのインスタンス内のSharePlex変数データディレクトリ（1つまたは複数）の場所
• SharePlex管理者グループ（SharePlex管理者ユーザを含む）の名前
• アップグレードするインストールに関連付けられているORACLE_SIDおよびORACLE_HOME（Oracle）またはデータベース名（Open Target）。これを確認するには、製品ディレクトリのdataサブディレクトリにあるdefaults.yamlファイルを参照します。

• var/odbc/ODBC.iniファイルのDSN名。

相互運用性をチェックする

構成内のSharePlexインストールの一部をアップグレードし、他をアップグレードしない場合は、バージョン間の相互運用性サポートについてSharePlexリリースノートを参照してください。パラメータの設定が必要な場合があります。

アップグレードを行える人物

アップグレード手順のいくつかのステップでは、管理者の権限レベルが必要です。これは通常、SharePlex管理者として指定された人にのみ付与されます。アップグレードは、この権限を持ち、SharePlexに精通した人物のみが行うことができます。

新しいパラメータと非推奨のパラメータの確認

• リリースノートと『SharePlexリファレンスガイド』の「非推奨のパラメーター」セクションを確認して、使用しているパラメータがこのリリースで非推奨になったかどうかを確認してください。SharePlexは、新たに非推奨になったパラメータを含め、現在のパラメータ設定の後方互換性を保持するため、プロセスを停止して設定を再設定する必要はありません。ただし、設定の変更が適切かどうかを判断するために、新しいパラメーターまたは非推奨のパラメーターを置き換えるデフォルト機能をよく理解しておく必要があります。
• リリースノートの「今回のリリースで提供される新機能」と「Enhancements in this release（このリリースの機能拡張）」セクションを確認して、現在の設定に影響する新しいパラメータがないかどうかを確認してください。アップグレードステップが必要な場合は、それらが記載されます。

ソースシステムでのアップグレード

これらの要件は、SharePlexがOracleまたはPostgreSQLソースデータベースからキャプチャする場合に適用されます。

単発ビルドが含まれていることを検証する

SharePlexの単発ビルドを受け取っている場合、それらのビルドがインストールする新しいリリースに修正として含まれていることを確認してください。これはLinux/Unixのみに適用されます。

単発ビルドを確認するには:

1. 現在SharePlexがインストールされている製品ディレクトリのutilサブディレクトリからsp-bininfoユーティリティを実行します。

   $ cd path_to_SharePlex_proddir/util

   $ ./sp-bininfo

2. sp-bininfoの出力に表示される各ワンオフのCRと、SharePlexの新しいバージョンに同梱されているリリースノートの「Resolved Issues（解決済みの問題）」セクションのCRをcompareしてください。
3. お客様のワンオフのCRが「Resolved Issues（解決済みの問題）」にない場合、新しいバージョンにはその機能が含まれていないため、アップグレードを続行しないでください。不足している修正プログラムを入手するには、SharePlexのサポートにご連絡ください。

Oracleデータベースがソースである場合に文字セット変換をサポートするための要件

オープンターゲット（Oracle以外）にレプリケートする場合、SharePlexは任意のOracle Unicode文字セットおよびUS7ASCII文字セットからのレプリケーションをサポートします。SharePlexは、Unicode文字セットでオープンターゲットにデータをポストするため、ソースデータがUnicodeまたはUS7ASCIIの場合、ターゲット上で変換する必要はありません。

ただし、以下の項目に当てはまる場合は、ターゲット上で変換が必要となります。

• ソースデータの文字セットがOracle UnicodeまたはUS7ASCII以外の場合、ターゲットにポストするには、ターゲットにOracleクライアントをインストールしてUnicodeへの変換を実行する必要があります。
• データをUnicode以外の文字セットでターゲットデータベースにポストする必要がある場合は、ターゲットにOracleクライアントをインストールして変換を実行し、targetコマンドを使用してPostが使用するターゲット文字セットを特定する必要があります。
• LOBデータをレプリケートする場合は、ソースの文字セットにかかわらず変換が必要です。

Linux上のOracleクライアントで変換を実行するには:

1. Oracle管理者クライアントをターゲットシステムにインストールします。クライアントは、管理者インストールタイプでなければなりません。Instant Clientインストールタイプおよびランタイム・インストール・タイプはサポートされていません。
2. ORACLE_HOMEをクライアントのインストールに設定します。ORACLE_SIDをエイリアスまたは存在しないSIDに設定します。これらのSIDはSharePlexで使用されず、データベースが実行されている必要はありません。
3. お使いのオペレーティングシステム用のLinux/Unixインストーラを使用して、アップグレードSharePlexします。
4. SP_OPX_NLS_CONVERSIONパラメータがデフォルトの1に設定されていることを確認してください。

UnicodeとUS7ASCIIのデータを変換せずに適用するには:

ソースデータがUnicodeまたはUS7ASCIIで、LOBデータをレプリケートしない場合は、変換やOracleクライアントは必要ありません。SP_OPX_NLS_CONVERSIONパラメータを0に設定して変換を無効にし、Postが実行中であれば再起動します。

SharePlexインストーラのダウンロード

SharePlexインストーラのダウンロード

オペレーティングシステムの種類によって、SharePlexのインストーラーは異なります。このトピックは、その違いと使用されている命名規則を理解するのに役立ちます。

LinuxおよびUnix

LinuxおよびUnix（該当する場合）上のSharePlexインストーラは、拡張子.tpmの自己解凍型インストールファイルです。

OracleおよびOpen Target:

個別のSharePlexインストーラビルドが、サポートされているプラットフォームごとにあります。

SharePlex-release#-build#-platform-chipset.tpm

Oracle Solaris（Sun）の場合は、個別のSharePlexインストーラビルドが、サポートされているオペレーティングシステムのバージョンごとにあります。お持ちのオペレーティングシステムのバージョンがリストされていない場合は、お持ちのバージョンより下の番号の中で最も大きいものを選択してください。

SharePlex-release#-build#-platform-version-chipset.tpm

インストーラは、抽出のための一時ターゲットディレクトリを現在のディレクトリ内に作成します。この一時ターゲットディレクトリは、インストール完了時に削除されます。.tpmファイルを実行するときに-tオプションを使用すると、SharePlexインストール場所とは別のファイルシステムにファイルを展開できます。

注意: PostgreSQLデータベースのインストールファイル（.tpm）ファイルは、Linuxプラットフォームでのみ利用可能です。

SharePlexインストーラを取得する場所

オペレーティングシステムに対応するSharePlexインストールパッケージをダウンロードしてください。

SharePlexパッチもダウンロードして、基本ソフトウェアをインストールした後にインストールできるようにします。

以下の手順でSharePlexパッチをダウンロードします。

1. Questソフトウェア・サポート・ページに移動します: http://support.quest.com/

2. 「Download Software（ソフトウェアをダウンロード）」をクリックします。

3. 検索ボックスに「SharePlex」と入力してGoを押します。

4. 必要なバージョンのDownload列の矢印をクリックします。また、ファイル名をクリックすると、詳細情報にアクセスしたり、ファイルをダウンロードしたりすることができます。

5. SharePlexをインストールするシステムにファイルを転送します

6. これでインストールプロセスを開始する準備が整いました。インストーラを実行する前に、必ずバージョンごとのリリースノートを熟読してください。

Oracle DatabaseについてLinux/Unix上でアップグレードする

これらの手順は、LinuxまたはUnixシステム上で動作するOracleまたはPostgreSQLデータベース用に構成されているSharePlexをアップグレードするためのものです。

SharePlexを現在の製品ディレクトリでアップグレードするには:

1. SharePlexインストール所有者としてシステムにログインします。

2. （copy/appendを使用する場合）ターゲットシステムのsp_ctrlで、SharePlexアップグレードを適用する前にsp_sync_launcherを停止します。

   sp_ctrl> stop launcher

3. （Oracleソースのみに適用）ソースシステム上のsp_ctrlで、set paramコマンドを使用して、SP_OCT_REPLICATE_ALL_DDLパラメータを0に設定し、DDLレプリケーションを停止します。

   sp_ctrl> set param SP_OCT_REPLICATE_ALL_DDL 0

4. アップグレードするSharePlexインスタンスをシャットダウンします。

   sp_ctrl> shutdown

   注意: ソースデータベースが論理レプリケーションを使用するPostgreSQLの場合は、SharePlexインスタンスをシャットダウンする前にCaptureプロセスを停止します。

5. そのインスタンスのすべてのSharePlexプロセスSharePlexが停止していることを確認し、まだ実行中のプロセスがあれば停止します。

   # ps -ef | grep sp_

   sp_ctl> stop process

6. （オプション）OracleまたはPostgreSQLデータベースをアップグレードする必要がある場合は、今アップグレードしてください。
7. 既存のSharePlex製品ディレクトリでtarを実行し、tarファイルをバックアップとして別の場所に移動します。

8. インストールプログラムSharePlexを実行します。

   1. このインストール中にSharePlex管理者として指名されるユーザとしてシステムにログインします。このユーザがインストールファイルとバイナリの所有者となります。
   2. sp_copが実行中の場合は、シャットダウンします。
      sp_ctrl>shutdown
   3. 書き込み権限のある一時ディレクトリにインストールファイルをコピーします。
   4. ファイルの実行権限を与えます。
      #chmod 555installation_file
   5. .tpmファイルを実行します。SharePlexをクラスタにインストールする場合は、プライマリノード（共有ディスクがマウントされているノード）からインストーラを実行します。
      # ./installation_file
   6. 最初の画面に表示されている情報が、アップグレードするバージョンとプラットフォーム（OracleまたはPostgreSQL）に対応していることを確認します。
9. 最初のプロンプトに表示されている情報が、アップグレードするバージョンとプラットフォーム（OracleまたはPostgreSQL）に対応していることを確認します。
10. プロンプトに従って以下の情報を入力します。

    プロンプト	入力
    Installation type（インストールタイプ）	アップグレードするSharePlexインストールの現在の製品ディレクトリを選択します。
    SharePlex Admin group（SharePlex管理者グループ）	SharePlex管理者ユーザが所属するDBA-privilegedグループを選択します。
    Proceed with upgrade?（アップグレードを続行しますか?）	Enterを押してSharePlex環境を確認し、アップグレードを続行します。
    License key (do you want to upgrade?)（ライセンスキー（アップグレードしますか?））	Enterを押して、デフォルトの「N」（いいえ）を受け入れて既存のライセンスを維持するか、このアップグレードに必要な場合は「Y」を入力して新しいライセンスキーを指定します。
    Please specify platform for license key (select a number)（ライセンスキーのプラットフォームを指定してください（番号を選択してください））:	ライセンスキーをインストールするプラットフォームの以下のリストから適切な番号を選択してください。 1) Oracle 2) File 3) JMS 4) Kafka 5) SQL Server 6) Postgres 7) MySQL 8) Snowflake 9) Event Hubs 10) All Platforms q) Quit License Utility 注意: SharePlexの評価版をインストールするには、「All Platforms（すべてのプラットフォーム）」オプションを選択する必要があります。
    License key（ライセンスキー）	（Yを選択した場合）Questから受け取った新しいライセンスキーを入力します。

    注意: インストーラは、製品ディレクトリのdataサブディレクトリにあるdefault.yamlファイルに記載されているデフォルトの変数データディレクトリをアップグレードします。
    

11. アップグレードしたSharePlexの各variable-dataディレクトリに対して、データベース・セットアップ・ユーティリティを実行します。『SharePlexインストールおよびセットアップガイド』を参照して、OracleまたはPostgreSQL用のデータベースセットアップを実行してください。
    Oracle: ora_setup

    PostgreSQL: pg_setup

12. 以下の構文を使い、適切なオプションを指定して、SharePlexを起動します。

    $ cd /productdir/bin

    $ ./sp_cop [-uidentifier] &

    ここで

    • -uidentifierは、アップグレードするインスタンスの一意な識別子でsp_copを起動します。これは、sp_copの複数のインスタンスがシステム上で実行されている場合にのみ必要です。

    注意: アップグレード後、論理レプリケーションを使用するPostgreSQLをソースとしている場合は、既存の設定を反映させるために、同じ設定ファイルを再度有効にしてください。これにより、Captureプロセスを開始する前に、論理レプリケーションに使用されるパブリケーションに新しく作成されたSharePlex内部テーブルが追加されます。

13. （Oracleソースのみに適用）ソースシステムのsp_ctrlで、SP_OCT_REPLICATE_ALL_DDLパラメータを1に設定します。

    sp_ctrl> set param SP_OCT_REPLICATE_ALL_DDL 1

SharePlexを新しい製品ディレクトリにアップグレードするには:

1. sp_copを停止します。

   sp_ctrl> shutdown

2. （オプション）OracleまたはPostgreSQLデータベースをアップグレードする必要がある場合は、今アップグレードしてください。
3. 既存のSharePlex製品ディレクトリでtarを実行し、tarファイルをバックアップとして別の場所に移動します。
4. SharePlexインストーラを実行し、製品ディレクトリの場所を指定するプロンプトが表示されたら、「New Installation（新規インストール）」を選択します。

   以下のプロンプトが表示されます。
   

   プロンプト	入力
   Installation type（インストールタイプ）	「<New Installation（新規インストール）>」を選択します。
   Product directory location (path)（製品ディレクトリの場所（パス））	SharePlexインストールディレクトリへのパスを入力します。 指定したディレクトリが存在しない場合は、インストーラによって作成されます。ディレクトリが存在する場合は、空である必要があります。このディレクトリに、以前のSharePlexインストールやその他のファイルがある場合、インストーラは終了します。 （Oracleソースのみに適用）クラスタでは、共有ディスクにインストールします。詳細については、『インストールおよびセットアップガイド』ドキュメントの「Installation and setup for Oracle cluster（Oracleクラスタにおけるインストールおよびセットアップ）」を参照してください。
   Variable data directory location（変数データディレクトリの場所）	空のディレクトリを指定します。指定されたディレクトリが存在しない場合は、インストーラによって作成されます。重要! このディレクトリをSharePlex製品ディレクトリにインストールしないでください。 （Oracleソースのみに適用）クラスタでは、共有ディスクにvariable-dataディレクトリをインストールします。詳細については、『インストールおよびセットアップガイド』ドキュメントの「Installation and setup for Oracle cluster（Oracleクラスタにおけるインストールおよびセットアップ）」を参照してください。
   SharePlex Admin group（SharePlex管理者グループ）	SharePlexバイナリを所有するSharePlex管理者ユーザが属するDBA-privilegedグループを入力します。SharePlex管理者のデフォルトグループがoinstallの場合、任意のオプションを選択し、このユーザがetc/groupファイルのoinstallの下にリストされていることを確認します。詳細については、『インストールおよびセットアップガイド』ドキュメントの「Installer checklist（インストーラチェックリスト）」を参照してください。
   TCP/IP port for SharePlex（SharePlexのTCP/IPポート）	SharePlex TCP/IP通信に使用するポート番号を入力します。
   License key (do you have?)（ライセンスキー（お持ちですか？））	Enterを押して、デフォルトの「Y」（はい）を受け入れます。ライセンスを持っていない場合は、「no」と入力してください。 クラスタのライセンスについては、『インストールおよびセットアップガイド』ドキュメントの「Installation and setup for Oracle cluster（Oracleクラスタにおけるインストールおよびセットアップ）」を参照してください。 SharePlexを実行する前の任意の時点で、splex_add_keyユーティリティを使用してライセンスキーを追加できます。詳細については、『インストールおよびセットアップガイド』ドキュメントの「SharePlex license utilities（SharePlexライセンスユーティリティ）」を参照してください。
   Please specify platform for license key (select a number)ライセンスキーのプラットフォームを指定してください（番号を選択してください））:	ライセンスキーをインストールするプラットフォームの以下のリストから適切な番号を選択してください。 1) Oracle 2) File 3) JMS 4) Kafka 5) SQL Server 6) Postgres 7) MySQL 8) Snowflake 9) Event Hubs 10) All Platforms q) Quit License Utility（ライセンスユーティリティを終了する） 注意: SharePlexの評価版をインストールするには、「All Platforms（すべてのプラットフォーム）」オプションを選択する必要があります。
   License key（ライセンスキー）	Questから受け取ったライセンスキーを入力します。

5. SP_SYS_VARDIR環境変数を、アップグレードしたい既存のvariable-dataディレクトリ（一時ディレクトリではない）にエクスポートします。
6. 既存のSharePlexデータベースユーザを使用して、データベース・セットアップ・ユーティリティを実行します。『SharePlexインストールおよびセットアップガイド』を参照して、OracleまたはPostgreSQL用のデータベースセットアップを実行してください。
   Oracle: ora_setup
   PostgreSQL: pg_setup
7. sp_copを起動します。
   $ /productdir/bin/sp_cop [-uidentifier] [-s] &