Managing the Qlik Data Gateway - Direct Access server
This section describes the various connectivity and management options that are available after you have installed Qlik Data Gateway - Direct Access.
Connecting to Qlik Cloud via a proxy server
If you did not configure proxy connectivity in the initial setup, you can do it later by running the commands described below. You can also run the same commands to edit existing proxy server settings.
Limitations and considerations
-
Only HTTP proxy schemas are supported.
-
Proxy servers that are configured to intercept SSL connections (for the purposes of content inspection or other security measures) are not supported.
-
In addition to HTTPS, Direct Access gateway also uses WSS (WebSocket Secure) protocol. Therefore, make sure that your firewall and proxy server (if you intend to use one) are set up to allow outbound WSS connections.
Enabling proxy server connectivity
You can enable or edit proxy server connectivity as follows:
-
Open a Command Prompt as an administrator and change the working directory to the ConnectorAgent subfolder (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent with a default installation).
-
Run the following command:
Syntax:
connectoragent qcs set_config --proxy_url http://host:port --proxy_username username --proxy_password password
Example:
connectoragent qcs set_config --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@
-
Restart the Qlik Data Gateway - Direct Access service as described in Managing the Qlik Data Gateway - Direct Access service.
Disabling proxy server connectivity
You can turn off proxy server connectivity as follows:
-
Open a Command Prompt as an administrator and change the working directory to the ConnectorAgent subfolder (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent with a default installation).
-
Run the following command:
connectoragent qcs set_config --proxy_url ""
-
Restart the Qlik Data Gateway - Direct Access service as described in Managing the Qlik Data Gateway - Direct Access service.
Updating the Qlik Cloud tenant URL
You can change the Qlik Cloud tenant URL as needed.
To do this:
-
On the Direct Access gateway server, Open a Command Prompt as an administrator and change the working directory to the ConnectorAgent subfolder (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent with a default installation).
-
Run the following command:
Syntax:
connectoragent qcs set_config --tenant_url URL
Example:
connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com
-
Restart the Qlik Data Gateway - Direct Access service as described in Managing the Qlik Data Gateway - Direct Access service.
Viewing the current Direct Access gateway server settings
You can view the current Direct Access gateway server settings,
To do this:
-
On the Direct Access gateway server, open a Command Prompt as an administrator and change the working directory to the ConnectorAgent subfolder (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent with a default installation).
-
Run the following command:
connectoragent qcs show_config
Your current settings will be shown.
Example:
connector-agent starting.... --tenant_url "elastic.example" --proxy_url "" --proxy_username "" DirectAccessAgent Control Program completed successfully.
Managing the Qlik Data Gateway - Direct Access service
After changing a setting on the Direct Access gateway server, you need to restart the Qlik Data Gateway - Direct Access service. You can also run the service under a different account.
Starting, stopping, or restarting the service
On the Direct Access gateway server, do one of the following to stop, start, or restart the service:
- Open the Windows Services console and stop, start or restart the Qlik Data Gateway - Direct Access service as required.
-
Open a Command Prompt as an administrator and change the working directory to the ConnectorAgent subfolder (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent with a default installation). Then, run the following commands:
connectoragent service stop
A confirmation that the service stopped successfully will be shown.
connectoragent service start
A confirmation that the service started successfully will be shown.
Running the service under a different account
By default, the Qlik Data Gateway - Direct Access service runs under the Local System account. To run the service under a different account, right-click Qlik Data Gateway - Direct Access in the Windows Services console and select the Log On tab. Then select This account and enter the account details. When you're done, save your settings and restart the service.
Available command categories
To see a list of available command categories, open a Command Prompt as an administrator and change the working directory to the ConnectorAgent subfolder (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent with a default installation.
Then run the following command:
connectoragent help
The following list will be displayed:
- service - See Managing the Qlik Data Gateway - Direct Access service above.
-
qcs - Must precede all documented commands, except service commands.
Example:
connectoragent qcs show_config
- setup - For support use only.
- repository - For support use only.
- configuration - For support use only.