Предварительные требования

Перед промежуточным сохранением или репликацией данных необходимо выполнить следующие предварительные требования:

• Установите необходимый driver на сервере со шлюзом движения данных

• Предоставьте необходимые разрешения в источнике данных

• Настройка коннектора источника данных

Настройка драйвера

driver можно установить с помощью программы для установки драйверов (рекомендуется) или вручную. Ручную установку следует выполнять только в том маловероятном случае, если возникла проблема с программой для установки драйверов.

Использование программы для установки драйверов для установки драйвера

В этом разделе описывается процедура установки необходимого driverа. Она включает загрузку driverа, копирование его в нужную папку (см. ниже) и выполнение скрипта, который автоматически установит и настроит его. Также можно выполнять скрипты для обновления и удаления driverа по необходимости.

Подготовка к установке

• Убедитесь, что на сервере шлюза Перемещение данных установлена версия Python 3.6 или более поздняя.

  Python предустанавливается в большинстве дистрибутивов Linux. Чтобы проверить, какая версия Python установлена в системе, выполните следующую команду:

  python3 --version

• Загрузите пакет IBM i Access Client Solutions Linux Application Package «ibm-iaccess-<версия>.x86_64.rpm» с веб-сайта IBM. Поддерживаемую версию можно найти в разделе binary-artifacts в /opt/qlik/gateway/movement/drivers/manifests/db2iseries.yaml. После завершения загрузки скопируйте файл в:

  /opt/qlik/gateway/movement/drivers/db2i

Установка driver

Чтобы установить driver, выполните следующие действия.

1. На компьютере шлюза Перемещение данных измените рабочую папку на:

   opt/qlik/gateway/movement/drivers/bin

2. Выполните следующую команду:

   Синтаксис:

   ./install db2iseries

   В противном случае откроется лицензионное соглашение с конечным пользователем driverа.

3. Выполните одно из следующих действий:

   • Нажмите клавишу [Enter] несколько раз, чтобы медленно прокрутить лицензионное соглашение.
   • Нажимайте клавишу «Пробел» несколько раз, чтобы быстро прокрутить лицензионное соглашение.
   • Нажмите клавишу «q», чтобы закрыть текст лицензионного соглашения и перейти к шагу принятия/отклонения.

4. Затем выполните одно из следующих действий:

   • Введите «y» и нажмите клавишу [Enter], чтобы принять лицензионное соглашение и запустить установку.
   • Введите «n» и нажмите клавишу [Enter], чтобы отклонить лицензионное соглашение и отменить установку.

   • Введите «v» и нажмите клавишу [Enter], чтобы снова открыть лицензионное соглашение для просмотра.

Будет установлен driver.

Обновление driverа

Выполните команду обновления, если требуется удалить предыдущие версии driverа перед установкой предоставленной версии driverа.

Чтобы обновить driver, выполните следующие действия.

1. На компьютере шлюза Перемещение данных измените рабочую папку на:

   opt/qlik/gateway/movement/drivers/bin

2. Выполните следующую команду:

   Синтаксис:

   ./update db2iseries

   В противном случае откроется лицензионное соглашение с конечным пользователем driverа.

3. Выполните одно из следующих действий:

   • Нажмите клавишу [Enter] несколько раз, чтобы медленно прокрутить лицензионное соглашение.
   • Нажимайте клавишу «Пробел» несколько раз, чтобы быстро прокрутить лицензионное соглашение.
   • Нажмите клавишу «q», чтобы закрыть текст лицензионного соглашения и перейти к шагу принятия/отклонения.

4. Затем выполните одно из следующих действий:

   • Введите «y» и нажмите клавишу [Enter], чтобы принять лицензионное соглашение и запустить установку.
   • Введите «n» и нажмите клавишу [Enter], чтобы отклонить лицензионное соглашение и отменить установку.
   • Введите «v» и нажмите клавишу [Enter], чтобы снова просмотреть лицензионное соглашение от начала.

