# Gestione del server Qlik Data Gateway - Accesso diretto

Questa sezione descrive le varie opzioni di connettività e gestione disponibili dopo l'installazione di Qlik Data Gateway - Accesso diretto.

## Connessione a Qlik Cloud mediante un server proxy

Se non si è configurata la connettività proxy nella configurazione iniziale, è possibile farlo in seguito eseguendo i comandi descritti di seguito. È inoltre possibile eseguire gli stessi comandi per modificare le impostazioni del server proxy esistenti.

### Limiti e considerazioni

* Sono supportati solo gli schemi proxy HTTP.

* I server proxy configurati per intercettare le connessioni SSL (ai fini dell'ispezione dei contenuti o di altre misure di sicurezza) non sono supportati.

* Oltre a HTTPS, il gateway di Direct Access utilizza anche il protocollo WSS (WebSocket Secure). Pertanto, assicurarsi che il proprio firewall e il server proxy (se si intende utilizzarne uno) siano configurati per consentire le connessioni WSS in uscita.

### Abilitazione della connettività del server proxy

È possibile attivare o modificare la connettività del server proxy come segue:

1. Effettuare una delle seguenti operazioni, a seconda del flusso di lavoro di installazione:

   * Windows installazione del server:

     Aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita).

   * Installazione containerizzata:

     Apri una console all'interno del contenitore direct-access-agent.

2. Eseguire il comando seguente:

   * Windows installazione del server:

     * Sintassi:connectoragent qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * Esempio: connectoragent qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

   * Installazione containerizzata:

     * Sintassi:dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * Esempio: dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

3. Effettuare una delle seguenti operazioni, a seconda del flusso di lavoro di installazione:

   * Windows installazione del server:

     Riavviare il servizio Qlik Data Gateway - Accesso diretto descritto in [Gestione del servizio Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

   * Installazione containerizzata:

     Riavviare il contenitore direct-access-agent .

### Disabilitare la connettività del server proxy

È possibile disattivare la connettività del server proxy come segue:

1. Aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita).

2. Effettuare una delle seguenti operazioni, a seconda del flusso di lavoro di installazione:

   * Windows installazione del server:

     Aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita).

   * Installazione containerizzata:

     Apri una console all'interno del contenitore direct-access-agent.

3. Eseguire il comando seguente:

   connectoragent qcs set\_config --proxy\_url ""

   * Windows installazione del server:

     connectoragent qcs set\_config --proxy\_url ""

   * Installazione containerizzata:

     dotnet ConnectorAgent.dll qcs set\_config --proxy\_url ""

4. Effettuare una delle seguenti operazioni, a seconda del flusso di lavoro di installazione:

   * Windows installazione del server:

     Riavviare il servizio Qlik Data Gateway - Accesso diretto descritto in [Gestione del servizio Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

   * Installazione containerizzata:

     Riavviare il contenitore direct-access-agent .

## Aggiornamento dell'URL tenant Qlik Cloud

È possibile modificare l'URL tenant Qlik Cloud secondo le necessità.

Operazione da eseguire:

1. Sul server del gateway Accesso diretto, aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita).

2. Esegui uno dei seguenti comandi a seconda del flusso di lavoro di installazione:

   * Windows installazione del server:

     * Sintassi:connectoragent qcs set\_config --tenant\_url URL

     * Esempio: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

   * Installazione containerizzata:

     * Sintassi:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

     * Esempio: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

3. Riavviare il servizio Qlik Data Gateway - Accesso diretto descritto in [Gestione del servizio Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

Nota informaticaL'aggiornamento dell'URL del tenant Qlik Cloud richiede inoltre di generare una nuova chiave di registrazione, come descritto in [Fase due: installare o distribuire Gateway di Direct Access](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2) (e di registrarla, come descritto in [Fase quattro: Registrare il gateway dati](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage4)).

## Visualizzazione delle impostazioni correnti del server gateway Accesso diretto

È possibile visualizzare le impostazioni correnti del server gateway di Direct Access.

Operazione da eseguire:

1. Effettuare una delle seguenti operazioni in base al proprio flusso di lavoro di installazione:

   * Windows installazione del server:

     Sul server del gateway Accesso diretto, aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita).

   * Installazione containerizzata:

     Apri una console all'interno del contenitore direct-access-agent.

2. Esegui uno dei seguenti comandi a seconda del flusso di lavoro di installazione:

   * Windows installazione del server:

     connectoragent qcs set\_config --tenant\_url URL

   * Installazione containerizzata:

     dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

   Verranno visualizzate le impostazioni correnti.

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

## Gestione del servizio Qlik Data Gateway - Accesso diretto

Nota informaticaSi applica solo alle installazioni server Windows.

Dopo aver modificato un'impostazione sul server del gateway Accesso diretto, sarà necessario riavviare il servizio Qlik Data Gateway - Accesso diretto. È anche possibile eseguire il servizio con un altro account.

### Avvio, arresto o riavvio del servizio

Sul server del gateway Accesso diretto, eseguire una delle seguenti operazioni per arrestare, avviare o riavviare il servizio:

* Aprire la console dei servizi di Windows e arrestare, avviare o riavviare il servizio Qlik Data Gateway - Accesso diretto come richiesto.

* Aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita). Eseguire quindi i seguenti comandi:

  connectoragent service stop

  Viene visualizzata la conferma che il servizio è stato arrestato correttamente.

  connectoragent service start

  Viene visualizzata la conferma che il servizio è stato avviato correttamente.

### Esecuzione del servizio con un altro account.

Per impostazione predefinita, il servizio Qlik Data Gateway - Accesso diretto viene eseguito sotto l'account Sistema locale. Per eseguire il servizio con un account diverso, fare clic con il pulsante destro del mouse su Qlik Data Gateway - Accesso diretto nella console dei servizi di Windows e selezionare la scheda Accesso. Selezionare quindi Questo account e inserirne i dettagli. Al termine, salvare le impostazioni e riavviare il servizio.

## Categorie di comandi disponibili

Per visualizzare un elenco delle categorie di comandi disponibili:

1. Effettuare una delle seguenti operazioni in base al proprio flusso di lavoro di installazione:

   * Windows installazione del server:

     Aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita.

   * Installazione containerizzata:

     Apri una console all'interno del contenitore direct-access-agent.

2. Esegui uno dei seguenti comandi a seconda del flusso di lavoro di installazione:

   * Windows installazione del server:

     connectoragent help

   * Installazione containerizzata:

     dotnet ConnectorAgent.dll help

Viene visualizzato il seguente elenco:

* service - Vedere Gestione del servizio Qlik Data Gateway - Accesso diretto sopra.

* qcs - Deve precedere tutti i comandi documentati, tranne quelli di servizio.

  Esempio (installazione del server Windows):

  connectoragent qcs show\_config

  Esempio (installazione containerizzata):

  dotnet ConnectorAgent.dll qcs show\_config

* setup - Solo per l'uso di supporto.

* repository - Solo per l'uso di supporto.

* configuration - Solo per l'uso di supporto.