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:

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

2. 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@

3. 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:

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

2. Run the following command:

   connectoragent qcs set_config --proxy_url ""

3. 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:

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

2. Run the following command:

   Syntax:

   connectoragent qcs set_config --tenant_url URL

   Example:

   connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com

3. 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:

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

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

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.