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

В следующем разделе описаны предварительные требования для работы с коннектором IBM DB2 for LUW.

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

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

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

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

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

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

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

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

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

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

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

  python3 --version

• Загрузите клиент IBM Data Server Client «<версия>_linuxx64_client.tar.gz» с веб-сайта IBM. Поддерживаемую версию можно найти в разделе binary-artifacts в /opt/qlik/gateway/movement/drivers/manifests/db2.yaml. После завершения загрузки скопируйте файл в:

  /opt/qlik/gateway/movement/drivers/db2

Установка driver

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

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

   sudo systemctl stop repagent

2. Если нужно, подтвердите, что служба остановлена:

   sudo systemctl status repagent

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

   Active: inactive (dead) since <timestamp> ago

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

   opt/qlik/gateway/movement/drivers/bin

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

   Синтаксис:

   ./install db2

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

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

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

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

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

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

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

7. Дождитесь завершения установки (появится сообщение «Завершено!»), а затем запустите службу Data Movement Gateway:

   sudo systemctl start repagent

8. Если нужно, подтвердите, что сервис запущен:

   sudo systemctl status repagent

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

   Active: active (running) since <timestamp> ago

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

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

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

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

   sudo systemctl stop repagent

2. Если нужно, подтвердите, что служба остановлена:

   sudo systemctl status repagent

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

   Active: inactive (dead) since <timestamp> ago

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

   opt/qlik/gateway/movement/drivers/bin

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

   Синтаксис:

   ./update db2

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

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

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

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

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

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

7. Дождитесь завершения установки (появится сообщение «Завершено!»), а затем запустите службу Data Movement Gateway:

   sudo systemctl start repagent

8. Если нужно, подтвердите, что сервис запущен:

   sudo systemctl status repagent

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

   Active: active (running) since <timestamp> ago

Удаление driverа

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

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

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

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

   opt/qlik/gateway/movement/drivers/bin

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

   Синтаксис:

   ./uninstall db2

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

Установка драйвера вручную

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

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

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

   sudo systemctl stop repagent

2. Если нужно, подтвердите, что сервис остановлен:

   sudo systemctl status repagent

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

   Active: inactive (dead) since <timestamp> ago

3. Установите файл IBM Data Client v11.5.8_linuxx64_server_t.tar.gz; выберите вариант установки «CLIENT».

4. Если на сервере Data Movement Gateway отсутствует экземпляр DB2, создайте экземпляр DB2, выполнив следующие команды:

   adduser <db2_instance_name>

   /opt/ibm/db2/V11.5/instance/db2icrt <db2_instance_name>

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

   Для этого добавьте в файл site_ arep_login.sh следующую строку:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

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

   Пример (с именем экземпляра db2clnt1):

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/db2clnt1/sqllib/lib:/home/db2clnt1/sqllib/lib64/gskit

   export DB2INSTANCE=db2clnt1

6. Создайте новый файл с именем odbcinst.ini в папке /etc и добавьте следующую запись:

   [IBM DB2 ODBC DRIVER]

   Driver = /home/db2clnt1/sqllib/lib/libdb2o.so

   fileusage=1

   dontdlclose=1

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

   sudo systemctl start repagent

8. Если нужно, подтвердите, что сервис запущен:

   sudo systemctl status repagent

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

   Active: active (running) since <timestamp> ago

9. Задайте настройки подключения IBM DB2 for LUW, как описано в разделе IBM DB2 for LUW, и нажмите Test Connection.

   Если отображается следующая ошибка:

   Cannot connect to DB2 LUW Server ODBC unknown error.

   RetCode: SQL_ERROR SqlState: NativeError: -1390 Message: [unixODBC][IBM][CLI Driver] SQL10007N Message "0" could not be retrieved. Reason code: "3". ODBC general error.

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

      /opt/ibm/db2/V11.5/bin /db2cli writecfg add -database <db_name_from_коннектор_connection_settings> -host <server_name_from_коннектор_connection_settings> -port <port_from_коннектор_connection_settings>

   2. Замените на каталог Data Movement Gatewaybin (<install_dir>/bin). Затем остановите и вновь запустите сервис Data Movement Gateway, как описано выше.

Включение CDC в базе данных

Чтобы включить CDC (захват данных изменений), выполните следующие действия.

• Настройте базу данных как восстановимую. Для захвата изменений в Data Movement Gateway требуется настроить базу данных как восстановимую. База данных является восстановимой, если одному из параметров конфигурации или обоим (LOGARCHMETH1 и LOGARCHMETH2) не задано значение OFF (ВЫКЛ).

• Разрешения. Пользователю Qlik необходимо предоставить следующие разрешения:

  • SYSADM или DBADM

  • DATAACCESS

• Чтобы включить захват данных из IBM DB2 для LUW, необходимо создать исходные таблицы следующим образом:

  CREATE / ALTER TABLE table-name …. DATA CAPTURE CHANGES [INCLUDE LONGVAR COLUMNS];

  Можно настроить Data Movement Gateway для выполнения этой операции, выбрав параметр Автоматически включать DATA CAPTURE CHANGES (требуются права администратора) в настройках коннектор, или сделать это вручную.