Configurando o Movimentação de dados gateway
A configuração do Movimentação de dados gateway envolve procedimentos que precisam ser executados no Administração e no servidor do Movimentação de dados gateway.
- Todos os comandos da CLI devem ser executados no servidor do gateway Movimentação de dados.
- Os comandos de instalação (RPM) e de serviço devem ser executados como sudo ou como root.
-
Os procedimentos do Movimentação de dados gateway que precisam ser executados no Administração exigem permissão do administrador de locatários.
Veja também: Considerações ao associar o gateway de dados a um espaço
Estágio um: baixe o gateway do Movimentação de dados
-
Para acessar gateways de dados, selecione Administração do 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.
-
Clique no botão Implementar da barra de ferramentas.
O diálogo Implementar gateway de dados é aberto.
-
Selecione Data Gateway - Data Movement, aceite o Contrato do Cliente da Qlik e clique em Baixar.
O Movimentação de dados
Estágio dois: instale e configure o gateway do Movimentação de dados
Essa etapa envolve a instalação do gateway Movimentação de dados, 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 Movimentação de dados gateway no Administração (no estágio três abaixo). A chave é usada para estabelecer uma conexão autenticada entre o gateway Movimentação de dados e o locatário do Qlik Cloud.
-
Quando o download estiver concluído, copie o arquivo RPM para a máquina Linux em que deseja instalar o gateway Movimentação de dados. Certifique-se de que a máquina esteja protegida pelo firewall e possa se comunicar com suas fontes de dados e o Qlik Cloud.
-
Abra um prompt de shell e altere o diretório de trabalho para o diretório que contém o RPM.
Exemplo:
/qlik/GatewayRPM/
-
Execute o seguinte comando para instalar o gateway Movimentação de dados.
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)
-
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 informativaSe 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:
- Use o proxy para conectar-se ao data warehouse de 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 Data Movement gateway
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:
-
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 Movimentação de dados gateway
-
Para acessar gateways de dados, selecione Administração do 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.
-
Clique em Criar.
O diálogo Criar gateway de dados é aberto.
-
Especifique um nome para o gateway Movimentação de dados.
-
Opcionalmente, forneça uma descrição para o gateway Movimentação de dados.
-
Na lista suspensa Tipo de gateway, selecione Data Movement.
-
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.
-
Cole a chave de registro que você gerou anteriormente no campo Chave.
-
Clique em Criar.
O gateway Movimentação de dados é adicionado habilitado à lista Gateways de dados.
Estágio quatro: inicie o serviço do gateway do Movimentação de dados no servidor de gateway do Movimentação de dados
-
Execute o seguinte comando:
sudo systemctl start repagent
-
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
Estágio cinco: use as fontes de dados do gateway do Movimentação de dados em seus projetos de dados
-
Para acessar gateways de dados, selecione Administração do 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.
-
Atualize seu navegador para certificar-se de que a tabela do Gateways de dados esteja atualizada.
-
Localize seu gateway no Gateways de dados e verifique se seu Estado é “Conectado”.
Depois de ter verificado em Administração que o Movimentação de dados gateway 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 Data Movement gateway
Ao trabalhar com o Qlik Data Gateway - Data Movement, o fluxo deve ser o seguinte:
- Instale uma ou mais instâncias do Data Movement gateway (dependendo do seu caso de uso) e configure a conectividade com seu locatário do Qlik Cloud, conforme descrito acima.
- 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 Data Movement gateway implementado perto da sua fonte, dependendo do seu caso de uso.
- 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 Data Movement gateway implementado perto do seu destino, dependendo do seu caso de uso.
- Configure o conector para sua fonte de dados, conforme descrito em Configurando conexões com fontes de dados.
- Configure o conector para sua plataforma de destino, conforme descrito em Configurando conexões com destinos.
- Crie um projeto e execute as tarefas necessárias, conforme descrito em Criando um 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), você deve estar ciente do seguinte:
- Os gateways de dados podem ser criados apenas em Espaços de dados.
- Para poder 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 poder criar um gateway de dados, o usuário precisa ser proprietário de um espaço ou ter a função Pode gerenciar. Além disso, o usuário precisa de Direito de usuário Professional ou Full User. Atribua Direito Professional manualmente ou ativando Habilitar atribuição dinâmica de usuários Professional em Administração.
Para obter mais informações sobre direitos de usuários e a atribuição dinâmica de acesso Professional, consulte Gerenciando direitos do usuário
- Gateways de dados só podem ser associados a um único espaço.