Будет удален старый driver и установлен новый driver.

Удаление driverа

Выполните команду удаления, если требуется удалить driver.

Чтобы удалить driver, выполните следующие действия.

1. Остановите все задачи, использующие данный коннектор.

2. На компьютере шлюза Перемещение данных измените рабочую папку на:

   opt/qlik/gateway/movement/drivers/bin

3. Выполните следующую команду:

   Синтаксис:

   ./uninstall db2iseries

   driver будет удален.

Ручная настройка драйвера

Установку driver вручную следует пытаться выполнить только в том случае, если автоматическая установка драйвера не завершилась успешно.

Загрузите пакет IBM i Access Client Solutions Linux Application Package с веб-сайта IBM.

Для получения дополнительной информации см. страницу https://www.ibm.com/docs/en/i/7.2?topic=packages-linux-application-package

Затем на машине Data Movement Gateway откройте приглашение оболочки и выполните действия, указанные ниже.

1. Остановите службу Data Movement Gateway:

   sudo systemctl stop repagent

2. При необходимости подтвердите, что служба остановлена.

   sudo systemctl status repagent

   Статус должен быть следующим:

   Active: inactive (dead) since <timestamp> ago

3. Установите RPM из загруженного пакета.

   Пример:

   rpm -i ibm-iaccess-1.1.0.26-1.0.x86_64

   Примечание к информации

   Отображаемая версия драйвера будет отличаться в журналах Data Movement Gateway. Например, предположим, что версия драйвера такая же, как в приведенном выше примере, в журналах Data Movement Gateway она будет отображаться как версия драйвера ODBC: '07.01.026'.

   Для получения информации о просмотре журналов см. Устранение неполадок с задачами данных.

4. Замените рабочую папку на <Data Movement Gateway_Install_Dir>/bin.

5. Добавьте местоположение драйвера DB2 в путь к библиотеке Linux.

   Для этого добавьте следующий путь к файлу site_ arep_login.sh следующую строку <install_dir>/replicate/bin:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib64

   где path — это путь к драйверу.

   Пример:

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/ibm/iaccess/lib64" >> site_arep_login.sh

6. При необходимости подтвердите, что местоположение драйвера было скопировано:

   cat site_arep_login.sh

7. После завершения установки откройте файл /etc/odbcinst.ini и убедитесь, что он содержит следующий раздел:

   [IBM i Access ODBC Driver 64-bit]
   Description = IBM i Access for Linux 64-bit ODBC Driver Driver = /opt/ibm/iaccess/lib64/libcwbodbc.so Setup = /opt/ibm/iaccess/lib64/libcwbodbcs.so Threading = 0 DontDLClose = 1 UsageCount = 1

8. Запустите службу Data Movement Gateway.

   sudo systemctl start repagent

9. При необходимости подтвердите, что служба запущена.

   sudo systemctl status repagent

   Статус должен быть следующим:

   Active: active (running) since <timestamp> ago

Предварительные требования для CDC

Предварительные требования для журнала

Все исходные таблицы для конкретной задачи промежуточное хранение должны вноситься в один и тот же журнал. Имена журнала и библиотеки, в которой он находится, должны быть указаны в настройках конечной точки коннектор. В ходе выполнения задачи Data Movement Gateway опрашивает этот журнал на наличие изменений в исходных таблицах.

Когда запускается ведение журнала исходных таблиц, параметру Record images можно задать значение *BOTH (для захвата образов до и после) или *AFTER.

Когда параметру Record images задано значение *AFTER, удаленные записи будут содержать значения NULL в соответствующих полях данных. Чтобы сохранить копию удаленной записи в журнале удаленных записей, необходимо задать параметру Record images значение *BOTH.

Параметр MINENTDTA

Параметру MINENTDTA необходимо задать значение *NONE, так как *FILE (минимальное ведение журнала) не поддерживается.