Requisitos previos

La siguiente sección describe los requisitos previos para trabajar con el conector IBM DB2 para LUW.

Antes de poder obtener o replicar datos, asegúrese de cumplir los siguientes requisitos previos:

• Instale el driver requerido en el servidor de la pasarela de movimiento de datos

• Otorgue los permisos necesarios en la fuente de datos

• Configure el conector de la fuente de datos

Configuración del driver o controlador

Puede instalar el driver usando la utilidad de instalación del driver (recomendado) o manualmente. La instalación manual solo debe intentarse en el improbable caso de que encuentre un problema con la utilidad de instalación del driver.

Uso de la utilidad de instalación del driver para instalar el driver/controlador

Esta sección describe cómo instalar el driver necesario. El proceso implica descargar el driver, copiarlo en la carpeta requerida (ver a continuación) y ejecutar un script que lo instalará y configurará automáticamente. También puede ejecutar secuencias de script para actualizar y desinstalar el driver según sea necesario.

Preparar la instalación

• Asegúrese de que Python 3.6 o posterior esté instalado en el servidor de la pasarela de Movimiento de datos.

  Python viene preinstalado en la mayoría de las distribuciones de Linux. Puede verificar qué versión de Python está instalada en su sistema ejecutando el siguiente comando:

  python3 --version

• Descargue el cliente IBM Data Server "<versión>_linuxx64_client.tar.gz" del sitio web de IBM. Puede encontrar la versión compatible en binary-artifacts, en /opt/qlik/gateway/movement/drivers/manifests/db2.yaml. Una vez que se haya completado la descarga, copie el archivo en:

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

Instalar el paquete de visualización driver

Para el driver:

1. Detenga el servicio Data Movement gateway:

   sudo systemctl stop repagent

2. Opcionalmente, confirme que el servicio se ha detenido:

   sudo systemctl status repagent

   El estado debería ser el siguiente:

   Active: inactive (dead) since <timestamp> ago

3. En la máquina de la puerta de enlace de Movimiento de datos, cambie el directorio de trabajo a:

   opt/qlik/gateway/movement/drivers/bin

4. Ejecute el siguiente comando:

   Sintaxis:

   ./install db2

   De lo contrario, se mostrará el EULA del driver.

5. Puede realizar una de las acciones siguientes:

   • Pulse [Intro] repetidamente para desplazarse por el EULA.
   • Pulse la barra espaciadora repetidamente para desplazarse rápidamente por el EULA.
   • Pulse q para salir del texto de la licencia y ver las opciones de aceptación del EULA.

6. Puede realizar una de las acciones siguientes:

   • Escriba "y" y pulse [Intro] para aceptar el EULA y comenzar la instalación.
   • Escriba "n" y pulse [Intro] para rechazar el EULA y salir de la instalación.

   • Escriba "v" y pulse [Intro] para ver el EULA de nuevo.

Se instalará el driver.

7. Espere a que termine la instalación (indicado mediante la palabra "Completado") y luego inicie el servicio de Data Movement gateway:

   sudo systemctl start repagent

8. Opcionalmente, confirme que el servicio se ha iniciado:

   sudo systemctl status repagent

   El estado debería ser el siguiente:

   Active: active (running) since <timestamp> ago

Actualizar el driver

Ejecute el comando de actualización si desea desinstalar versiones anteriores del driver antes de instalar el driver provisto.

Para el driver:

1. Detenga el servicio Data Movement gateway:

   sudo systemctl stop repagent

2. Opcionalmente, confirme que el servicio se ha detenido:

   sudo systemctl status repagent

   El estado debería ser el siguiente:

   Active: inactive (dead) since <timestamp> ago

3. En la máquina de la puerta de enlace de Movimiento de datos, cambie el directorio de trabajo a:

   opt/qlik/gateway/movement/drivers/bin

4. Ejecute el siguiente comando:

   Sintaxis:

   ./update db2

   De lo contrario, se mostrará el EULA del driver.

5. Puede realizar una de las acciones siguientes:

   • Pulse [Intro] repetidamente para desplazarse por el EULA.
   • Pulse la barra espaciadora repetidamente para desplazarse rápidamente por el EULA.
   • Pulse q para salir del texto de la licencia y ver las opciones de aceptación del EULA.

