Configurando o Gateway Data Movement

A configuração do Gateway Data Movement envolve procedimentos que precisam ser executados no Administração e no servidor do Gateway Data Movement.

Se você quiser usar datamarts de conhecimento, consulte Configurando o Qlik Data Gateway - Movimentação de dados para datamarts de conhecimento.

Estágio um: baixe o Gateway Data Movement

1. Para acessar gateways de dados, selecione Administração no menu do iniciador () e depois Gateways de dados.

   Todos os gateways de dados existentes serão listados em uma tabela mostrando informações básicas sobre cada gateway.

2. Clique no botão Implementar da barra de ferramentas.

3. Selecione Gateway de dados - Movimentação de dados, aceite o Contrato do ClienteQlik e clique em Baixar.

   O RPM do Gateway Data Movement (qlik-data-gateway-data-movement.rpm) será baixado para sua máquina.

Estágio dois: instale e configure o Gateway Data Movement

Esse estágio envolve a instalação do Gateway Data Movement, a configuração da URL do Qlik Cloud e a geração de uma chave de registro. Você precisará copiar a chave para as configurações do Gateway Data Movement no Administração (no estágio três abaixo). A chave é usada para estabelecer uma conexão autenticada entre o Gateway Data Movement e o locatário do Qlik Cloud.

1. Quando o download estiver concluído, copie o arquivo RPM para a máquina Linux em que deseja instalar o Gateway Data Movement. Certifique-se de que a máquina esteja protegida pelo firewall e possa se comunicar com suas fontes de dados e o Qlik Cloud.

2. Abra um prompt de shell e altere o diretório de trabalho para o diretório que contém o RPM.

   Exemplo:

   /qlik/GatewayRPM/

3. Execute o seguinte comando para instalar o Gateway Data Movement.

   Sintaxe:

   QLIK_CUSTOMER_AGREEMENT_ACCEPT=yes rpm -ivh gateway-rpm

   Exemplo:

   sudo QLIK_CUSTOMER_AGREEMENT_ACCEPT=yes rpm -ivh qlik-data-gateway-data-movement.rpm

   Você pode visualizar o Acordo de Cliente da Qlik aqui: https://www.qlik.com/us/-/media/files/legal/license-agreements/qlik/qlik-customer-agreement-english.pdf (somente em inglês)

4. Após a conclusão da instalação, altere o diretório de trabalho para:

   /opt/qlik/gateway/movement/bin

   Em seguida, execute os seguintes comandos:

   Configurando o locatário do Qlik Cloud e um servidor proxy

   Nota informativa

   Se você precisar se conectar ao seu armazenamento ou data warehouse de nuvem por meio de um proxy, certifique-se de que as opções relevantes estejam ativadas nas configurações de aterrissagem:

   • Usar proxy para conectar-se ao armazém de dados na nuvem
   • Usar proxy para conectar ao armazenamento

   Se nenhuma dessas opções estiver ativada, a conexão proxy será para apenas o Qlik Cloud.

   Para obter mais informações sobre essas opções, consulte Aterrissagem de dados de fontes de dados.

   Execute o seguinte comando para definir o URL do locatário do Qlik Cloud e, opcionalmente, o URL do servidor proxy:

   Comando para configurar o URL do locatário do Qlik Cloud sem um servidor proxy:

   Sintaxe:

   ./agentctl qcs set_config --tenant_url URL

   Exemplo:

   ./agentctl qcs set_config --tenant_url mytenant.us.qlikcloud.com

    

   Comando para definir o URL do locatário do Qlik Cloud e o URL do servidor proxy:

   Sintaxe:

   ./agentctl qcs set_config --tenant_url your-qlik-cloud-tenant-url --proxy_url https|http://host:port --proxy_username username --proxy_password password

   Exemplo:

   ./agentctl qcs set_config --tenant_url mytenant.us.qlikcloud.com --proxy_url https://myproxy:1212 --proxy_username admin --proxy_password f56weqs@

   Consulte também: Gerenciando o servidor Gateway Data Movement

   Configurando o pacote de CA

   O pacote de CA autentica a identidade do locatário do Qlik Cloud, garantindo assim uma conexão confiável.

   Quem precisa configurar o pacote de CA?

   O pacote de CA apenas precisará ser definido se você for:

   • Um cliente Qlik Cloud Government
   • Um cliente comercial do Qlik Cloud que usa um dispositivo de segurança que atua como um proxy e substitui as informações do certificado recebidas da Internet por seus próprios certificados raiz de CA

   Qual pacote devo usar?

   Os clientes devem usar o pacote de CA Qlik ou trazer seu próprio pacote de CA, da seguinte maneira:

   • O Qlik fornece o pacote de CA: Deve ser usado por clientes Qlik Cloud Government com um ambiente padrão. Um ambiente padrão é um ambiente que não possui um dispositivo de segurança que atua como um proxy e substitui as informações do certificado recebidas da Internet por seus próprios certificados raiz da CA.

     Nota informativaVocê pode renomear o arquivo de pacote de CA, mas certifique-se de que ele tenha uma extensão .pem (por exemplo, qlikcerts.pem). Em seguida, execute o(s) comando(s) descrito(s) abaixo.
   • Os clientes trazem seu próprio pacote de CA: Deve ser usado se o ambiente do cliente estiver usando um dispositivo de segurança que atua como um proxy e substitui as informações do certificado recebidas da Internet por seus próprios certificados raiz de CA. Se esses certificados forem autoassinados, além do comando para definir o pacote CA, você também precisará executar o comando para permitir esse pacote de CA. Esses dois comandos estão descritos abaixo. Isso se aplica tanto a clientes do Qlik Cloud Government quanto a clientes comerciais do Qlik Cloud.

   Comando para configurar o pacote de CA

   Execute o comando a seguir para definir o pacote de certificados de CA:

   Sintaxe:

   ./agentctl qcs set_config --ca_bundle_path path-to-ca-bundle-file

   Exemplo:

   ./agentctl qcs set_config --ca_bundle_path /etc/ssl/certs/cacerts.pem

   Comando para permitir o pacote de CA

   Alguns ambientes usam um dispositivo de segurança que atua como um proxy e substitui as informações do certificado recebidas da Internet por seus próprios certificados raiz de CA. Esse comando somente precisará ser executado se o próprio dispositivo de segurança usar um certificado autoassinado. Nesse caso, o pacote de CA pode não ser confiável, a menos que você execute o seguinte comando:

   ./agentctl qcs set_config --ca_bundle_allow_invalid_certs true

   Nota informativaSe você não tiver certeza de que seu ambiente está usando esse tipo de dispositivo de segurança, entre em contato com o administrador de TI.

   Gerando e mostrando a chave de registro

   A chave é usada para estabelecer uma conexão autenticada entre o gateway de Data Movement e o locatário do Qlik Cloud.

   Execute o seguinte comando para gerar e mostrar a chave:

   ./agentctl qcs get_registration

   A chave é mostrada:

   

