Перейти к основному содержимому Перейти к дополнительному содержимому
Ресурсы Qlik

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

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

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

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

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

Установка продукта R4Z на платформе z/OS

Чтобы обеспечить возможность работы с источником IBM DB2 for z/OS, необходимо сначала установить и настроить продукт R4Z на платформе z/OS.

  1. Перейти к Загружаемые файлы продукта.

  2. Выберите Qlik Data Integration.

  3. Прокрутите список Продукты вниз и выберите Интеграция данных Qlik Cloud.

  4. В столбце Ссылка для загрузки щелкните ссылку QlikReplicate_2023.5.0.191_r4z.zip, чтобы запустить загрузку.

  5. Загрузите R4Z и установите пакет на источник данных z/OS.

Для получения инструкций по установке и настройке см. Установка и настройка R4Z.

Установка и настройка драйвера

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], чтобы снова открыть лицензионное соглашение для просмотра.

    7. Будет установлен 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], чтобы снова просмотреть лицензионное соглашение от начала.

    7. Будет удален старый 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 вручную следует пытаться выполнить только в том случае, если автоматическая установка драйвера не завершилась успешно.

Пакет клиента Linux ODBC

По выбору можно установить полный пакет клиента ODBC или только клиент сервера данных, как описано в разделе Клиент сервера данных Linux ниже.

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

Параметр драйвера «enableWLB» не поддерживается. Чтобы подключение автоматически переключалось на другой логический раздел в Parallel Sysplex (т. е. «восстановление после отказа»), задайте в конфигурации драйвера значение «true» для параметра «enableACR» и значение «false» для параметра «enableWLB».

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

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

    sudo systemctl stop repagent

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

    sudo systemctl status repagent

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

    Active: inactive (dead) since <timestamp> ago

  3. Установите v11.5.8_linuxx64_server_dec.tar.gz и выберите вариант «CLIENT».

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

    adduser <db2_instance_name>

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

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

  6. Добавьте расположение драйвера 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

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

    cat site_arep_login.sh

  8. Добавьте следующую запись в файл odbcinst.ini, расположенный в папке /etc:

    [IBM DB2 ODBC DRIVER]

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

    fileusage=1

    dontdlclose=1

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

    sudo systemctl start repagent

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

    sudo systemctl status repagent

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

    Active: active (running) since <timestamp> ago

Клиент сервера данных Linux

  1. Загрузите v11.5.8_linuxx64_client.tar.gz из центра исправлений IBM Fix Central и извлеките файлы.

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

    sudo service repagent stop

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

    sudo service repagent status

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

    Active: inactive (dead) since <timestamp> ago

  4. Измените рабочий каталог на /opt/client и запустите db2_install.

  5. Создайте файл RSP (см. Образец файла RSP ниже), затем выполните следующую команду (из /opt/client):

    ./db2setup -r /file-path/client.rsp

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

    [IBM DB2 ODBC DRIVER]

    Driver = /opt/ibm/db2/V11.5/lib64/libdb2o.so

    fileusage=1

    dontdlclose=1

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

    sudo service repagent start

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

    sudo service repagent status

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

    Active: active (running) since <timestamp> ago

Образец файла RSP

*-----------------------------------------------------
* Generated response file used by the DB2 Setup wizard
* generation time: 2/18/22 4:10 PM
*-----------------------------------------------------
*  Product Installation
LIC_AGREEMENT       = ACCEPT
PROD       = CLIENT
FILE       = /opt/ibm/db2/V11.5
INSTALL_TYPE       = TYPICAL
* ----------------------------------------------
*  Instance properties
* ----------------------------------------------
INSTANCE       = inst1
inst1.TYPE       = client
*  Instance-owning user
inst1.NAME       = qlik
inst1.UID       = 1000
inst1.GROUP_NAME       = qlik
inst1.HOME_DIRECTORY       = /home/qlik
inst1.AUTOSTART       = NO
*-----------------------------------------------
*  Installed Languages
*-----------------------------------------------
LANG       = EN

Настройка серверной части ODBC

Привяжите план, который должен использоваться для ODBC, в соответствии со значением PLANNAME=, заданным в файле инициализации ODBC. Имя по умолчанию — DSNACLI. Задание BIND находится в элементе DSNTIJCL, включенном в библиотеку SDSNSAMP исходной установки DB2.

Используйте команду привязки DB2CLI (bind), чтобы привязать пакеты, предоставленные ODBC, с нужной исходной подсистемой z/OS DB2. Это действие описано в статье Настройка среды разработки и выполнения на веб-сайте IBM. Для получения информации о служебной программе DB2CLI, включая пример утилиты привязки, см. статью Интерактивная команда CLI db2cli — DB2 на веб-сайте IBM.

Необходимые разрешения

Чтобы позволить Data Movement Gateway извлекать данные из исходных таблиц (методом полной загрузки или захвата данных изменений (CDC)), указанному в параметрах IBM DB2 for z/OS пользователю должны быть предоставлены следующие разрешения:

  • EXECUTE в IFI, считывающего UDTF (требуется только для CDC)
  • SELECT в исходных таблицах и в следующих таблицах каталога системы:
    • SYSIBM.SYSDUMMY1
    • SYSIBM.SYSTABLES
    • SYSIBM.SYSTABLESPACE
    • SYSIBM.SYSPARMS
    • SYSIBM.SYSROUTINES
    • SYSIBM.SYSCOLUMNS
    • SYSIBM.SYSLGRNX
    • SYSIBM.SYSTABLEPART
  • MONITOR2 для запуска сеансов IFI (требуется только для CDC)

Захват изменений данных

Чтобы захватить изменения из IBM DB2 for z/OS, Data Movement Gateway использует специальную программу, вызываемую в качестве внешней подпрограммы, которая является пользовательской табличной функцией (UDTF). Эту программу (модуль загрузки), а также UDTF необходимо установить и настроить в системе z/OS, чтобы обеспечить возможность захвата изменений. Процедура установки, которую должен выполнять администратор базы данных, описана в Установка и настройка R4Z.

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

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!

Оставьте свой отзыв здесь