# 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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

   * 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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

   * 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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

Nota informativaAtualizar o URL do locatário Qlik Cloud também exige que você gere uma nova chave de registro, conforme descrito em [Etapa dois: Instalar ou implementar Direct Access gateway](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2) (e a registre, conforme descrito em [Etapa quatro: Registrar o gateway de dados](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage4)).

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

Nota informativaAplica-se apenas a instalações de servidor Windows.

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.

### Iniciando, interrompendo ou reiniciando o serviço

No servidor do gateway Direct Access, faça o seguinte para interromper, iniciar ou reiniciar o serviço:

* Abra o console de Serviços do Windows e interrompa, inicie ou reinicie o serviço do Qlik Data Gateway - Acesso direto conforme necessário.

* 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). Em seguida, execute os seguintes comandos:

  connectoragent service stop

  Uma confirmação de que o serviço foi interrompido com êxito será exibida.

  connectoragent service start

  Uma confirmação de que o serviço foi iniciado com êxito será exibida.

### 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.