Gestione del server Qlik Data Gateway - Accesso diretto
Ultimo aggiornamento: 30/09/2026Questa 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:
-
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.
-
-
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@
-
-
-
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.
-
Installazione containerizzata:
Riavviare il contenitore direct-access-agent .
-
Disabilitare la connettività del server proxy
È possibile disattivare la connettività del server proxy come segue:
-
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).
-
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.
-
-
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 ""
-
-
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.
-
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:
-
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).
-
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
-
-
-
Riavviare il servizio Qlik Data Gateway - Accesso diretto descritto in Gestione del servizio Qlik Data Gateway - Accesso diretto.
Visualizzazione delle impostazioni correnti del server gateway Accesso diretto
È possibile visualizzare le impostazioni correnti del server gateway di Direct Access.
Operazione da eseguire:
-
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.
-
-
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
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:
-
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.
-
-
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.