Gestione del server Qlik Data Gateway - Accesso diretto | Guida di Qlik Cloud
Vai al contenuto principale Passa a contenuto complementare

Gestione del server Qlik Data Gateway - Accesso diretto

Ultimo aggiornamento: 30/09/2026

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:

    • 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).

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

  2. Eseguire il comando seguente:

      • 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@

      • 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:

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:

    • 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).

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

  3. Eseguire il comando seguente:

    connectoragent qcs set_config --proxy_url ""

    • connectoragent qcs set_config --proxy_url ""

    • dotnet ConnectorAgent.dll qcs set_config --proxy_url ""

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

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:

      • Sintassi:connectoragent qcs set_config --tenant_url URL

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

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

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 (e di registrarla, come descritto in Fase quattro: Registrare il gateway dati).

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:

    • 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).

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

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

    • connectoragent qcs set_config --tenant_url URL

    • 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:

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

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

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

    • connectoragent help

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

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – ti pregiamo di farcelo sapere!