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

SharePlexがレプリケーションを実行するために必要な権限

以下は、SharePlexがレプリケーションを実行するために必要な権限のリストです。SharePlexデータベースユーザのDBAロールを取り消す場合は、これらの権限が付与されていることを確認してください。

要件

• Oracleのセットアップを実行するシステムにデータベースクライアントをインストールします。データベースで使用する適切なクライアントのバージョンについては、Oracleのドキュメントを参照してください。
• SharePlexのレプリケーション設定のすべてのソースおよびターゲットOracleインスタンスで、データベース・セットアップ・ユーティリティを実行します。
• 統合レプリケーショントポロジ、または複数の変数データディレクトリを持つ他のトポロジでは、各変数データディレクトリに対してデータベース・セットアップ・ユーティリティを実行します。

• SharePlexは、ローカルBEQUEATH接続またはTNSエイリアスを使用したリモート接続をサポートしています。使用する接続に必要な接続値をOracleのセットアップで指定する準備をしてください。TNSを使用する場合は、セットアップを実行する前にtnsnames.oraファイルを設定する必要があります。

• Oracleデータベースがマルチテナント・コンテナ・データベースの場合、レプリケーションシナリオに関連する各プラガブルデータベースについてデータベース・セットアップ・ユーティリティを実行します。SharePlexユーザおよびスキーマオブジェクトが各PDBに存在していなければなりません。
• アクティブな設定があるときにデータベース・セットアップ・ユーティリティを実行すると、SharePlexの内部テーブルをインストールまたは更新するためにセットアップによって実行されるDDLがターゲットにレプリケートされます。この問題を回避するには、ユーティリティを実行する前にSP_OCT_REPLICATE_ALL_DDLパラメーターを0に設定し、セットアップ完了後にパラメーターを以前の設定に戻します。このパラメーターは即座に有効になります。

SharePlexスキーマのストレージ要件

Oracleのデータベース・セットアップ・ユーティリティは、SharePlexで使用するためにいくつかのデータベースオブジェクトをインストールします。これらのオブジェクトのストレージ要件は、Oracleのセットアップを実行する前に満たしておく必要があります。以下の表を参照してください。

Oracleのデータベースセットアップの実行

重要! この手順を実行する前に、Oracleインスタンスをオープンしておく必要があります。

Oracleのデータベースセットアップを行うには、 以下の手順を実行します。

1. （UnixとLinuxのみ）複数の変数データディレクトリを使用している場合は、データベースセットアップを実行するSharePlexインスタンスの変数データディレクトリを指す環境変数をエクスポートします。

   kshシェル:

   export SP_SYS_VARDIR=/full_path_of_variable-data_directory

   cshシェル:

   setenv SP_SYS_VARDIR=/full_path_of_variable-data_directory

2. sp_copを含む、すべての実行中のSharePlexプロセスをシャットダウンします。

3. オペレーティングシステムのコマンドプロンプトから、SharePlexbinサブディレクトリのフルパスを使用してデータベース・セットアップ・プログラムを実行します。

4. SharePlexの設定で、システムがソースシステムであるか、ターゲットシステムであるか、あるいはソースシステムとターゲットシステムの両方であるかを指定します。

   注意: このプロンプトは、このデータベースセットアップを最初に実行したときにのみ表示されます。

5. 接続タイプにはOracleを選択します。
6. 希望する接続のタイプに合わせてSharePlexを適切に設定するためのプロンプトと応答については、以下の表を参照してください。

表8: セットアップのプロンプトと対応

7. Oracleのセットアップが完了した後、ora_setup.configファイルが <Installation_directory>/var/data内に生成されます。

Oracleのリモートキャプチャ用のデータベースセットアップの実行

重要! この手順を実行する前に、Oracleインスタンスをオープンしておく必要があります。

Oracleリモートキャプチャ用のデータベースセットアップを行うには、以下の手順を実行します。

1. （UnixとLinuxのみ）複数の変数データディレクトリを使用している場合は、データベースセットアップを実行するSharePlexインスタンスの変数データディレクトリを指す環境変数をエクスポートします。

   kshシェル:

   export SP_SYS_VARDIR=/full_path_of_variable-data_directory

   cshシェル:

   setenv SP_SYS_VARDIR=/full_path_of_variable-data_directory

