Ir para conteúdo principal Pular para conteúdo complementar
Recursos da Qilk

Pré-requisitos

Antes de fazer a aterrissagem ou a replicação dos dados, certifique-se de atender aos seguintes pré-requisitos:

  • Instalar o driver necessário no servidor de gateway do Data Movement

  • Conceder as permissões necessárias na fonte de dados

  • Configurar o conector de fontes de dados

Instalar o produto R4Z no z/OS

Antes de trabalhar com uma origem do IBM DB2 for z/OS, você deve instalar e configurar o produto R4Z no z/OS.

  1. Ir para o Downloads de produtos.

  2. Selecione Qlik Data Integration.

  3. Role para baixo na lista Produtos e selecione Qlik Cloud Data Integration.

  4. Na coluna Link de download, clique no link QlikReplicate_2023.5.0.191_r4z.zip para iniciar o download.

  5. Baixe o R4Z e instale-o na sua fonte de dados do z/OS.

Para obter instruções de instalação e configuração, consulte Instalando e configurando o R4Z.

Instalando e configurando o driver

Você pode instalar o driver usando o utilitário de instalação do driver (recomendado) ou manualmente. A instalação manual só deve ser tentada no caso improvável de você encontrar um problema com o utilitário de instalação do driver.

Usando o utilitário de instalação de driver para instalar o driver

Esta seção descreve como instalar os driver necessários. O processo envolve o download do driver, sua cópia para a pasta necessária (veja abaixo) e a execução de um script que o instalará e configurará automaticamente. Você também pode executar scripts para atualizar e desinstalar o driver como necessário.

Preparando a instalação

  • Certifique-se de que o Python 3.6.x ou mais recente esteja instalado no servidor de gateway do Movimentação de dados.

    O Python vem pré-instalado na maioria das distribuições do Linux. Você pode verificar qual versão do Python está instalada em seu sistema executando o seguinte comando:

    python3 --version

  • Baixe o arquivo "<versão>_linuxx64_client.tar.gz" do IBM Data Server Client no site da IBM. Você pode encontrar a versão compatível em binary-artifacts em /opt/qlik/gateway/movement/drivers/manifests/db2.yaml. Assim que o download for concluído, copie o arquivo para:

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

Instalando o driver

Para o driver:

  1. Pare o serviço do Gateway Data Movement:

    sudo systemctl stop repagent

  2. Opcionalmente, confirme se o serviço foi interrompido:

    sudo systemctl status repagent

    O status deverá ser o seguinte:

    Active: inactive (dead) since <timestamp> ago

  3. Na máquina do gateway do Movimentação de dados, altere o diretório de trabalho para:

    opt/qlik/gateway/movement/drivers/bin

  4. Execute o seguinte comando:

    Sintaxe:

    ./install db2

    Caso contrário, o EULA do driver será exibido.

  5. Realize uma das seguintes ações:

    • Pressione [Enter] repetidamente para percorrer lentamente o EULA.
    • Pressione a barra de espaço repetidamente para rolar rapidamente pelo EULA.
    • Pressione q para sair do texto da licença e ser apresentado às opções de aceitação do EULA.

  6. Realize uma das seguintes ações:

    • Digite "y" e pressione [Enter] para aceitar o EULA e iniciar a instalação.
    • Digite "n" e pressione [Enter] para rejeitar o EULA e sair da instalação.

    • Digite "v" e pressione [Enter] para visualizar o EULA novamente.

    7. O driver será instalado.

  7. Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:

    sudo systemctl start repagent

  8. Opcionalmente, confirme se o serviço foi iniciado:

    sudo systemctl status repagent

    O status deverá ser o seguinte:

    Active: active (running) since <timestamp> ago

Atualizando o driver

Execute o comando de atualização se quiser desinstalar versões anteriores do driver antes de instalar o driver fornecido.