6. Puede realizar una de las acciones siguientes:

   • Escriba "y" y pulse [Intro] para aceptar el EULA y comenzar la instalación.
   • Escriba "n" y pulse [Intro] para rechazar el EULA y salir de la instalación.
   • Escriba "v" y pulse [Intro] para ver el EULA desde el principio.

El driver anterior se desinstalará y se instalará el nuevo driver.

7. Espere a que termine la instalación (indicado mediante la palabra "Completado") y luego inicie el servicio de Data Movement gateway:

   sudo systemctl start repagent

8. Opcionalmente, confirme que el servicio se ha iniciado:

   sudo systemctl status repagent

   El estado debería ser el siguiente:

   Active: active (running) since <timestamp> ago

Desinstalar el driver

Ejecute el comando de desinstalación si desea desinstalar el driver.

Para desinstalar el driver:

1. Detenga todas las tareas configuradas para utilizar este conector.

2. En la máquina de la pasarela de Movimiento de datos, cambie el directorio de trabajo a:

   opt/qlik/gateway/movement/drivers/bin

3. Ejecute el siguiente comando:

   Sintaxis:

   ./uninstall db2

   Se desinstalará el driver.

Instalar el controlador manualmente

Solo debe intentar instalar el driver manualmente si la instalación automática del driver no se realizó correctamente.

En la máquina de Data Movement gateway, abra un indicador en la línea de comandos y haga lo siguiente:

1. Detenga el servicio Data Movement gateway:

   sudo systemctl stop repagent

2. Opcionalmente, confirme que el servicio se ha detenido:

   sudo systemctl status repagent

   El estado debería ser el siguiente:

   Active: inactive (dead) since <timestamp> ago

3. Instale IBM Data Client v11.5.8_linuxx64_server_t.tar.gz; seleccione instalar “CLIENT”.

4. Si la máquina de Data Movement gateway no tiene una instancia de DB2, cree una instancia de DB2 ejecutando los siguientes comandos:

   adduser <db2_instance_name>

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

5. Agregue la ubicación del controlador DB2 a la ruta de la biblioteca de Linux.

   Para ello, agregue la línea siguiente al archivo site_ arep_login.sh de la siguiente manera:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

   donde path es la ruta del CLIENTE al controlador.

   Ejemplo (con db2clnt1 como nombre de instancia):

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

   export DB2INSTANCE=db2clnt1

6. Cree un nuevo archivo llamado odbcinst.ini en /etc y agregue la siguiente entrada:

   [IBM DB2 ODBC DRIVER]

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

   fileusage=1

   dontdlclose=1

7. Inicie el servicio Data Movement gateway:

   sudo systemctl start repagent

8. Opcionalmente, confirme que el servicio se ha iniciado:

   sudo systemctl status repagent

   El estado debería ser el siguiente:

   Active: active (running) since <timestamp> ago

9. Defina la configuración de la conexión de IBM DB2 para LUW como se describe en IBM DB2 para LUW y haga clic en Probar conexión.

   Si obtiene el siguiente error:

   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. Ejecute el siguiente comando:

      /opt/ibm/db2/V11.5/bin /db2cli writecfg add -database <db_name_from_conector_connection_settings> -host <server_name_from_conector_connection_settings> -port <port_from_conector_connection_settings>

   2. Cambie al directorio bin de Data Movement gateway (<install_dir>/bin). Después, detenga e inicie el servicio Data Movement gateway como se describe arriba.

Habilitar CDC en la base de datos

Para habilitar CDC (Change Data Capture):

• Set the database to be recoverable: Para capturar cambios, Data Movement gateway requiere que la base de datos esté configurada como recuperable. Una base de datos es recuperable si uno o ambos parámetros de configuración de la base de datos, LOGARCHMETH1 y LOGARCHMETH2, no están desactivados.

• Permissions: el usuario de Qlik debe recibir los siguientes permisos:

  • SYSADM o DBADM

  • DATAACCESS

• Para habilitar la captura de datos desde IBM DB2 para LUW, las tablas de origen deben crearse de la siguiente manera:

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

  Puede, o bien configurar Data Movement gateway para que realice esta operación seleccionando Automatically enable DATA CAPTURE CHANGES (requiere privilegios de admin) en las opciones de configuración de conector, o bien puede hacer esto manualmente.