5. Copie a chave inteira, conforme mostrado no exemplo acima. Você precisará colá-la em Administração no próximo estágio.

Estágio três: retorne ao Administração e registre o Gateway Data Movement

1. Para acessar gateways de dados, selecione Administração no menu do iniciador () e depois Gateways de dados.

   Todos os gateways de dados existentes serão listados em uma tabela mostrando informações básicas sobre cada gateway.

2. Clique em Criar.

   O diálogo Criar gateway de dados é aberto.

   

3. Especifique um nome para o Gateway Data Movement.

4. Opcionalmente, forneça uma descrição para o Gateway Data Movement.

5. Na lista suspensa Tipo de gateway, selecione Data Movement.

6. Na lista suspensa de Espaço associado, selecione um espaço. Consulte também Considerações ao associar o gateway de dados a um espaço.

7. Cole a chave de registro que você gerou anteriormente no campo Chave.

8. Clique em Criar.

   O Gateway Data Movement é adicionado habilitado à lista Gateways de dados.

Estágio quatro: inicie o serviço do Gateway Data Movement no servidor do Gateway Data Movement

1. Execute o seguinte comando:

   sudo systemctl start repagent

2. Verifique se o serviço foi iniciado executando o seguinte comando:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: active (running) since <timestamp> ago

Nota de advertênciaDepois de iniciar o serviço do gateway, você deve atualizar seu navegador para ver o status atualizado do gateway de dados (Conectado) em Administração.

Estágio cinco: use as fontes de dados do Gateway Data Movement em seus projetos de dados

1. Para acessar gateways de dados, selecione Administração no menu do iniciador () e depois Gateways de dados.

   Todos os gateways de dados existentes serão listados em uma tabela mostrando informações básicas sobre cada gateway.

2. Atualize seu navegador para certificar-se de que a tabela do Gateways de dados esteja atualizada.

3. Localize seu gateway na tabela de Gateways de dados e verifique se seu Estado é “Conectado”.

Depois de ter verificado em Administração que o Gateway Data Movement está "Conectado", você pode usá-lo para acessar suas fontes de dados e destinos com suporte.

Para obter mais informações, consulte Configurando conexões com fontes de dados e Configurando conexões com destinos.

Trabalhando com o Gateway Data Movement

Ao trabalhar com o Qlik Data Gateway - Movimentação de dados, o fluxo deve ser o seguinte:

1. Configure o Gateway Data Movement em pelo menos uma máquina (dependendo do seu caso de uso) e configure a conectividade com seu locatário do Qlik Cloud, conforme descrito acima.
2. Instale o driver necessário para sua fonte de dados e atenda a quaisquer outros pré-requisitos, conforme descrito em Configurando conexões com fontes de dados. O driver pode precisar ser instalado em um servidor do Gateway Data Movement implementado perto da sua fonte, dependendo do seu caso de uso.
3. Instale o driver necessário para sua plataforma de destino e atenda a quaisquer outros pré-requisitos, conforme descrito em Configurando conexões com destinos. O driver também pode precisar ser instalado em um servidor do Gateway Data Movement implementado perto do seu destino, dependendo do seu caso de uso.
4. Configure o conector para sua fonte de dados, conforme descrito em Configurando conexões com fontes de dados.
5. Configure o conector para sua plataforma de destino, conforme descrito em Configurando conexões com destinos.
6. Crie um projeto e execute as tarefas necessárias, conforme descrito em Criando um projeto de pipeline de dados.

Considerações ao associar o gateway de dados a um espaço

Ao associar o gateway de Data Movement a um espaço (consulte a Etapa 3 acima), esteja ciente do seguinte:

• Os gateways de dados podem ser criados apenas em espaços de dados.
• Para criar uma conexão em um espaço que usa um gateway de dados de outro espaço, você deve ter a função Pode consumir dados no espaço do gateway de dados.

• Para criar um gateway de dados, você deve ser proprietário de um espaço ou ter a função Pode gerenciar. Para assinaturas baseadas em usuário, você também precisa de uma licença Professional. Para obter mais informações, consulte Gerenciando direitos do usuário.

• Gateways de dados só podem ser associados a um único espaço.