Gerenciando o servidor Qlik Data Gateway - Acesso direto

Esta seção descreve as várias opções de conectividade e gerenciamento que estão disponíveis após a instalação do Qlik Data Gateway - Acesso direto.

Conectando-se ao Qlik Cloud por meio de um servidor proxy

Se você não tiver definido a conectividade de proxy na configuração inicial, poderá fazer isso posteriormente executando os comandos descritos abaixo. Você também pode executar os mesmos comandos para editar as configurações existentes do servidor proxy.

Limitações e considerações

• Apenas há suporte para esquemas de proxy HTTP.

• Não há suporte para servidores proxy configurados para interceptar conexões SSL (para fins de inspeção de conteúdo ou outras medidas de segurança).

• Além do HTTPS, o gateway do Direct Access também usa o protocolo WSS (WebSocket Secure). Portanto, certifique-se de que seu firewall e servidor proxy (se você pretende usar um) estejam configurados para permitir conexões WSS de saída.

Habilitando a conectividade do servidor proxy

Você pode ativar ou editar a conectividade do servidor proxy da seguinte maneira:

1. Siga um dos seguintes procedimentos, dependendo do fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     Abra um Prompt de Comando como administrador e altere o diretório de trabalho para a subpasta ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent com uma instalação padrão).

   • Instalação conteinerizada:

     Abra um console dentro do contêiner direct-access-agent.

2. Execute o seguinte comando:

   • Windows instalação do servidor:

     • Sintaxe: connectoragent qcs set_config --proxy_url http://host:port --proxy_username username --proxy_password password

     • Exemplo: connectoragent qcs set_config --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@

   • Instalação conteinerizada:

     • Sintaxe: dotnet ConnectorAgent.dll qcs set_config --proxy_url http://host:port --proxy_username username --proxy_password password

     • Exemplo: dotnet ConnectorAgent.dll qcs set_config --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@

3. Siga um dos seguintes procedimentos, dependendo do fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     Reinicie o serviço do Qlik Data Gateway - Acesso direto conforme descrito em Gerenciando o serviço Qlik Data Gateway - Acesso direto.

   • Instalação conteinerizada:

     Reinicie o contêiner direct-access-agent.

Desabilitando a conectividade do servidor proxy

Você pode desativar a conectividade do servidor proxy da seguinte maneira:

1. Abra um Prompt de Comando como administrador e altere o diretório de trabalho para a subpasta ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent com uma instalação padrão).

2. Siga um dos seguintes procedimentos, dependendo do fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     Abra um Prompt de Comando como administrador e altere o diretório de trabalho para a subpasta ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent com uma instalação padrão).

   • Instalação conteinerizada:

     Abra um console dentro do contêiner direct-access-agent.

3. Execute o seguinte comando:

   connectoragent qcs set_config --proxy_url ""

   • Windows instalação do servidor:

     connectoragent qcs set_config --proxy_url ""

   • Instalação conteinerizada:

     dotnet ConnectorAgent.dll qcs set_config --proxy_url ""

4. Siga um dos seguintes procedimentos, dependendo do fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     Reinicie o serviço do Qlik Data Gateway - Acesso direto conforme descrito em Gerenciando o serviço Qlik Data Gateway - Acesso direto.

   • Instalação conteinerizada:

     Reinicie o contêiner direct-access-agent.

Atualizando a URL do locatário do Qlik Cloud

Você pode alterar a URL do locatário do Qlik Cloud conforme necessário.

Para fazer:

1. Na servidor do Direct Access gateway, abra um Prompt de Comando como administrador e altere o diretório de trabalho para a subpasta ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent com uma instalação padrão).

2. Execute um dos seguintes comandos, dependendo do seu fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     • Sintaxe: connectoragent qcs set_config --tenant_url URL

     • Exemplo: connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com

   • Instalação conteinerizada:

     • Sintaxe: dotnet ConnectorAgent.dll qcs set_config --tenant_url URL

     • Exemplo: dotnet ConnectorAgent.dll qcs set_config --tenant_url mytenant.us.qlikcloud.com

3. Reinicie o serviço do Qlik Data Gateway - Acesso direto conforme descrito em Gerenciando o serviço Qlik Data Gateway - Acesso direto.

Visualizando as configurações atuais do servidor do gateway Direct Access

Você pode ver as configurações atuais do servidor do gateway Direct Access.

Para fazer:

1. Siga um dos seguintes procedimentos, dependendo do seu fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     Na servidor do Direct Access gateway, abra um Prompt de Comando como administrador e altere o diretório de trabalho para a subpasta ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent com uma instalação padrão).

   • Instalação conteinerizada:

     Abra um console dentro do contêiner direct-access-agent.

2. Execute um dos seguintes comandos, dependendo do seu fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     connectoragent qcs set_config --tenant_url URL

   • Instalação conteinerizada:

     dotnet ConnectorAgent.dll qcs set_config --tenant_url URL

   Suas configurações atuais serão mostradas.

   connector-agent starting....
   --tenant_url "elastic.example"
   --proxy_url ""
   --proxy_username ""
   DirectAccessAgent Control Program completed successfully.

Gerenciando o serviço Qlik Data Gateway - Acesso direto

Depois de alterar uma configuração no servidor de gateway Direct Access, você precisará reiniciar o serviço Qlik Data Gateway - Acesso direto. Você também pode executar o serviço em uma conta diferente.

Executando o serviço em uma conta diferente

Por padrão, o serviço Qlik Data Gateway - Acesso direto é executado na conta do Sistema Local. Para executar o serviço em uma conta diferente, clique com o botão direito do mouse no Qlik Data Gateway - Acesso direto no console de Serviços do Windows e selecione a guia Logon. Em seguida, selecione Esta conta e insira os detalhes da conta. Quando terminar, salve suas configurações e reinicie o serviço.

Categorias de comando disponíveis

Para ver uma lista de categorias de comandos disponíveis:

1. Siga um dos seguintes procedimentos, dependendo do seu fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     Abra um Prompt de Comando como administrador e altere o diretório de trabalho para a subpasta ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent com uma instalação padrão.

   • Instalação conteinerizada:

     Abra um console dentro do contêiner direct-access-agent.

2. Execute um dos seguintes comandos, dependendo do seu fluxo de trabalho de instalação:

   • Windows instalação do servidor:

     connectoragent help

   • Instalação conteinerizada:

     dotnet ConnectorAgent.dll help

A lista a seguir será exibida:

• service - Consulte Gerenciamento do serviço Qlik Data Gateway - Acesso direto acima.

• qcs - Deve preceder todos os comandos documentados, exceto comandos de serviço.

  Exemplo (instalação do servidor Windows):

  connectoragent qcs show_config

  Exemplo (Instalação conteinerizada):

  dotnet ConnectorAgent.dll qcs show_config

• setup- Somente para uso pelo suporte.
• repository- Somente para uso pelo suporte.
• configuration- Somente para uso pelo suporte.