Para atualizar o driver:

  1. Pare o serviço do Gateway Data Movement:

    sudo systemctl stop repagent

  2. Opcionalmente, confirme se o serviço foi interrompido:

    sudo systemctl status repagent

    O status deverá ser o seguinte:

    Active: inactive (dead) since <timestamp> ago

  3. Na máquina do gateway do Movimentação de dados, altere o diretório de trabalho para:

    opt/qlik/gateway/movement/drivers/bin

  4. Execute o seguinte comando:

    Sintaxe:

    ./update db2

    Caso contrário, o EULA do driver será exibido.

  5. Realize uma das seguintes ações:

    • Pressione [Enter] repetidamente para percorrer lentamente o EULA.
    • Pressione a barra de espaço repetidamente para rolar rapidamente pelo EULA.
    • Pressione q para sair do texto da licença e ser apresentado às opções de aceitação do EULA.

  6. Realize uma das seguintes ações:

    • Digite "y" e pressione [Enter] para aceitar o EULA e iniciar a instalação.
    • Digite "n" e pressione [Enter] para rejeitar o EULA e sair da instalação.
    • Digite "v" e pressione [Enter] para revisar o EULA desde o início.

    7. O driver antigo será desinstalado, e o novo driver será instalado.

  7. Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:

    sudo systemctl start repagent

  8. Opcionalmente, confirme se o serviço foi iniciado:

    sudo systemctl status repagent

    O status deverá ser o seguinte:

    Active: active (running) since <timestamp> ago

Desinstalando o driver

Execute o comando de desinstalação se quiser desinstalar o driver.

Para desinstalar o driver:

  1. Pare todas as tarefas configuradas para usar esse conector.

  2. Na máquina do gateway do Movimentação de dados, altere o diretório de trabalho para:

    opt/qlik/gateway/movement/drivers/bin

  3. Execute o seguinte comando:

    Sintaxe:

    ./uninstall db2

    O driver será desinstalado.

Instalando o driver manualmente

Você só deve tentar instalar o driver manualmente se a instalação automática do driver não for concluída com êxito.

Pacote de cliente Linux ODBC

Você pode escolher entre instalar o pacote completo do cliente ODBC ou instalar apenas o cliente do servidor de dados, conforme descrito em Cliente de servidor de dados Linux abaixo.

Nota informativa

A opção de driver "enableWLB" não é compatível. Para forçar a conexão a alternar automaticamente para outra LPAR em um sysplex paralelo (ou seja, “failover”), defina “enableACR” como “true” e “enableWLB” como “false” na configuração do driver.

Na máquina do Gateway Data Movement, abra um prompt de shell e faça o seguinte:

  1. Pare o serviço do Gateway Data Movement:

    sudo systemctl stop repagent

  2. Opcionalmente, confirme se o serviço foi interrompido:

    sudo systemctl status repagent

    O status deverá ser o seguinte:

    Active: inactive (dead) since <timestamp> ago

  3. Instale v11.5.8_linuxx64_server_dec.tar.gz e escolha a opção “CLIENT”.

  4. Se a máquina do Gateway Data Movement não tiver uma instância do DB2, crie uma instância do DB2 executando os seguintes comandos:

    adduser <db2_instance_name>

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

  5. Altere o diretório de trabalho para <Gateway Data Movement_Install_Dir>/bin.

  6. Inclua a localização do driver DB2 no caminho da biblioteca do Linux.

    Para fazer isso, adicione a seguinte linha ao arquivo site_ arep_login.sh conforme a seguir:

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

    em que path é o caminho do CLIENTE para o driver.

    Exemplo (com db2clnt1 como o nome da instância):

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

    export DB2INSTANCE=db2clnt1

  7. Opcionalmente, confirme se a localização do driver foi copiada:

    cat site_arep_login.sh

  8. Adicione a seguinte entrada ao arquivo odbcinst.ini em /etc:

    [IBM DB2 ODBC DRIVER]

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

    fileusage=1

    dontdlclose=1

  9. Inicie o serviço do Gateway Data Movement:

    sudo systemctl start repagent

  10. Opcionalmente, confirme se o serviço foi iniciado:

    sudo systemctl status repagent

    O status deverá ser o seguinte:

    Active: active (running) since <timestamp> ago

