4.8. Remote Config

The Remote Config tool lets you connect to a DataHub instance while it is running as a Windows service, or when it is running on a different computer on the network.

Click here to watch a video.

When running a DataHub instance as a Windows service it is commonly not possible to access its configuration dialog. Windows services have restricted ability to interact with the Windows desktop. You can use the Remote Config program to conveniently configure the DataHub instance while it is running as a Windows service.

[Note]

All DataHub installations that are configured to allow remote configuration must also enable the DataHub Web Server. Thus, all DataHub licenses for V9 and above now enable the Web Server for one Remote Config connection, with no additional licenses necessary. The Web Server will not operate for any other purpose without the normal Web Server license, which can be installed separately.

The remote configuration tool includes the ability to store access credentials to many DataHub installations at once. You can now easily manage many DataHub program installations anywhere on your network from a single location.

4.8.1. Preparation

Before connecting to a DataHub instance remotely to configure it, you must first run it as a normal program, not a service, and prepare it in two ways:

Security

  1. In the Security option of the DataHub Properties window, click the Configure Permissions button.

    This opens the Edit Permissions window.

  2. In the UserName panel, enter a new user name (like RemoteUser), and check the RemoteConfig box in Group Memberships.

  3. Click in the Password column to enter a password.

    The password must be a strong password, defined as:

    1. At least 8 characters long, and

    2. having mixed character case, and

    3. not a capitalized word.

      For example, Password will not work, but pAssword, PassWord, and Password123 will. Better yet, use something stronger like Con#rol%9.

  4. When finished, click Apply and Close.

For more information about security, please refer to DataHub Security configuration.

Features

You must configure the DataHub instance to allow remote configuration for any features that you wish to be able to remotely configure. For example, you may want to remotely configure Tunnel connections, but not allow scripts to be configured except from the local computer. You specify the configurable features as follows:

  1. In the DataHub Properties window, select Remote Config.

  2. Check the boxes of the features you want to be configurable. Checking a box in the Local column allows connections only from a DataHub instance running on the same machine, whereas boxes in the Remote column allow connections from a Remote Config instance running on a remote machine. If you uncheck Local and check Remote, then a user on the local machine will not be able to configure that feature.

Your DataHub instance is now ready to accept connections from the Remote Config program. Now you can go to Configuring a Local DataHub Instance for configuring a local connection, such as when running a DataHub instance as a service, or to Configuring a Remote DataHub Instance for remote connections.

[Note]

The Remote Config tool can connect to DataHub Version 8 but cannot configure its settings. The only purpose in connection to DataHub V8 would be to remotely view the Data Browser, Event Log, Connection Viewer or Script Log. To make such a connection, use the button Enter (Ignore Errors) when authenticating the connection.