2. SP_OCT_OLOG_USE_OCIパラメーターを1に設定し、Captureプロセスを再開します。
3. sp_copを含む、すべての実行中のSharePlexプロセスをシャットダウンします。

4. オペレーティングシステムのコマンドプロンプトから、SharePlexbinサブディレクトリのフルパスを使用してデータベース・セットアップ・プログラムを実行します。

5. SharePlexの設定で、システムがソースシステムであるか、ターゲットシステムであるか、あるいはソースシステムとターゲットシステムの両方であるかを指定します。

   注意: このプロンプトは、このデータベースセットアップを最初に実行したときにのみ表示されます。

6. 接続タイプにはOracleを選択します。
7. 希望する接続のタイプに合わせてSharePlexを適切に設定するためのプロンプトと応答については、以下の表を参照してください。

表9: セットアップのプロンプトと対応

注意: ora_cleanspユーティリティを実行しているときに、ora_setupの実行時に提供されたTNSエイリアスを入力します。

サイレントモードでのOracleのデータベースセットアップの実行

重要! この手順を実行する前に、Oracleインスタンスをオープンしておく必要があります。

サイレントモードでOracleのデータベースセットアップを行うには、 以下の手順を実行します。

1. （UnixとLinuxのみ）複数の変数データディレクトリを使用している場合は、データベースセットアップを実行しているSharePlexインスタンスの変数データディレクトリを指す環境変数をエクスポートします。

   kshシェル:

   export SP_SYS_VARDIR=/full_path_of_variable-data_directory

   cshシェル:

   setenv SP_SYS_VARDIR=/full_path_of_variable-data_directory

2. sp_copを含む、すべての実行中のSharePlexプロセスをシャットダウンします。

3. Ora_setupをバックグラウンドでサイレントモードで実行するには、以下のコマンドを使用します。-
   nohup ./ora_setup -f <Full_file_path of ora_setup.config> > SilentOra.out 2>&1
4. Ora_setup.configファイルの設定方法の詳細については、以下の場所にあるora_setup.configファイルを参照してください。
   /<product directory>/install/ora_setup.config

注意: セットアップが正常に完了すると、セキュリティ上の理由から、すべてのパスワードフィールドが設定ファイルから自動的に削除されます。

• 11.4より前のバージョンのSnowflakeセットアップユーティリティを使用しているユーザは、まず以下のクリーンアップ手順を実行してください。

  1. 所有者ロールを使用して、Snowflakeアカウントからロール「SHAREPLEX_ROLE」を削除します。例えば、「SHAREPLEX_ROLE」が「ACCOUNTADMIN」ロールを持つユーザを使用して作成された場合、同じ権限を使用して以下のクエリを実行します。

     drop role "SHAREPLEX_ROLE";

  2. ターゲットDB.SCHEMAからテーブル「SHAREPLEX_OPEN_TRANS」を削除します。以下のクエリを参照してください。

     drop table SHAREPLEX_OPEN_TRANS;

     以下のガイドラインに従って、今すぐSnowflakeセットアップユーティリティを再実行します。「SHAREPLEX_ROLE」が「USERADMINロール」を使用してセットアップによって正しく再作成されます。

• ODBCディレクトリのDSNを（パスワード認証またはRSA認証に対する）要件に応じて設定します。

• SharePlexが使用しているウェアハウス名をodbc.iniファイルに入力します。詳しくは、「使用ガイドライン」セクションを参照してください。

• SharePlexのセットアップには操作する管理者ユーザが1人必要です。以下のクエリを参考にしてください。以下のクエリで示す通り、管理者ユーザを作成します。
  create user <user_name> identified by '<user_password>';

• SYSADMINおよびUSERADMINロールを管理者ユーザに付与します。
  grant role SYSADMIN to user <user_name>;
  grant role USERADMIN to user <user_name>;

• Snowflake_setupは内部的にUSERADMINロールを使用して、レプリケーションとユーザ関連タスクで使用する新しいSharePlexロールを作成します。SYSADMINロールは、データベースやウェアハウスへのアクセス権を付与するために使用されます。