Cliente de servidor de dados Linux

  1. Baixe v11.5.8_linuxx64_client.tar.gz na Central de Correções IBM e extraia os arquivos.

  2. Pare o serviço do Gateway Data Movement:

    sudo service repagent stop

  3. Opcionalmente, confirme se o serviço foi interrompido:

    sudo service repagent status

    O status deverá ser o seguinte:

    Active: inactive (dead) since <timestamp> ago

  4. Altere o diretório de trabalho para /opt/client e execute db2_install.

  5. Crie um arquivo RSP (veja Arquivo RSP de amostra abaixo) e então execute o seguinte comando (de /opt/client):

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

  6. Adicione a seguinte entrada ao arquivo odbcinst.ini em /etc:

    [IBM DB2 ODBC DRIVER]

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

    fileusage=1

    dontdlclose=1

  9. Inicie o serviço do Gateway Data Movement:

    sudo service repagent start

  10. Opcionalmente, confirme se o serviço foi iniciado:

    sudo service repagent status

    O status deverá ser o seguinte:

    Active: active (running) since <timestamp> ago

Arquivo RSP de amostra

*-----------------------------------------------------
* 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

Configuração do ODBC no lado do servidor

Vincule o plano a ser usado para o ODBC, conforme especificado no valor PLANNAME= no arquivo de inicialização do ODBC. O nome padrão é DSNACLI. A tarefa BIND pode ser encontrada no membro DSNTIJCL, que está na biblioteca SDSNSAMP da instalação do DB2 de origem.

Use o comando bind do DB2CLI para vincular os pacotes fornecidos pelo ODBC ao subsistema z/OS DB2 de origem pretendido. Essa ação é descrita em Configurar seu ambiente de desenvolvimento e tempo de execução no site da IBM. Para obter informações sobre o utilitário DB2CLI, incluindo um exemplo para o utilitário bind, consulte db2cli - comando da CLI interativa do DB2 no site da IBM.

Permissões necessárias

Para permitir que o Gateway Data Movement extraia dados das tabelas de origem (carregamento completo e captura de dados de alterações), o usuário especificado nas propriedades do conector IBM DB2 for z/OS deve receber as seguintes permissões:

  • EXECUTE no IFI que faz a leitura do UDTF (necessário somente para a Captura de dados de alterações)
  • SELECT nas tabelas de origem e nas seguintes tabelas do catálogo do sistema:
    • SYSIBM.SYSDUMMY1
    • SYSIBM.SYSTABLES
    • SYSIBM.SYSTABLESPACE
    • SYSIBM.SYSPARMS
    • SYSIBM.SYSROUTINES
    • SYSIBM.SYSCOLUMNS
    • SYSIBM.SYSLGRNX
    • SYSIBM.SYSTABLEPART
  • MONITOR2 para poder iniciar sessões de IFI (necessário apenas para Captura de dados de alterações)

Capturar alterações de dados

Para capturar alterações do IBM DB2 for z/OS, o Gateway Data Movement usa um programa especial, invocado como uma rotina externa, que é uma função de tabela definida pelo usuário (UDTF). Esse programa (um módulo de carregamento) e a UDTF precisam ser instalados e configurados no sistema z/OS antes que as alterações possam ser capturadas. O procedimento de instalação, que deve ser executado pelo DBA, está descrito em Instalando e configurando o R4Z.

Além disso, o atributo DATA CAPTURE CHANGES deve ser definido para cada tabela cujas alterações você deseja capturar. Você pode fazer isso manualmente ou permitir que o Gateway Data Movement faça isso deixando a opção Ativar ALTERAÇÕES DE CAPTURA DE DADOS automaticamente (requer privilégio de administrador) habilitada (o padrão) nas configurações de conector.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui