# 前提条件

データのランディングまたはレプリケートをする前に、次の前提条件を満たすようにします。

* Data Movement gateway サーバーに、必要な driver をインストールする

  情報メモ

  これは、Data Movement gateway を使用することを選択した場合のみ必要です。Data Movement gateway の利点と必要なタイミングについては、[Qlik データ ゲートウェイ - データ移動](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm) を参照してください。

* データ ソースに必要な権限を付与する

* データ ソースのコネクタを構成する

## ドライバーのセットアップ

driver のインストールは、ドライバー インストール ユーティリティを使用する (推奨) か、手動で実行できます。手動インストールは、ドライバー インストール ユーティリティで問題が発生した場合にのみ実行するようにしてください。

### ドライバー インストール ユーティリティを使用したドライバーのインストール

このセクションでは、必要な driver のインストール方法を説明しました。このプロセスでは、必要な driver を自動的にダウンロード、インストール、設定するスクリプトを実行します。また、必要に応じて driver の更新やアンインストールを行うスクリプトを実行することもできます。

### インストールの準備

* データ移動 ゲートウェイ サーバーに Python 3.6.x 以降 がインストールされていることを確認します。

  Python は、ほとんどの Linux 配布に前もってインストールされています。お使いのシステムにインストールされている Python のバージョンは、次のコマンドを実行することで確認できます。

  python3 --version

### driver のインストール

driver をダウンロードしてインストールするには:

1. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

   opt/qlik/gateway/movement/drivers/bin

2. 次のコマンドを実行します:

   構文:

   ./install oracle

   アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、install oracle コマンドを再度実行します。

   それ以外の場合は、driver の EULA が表示されます。

3. 次のいずれかを実行します。

   * 何度も [Enter] を押すと、EULA 全体をスクロールできます。
   * 何度もスペースバーを押すと、EULA 全体をスピーディにスクロールできます。
   * q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。

4. 次のいずれかを実行します。

   * 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。

   * 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。

   * 「v」を入力して [Enter] を押すと、EULA が再表示されます。

   driver がインストールされます。

### driver の更新

提供された driver をインストールする前に前のバージョンの driver をアンインストールしたい場合は、更新コマンドを実行します。

driver をダウンロードして更新するには:

1. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

   opt/qlik/gateway/movement/drivers/bin

2. 次のコマンドを実行します:

   構文:

   ./update oracle

   アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、update oracle コマンドを再度実行します。

   それ以外の場合は、driver の EULA が表示されます。

3. 次のいずれかを実行します。

   * 何度も [Enter] を押すと、EULA 全体をスクロールできます。
   * 何度もスペースバーを押すと、EULA 全体をスピーディにスクロールできます。
   * q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。

4. 次のいずれかを実行します。

   * 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
   * 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。
   * 「v」を入力して [Enter] を押すと、最初から EULA をレビューできます。

   古い driver がアンインストールされ、新しい driver がインストールされます。

### driver のアンインストール

driver をアンインストールする場合は、アンインストール コマンドを実行します。

driver をアンインストールするには:

1. このコネクタを使用するように構成されているすべてのタスクを停止します。

2. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

   opt/qlik/gateway/movement/drivers/bin

3. 次のコマンドを実行します:

   構文:

   ./uninstall oracle

   driver がアンインストールされます。

### ドライバーの手動インストール

自動ドライバーのインストールが正常に完了しなかった場合にのみ、driver を手動でインストールするようにしてください。

Data Movement gateway がインストールされたら、oracle-instantclient-basiclite-<version>.x86\_64.rpm ドライバーをダウンロードします。サポートされているバージョンへの直接ダウンロード リンクは、/opt/qlik/gateway/movement/drivers/manifests/oracle.yaml の binary-artifacts にあります。ダウンロードが完了したら、RPM を Data Movement gateway マシンにコピーします。

次に、Data Movement gateway サーバーで、シェル プロンプトを開き、次の手順を実行します。

1. Data Movement gateway サービスを停止します。

   sudo systemctl stop repagent

2. オプションで、サービスが停止されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: inactive (dead) since <timestamp> ago

3. ドライバー (RPM) をインストールします。

4. さらに、システムにまだ含まれていない場合は、`$Oracle_Home\lib` ディレクトリにシンボリック リンクを作成します。リンクに `libclntsh.so`という名前を付け、このファイルの特定のバージョンを指定します。

   例:

   lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1

5. 作業ディレクトリを <Data Movement gateway-Install-Dir>/bin に変更し、ドライバーの場所を `site_arep_login.sh` ファイルにコピーして、`LD_LIBRARY_PATH` 環境変数を Oracle Instant Client ディレクトリおよび Data Movement gatewaylib ディレクトリに追加します。

   echo "export LD\_LIBRARY\_PATH=\$LD\_LIBRARY\_PATH:/opt/oracle/instantclient\_<version>:/opt/qlik/gateway/movement/lib/" >> site\_arep\_login.sh

6. 必要に応じて、ドライバーの場所がコピーされていることを確認します。

   ```
   cat site_arep_login.sh
                           
   ```

7. Data Movement gateway サービスを起動します。

   sudo systemctl start repagent

8. オプションで、サービスが開始されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: active (running) since <timestamp> ago

## Oracle アカウントへのアクセスの提供

Oracle アカウントへのアクセスを Data Movement gateway のユーザーに提供する必要があります。このユーザーには、Oracle データベースに対する読み取り/書き込みの権限が必要です。Oracle アカウントへのアクセス設定の詳細については、「[必要な権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/OracleDBSource_Security.htm)」を参照してください。

## ARCHIVELOG モードがオンになっていることの確認

Oracle は、`ARCHIVELOG` モードと `NOARCHIVELOG` モードの 2 つの異なるモードで実行できます。Data Movement gateway で Oracle ログを使用するには、データベースを `ARCHIVELOG` モードで実行します。ログが `ARCHIVELOG` モードに設定されていない場合は、次のクエリを実行します。

`ALTER database ARCHIVELOG`

Oracle データベース インスタンスが Amazon RDS 上にある場合は、別のコマンドを実行する必要があります。詳しくは「[自動バックアップの有効化](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/oracle_rds_prerequisites.htm#Enabling)」と「[アーカイブの設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/oracle_rds_prerequisites.htm#ar_oracleds_385117211_chdddeji)」を参照してください

## サプリメンタル ロギングの設定

データベース レベルとテーブル レベルの両方で、Oracle データベースのサプリメンタル ロギングを有効にする必要があります。

情報メモ

Oracle スタンバイ環境から 移動 する場合は、スタンバイ インスタンスではなく、プライマリ Oracle インスタンス (以下で説明) でサプリメンタル ロギングを設定する必要があります。

### データベース レベルでのサプリメンタル ロギングの確認と有効化

1. 次のクエリを実行します。

   SELECT name, value, description FROM v$parameter WHERE name = 'compatible';

   返される結果は ` GE to  ``n``.``n``.``n` からのものである必要があります。ここでは、`n``.``n``.``n` は Oracle データベースのバージョン (例: 10.0.0) です。

   警告メモ

   パラメーター値がデータベースの実際のバージョンと一致する必要があります。

2. 次のクエリを実行します。

   SELECT supplemental\_log\_data\_min FROM v$database;

   返される結果は YES または IMPLICIT になります。

   次のクエリを実行して、サプリメンタル ロギングを有効にします。

   ALTER DATABASE ADD SUPPLEMENTAL LOG DATA

   情報メモ

   Oracle データベース インスタンスが Amazon RDS 上にある場合は、別のコマンドを実行する必要があります。詳細については、「[Amazon RDS for Oracle の使用](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/oracle_rds_prerequisites.htm)」を参照してください。

### テーブル レベルでのサプリメンタル ロギングの確認と有効化

1. サプリメンタル ロギングがテーブル レベルで有効になっているかどうかを確認するには、次のクエリを実行します。

   構文：

   select count(\*) from ALL\_LOG\_GROUPS where LOG\_GROUP\_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE\_NAME='TABLE-NAME';

   例:

   select count(\*) from ALL\_LOG\_GROUPS where LOG\_GROUP\_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE\_NAME='EMPLOYEES';

2. サプリメンタル ロギングをテーブル レベルで有効にするには、次のクエリを実行します。

   構文：

   ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

   例:

   ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

参照先: [必要な権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/OracleDBSource_Security.htm)