• SYSADMINロールに目的のデータベースとウェアハウスへのアクセス権がない場合は、以下のクエリを使用してアクセスできるようにします。

  grant OWNERSHIP on database <database name> to SYSADMIN with grant option;

  grant USAGE on warehouse <warehouse_name> to role SYSADMIN with grant option;

  grant OPERATE on warehouse <warehouse_name> to role SYSADMIN with grant option;

• 必要な権限がSharePlexロール（SHAREPLEX_ROLE）に付与され、入力として指定されたSharePlexユーザに割り当てられます。

概要

Snowflake用データベース・セットアップ・ユーティリティ（snowflake_setup）を使用して、SharePlexをSnowflakeユーザとして確立し、必要なSharePlexデータベースオブジェクトを作成します。

このセットアップユーティリティ:

• 新しいロールSHAREPLEX_ROLEを作成します（存在しない場合）。

• 新しいユーザを作成するか、既存のユーザを使用します。

• SharePlex内部テーブルとオブジェクトの作成

セットアップユーティリティを実行する前に、このトピックの内容をすべて確認することをお勧めします。

使用ガイドライン

• SharePlexレプリケーション設定のターゲットSnowflakeインスタンスでSnowflakeユーティリティを実行します。

• サーバクラスタ内の、SharePlex変数データディレクトリを含む共有ディスクがマウントされているノード上でSnowflake Setupユーティリティを実行します。

• 統合レプリケーションの場合は、各変数データディレクトリでSnowflake Setupユーティリティを実行します。

• DSN（データソース名）を以下のように指定します。

  • DSNが定義されており、それをSharePlex接続に使用する場合は、そのDSNが定義されているODBCファイル（odbc.iniとodbcinst.ini）をSharePlex変数データディレクトリのodbcサブディレクトリにコピーまたはリンクします。これにより、SharePlexプロセスがデータベースに接続する際の接続エラーを防ぐことができます。

  • DSNが定義されていないが、使いたい場合は、odbcサブディレクトリにあるテンプレートファイルで作成することができます。

サンプルのodbc.iniとodbcinst.iniファイルについては、以下の例を参照してください。

パスワードベースの認証におけるODBCファイルのサンプル:

RSAベースの認証に使用するODBCファイルのサンプル:

SharePlexに付与される権限

データベース・セットアップ・ユーティリティは、SHAREPLEX_ROLEを作成し、SharePlexユーザに割り当てます。SharePlexはSharePlex_roleに以下の権限を割り当てます。

Snowflakeのデータベースセットアップを実行する

重要! この手順を実行する前に、Snowflakeインスタンスをオープンしておく必要があります。

以下の手順を実行して、Snowflakeのデータベースセットアップを実行します。

1. （UnixとLinuxのみ）複数の変数データディレクトリを使用している場合は、データベースセットアップを実行しているSharePlex

   kshシェル:

   export SP_SYS_VARDIR=/full_path_of_variable-data_directory

   cshシェル:

   setenv SP_SYS_VARDIR=/full_path_of_variable-data_directory

2. sp_copを含む、すべての実行中のSharePlexプロセスをシャットダウンします。

3. パスワードまたはRSAベースの管理者ユーザを使用して、SnowflakeデータベースSetupコマンド（./snowflake_setup）を実行します。
   

4. 希望する接続のタイプに合わせてSharePlexを適切に設定するためのプロンプトと応答については、以下の表を参照してください。

表11: パスワードベースの認証の設定プロンプトと応答

正常にセットアップされると、次のようなメッセージで終了します:

Completed SharePlex for Snowflake database configuration

SharePlex user name: amore2

Database name: SHAREPLEX_TEST

- - The datasource identifier in the SharePlex configuration is 'r.SHAREPLEX_TEST' - -

表12: RSA認証の設定プロンプトと応答

正常にセットアップされると、次のようなメッセージで終了します:

Completed SharePlex for Snowflake database configuration

SharePlex user name: amore2

Database name: PROVIDENCE

- - The datasource identifier in the SharePlex configuration is 'r.SHAREPLEX_TEST' - -