Remote Hub

Connect a Remote Hub

Once a Network Group is created, perform the following steps to connect a remote hub to the central hub.

  1. Install the Intelligence Hub runtime component on another machine. Only the runtime is required, but you may optionally install the configuration component to allow for direct configuration if desired. See section Intelligence Hub Runtime Installation.

  2. Create a new intelligencehub-remoteconfig.json file in the appData directory. Define the file as follows. An intelligencehub-remoteconfig.json.template file is provided in the runtime directory as a starting point.

{
	"remoteUrl": "ws://hostname:45245/websocket",
	"token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "clientId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name" : "RemoteHub1",
    "features" : {
        "centralConfig" : true,
        "centralData" : false
    }
}
Property Description
remoteUrl The URL to the central host’s REST API. By default, this is port 45245 and uses web sockets (ws://) over HTTP or secure web sockets (wss://) over HTTPS. Note: HighByte recommends the use of HTTPS for accessing the REST API for secure websocket communications.
token The token automatically generated when creating a Network Group on the central hub and is used to authenticate the remote hub.
clientId The unique identifier used for the remote hub when connecting to the central hub. It can be configured by the user or left blank to be auto-generated by the central hub. If the specified client id doesn’t exist on the central hub, a new network hub will be created on the central hub to represent the remote hub. The clientId must be a GUID.
name Optional. The display name for the remote hub as shown on the central hub. If not specified, the remote hub will use its machine. This name can also be updated through the central hub.
features.centralConfig Enables or disables central configuration mode for the remote hub. When set to true, the central hub can remotely configure this hub. When set to false, central configuration is disabled. Default is true.
features.centralData Enables or disables central data access for the remote hub. When set to true, the central hub can access the namespace data from this remote hub. When set to false, central data access is disabled. Default is false. See Central Data for more details.

  1. Save this file and restart the runtime for this remote hub installation. The remote hub will connect to the central host.

    Upon successfully connecting, the following event message will be emitted: Remote configuration connected to ws://hostname:45245/websocket.

Rename the Remote Hub

By default, the remote hub connects to the central hub and uses its machine name as an identifier. This identifier can be changed by performing the following steps.

  1. Click Network and select the Hubs tab to list all Network Groups previously configured.

  2. Select the corresponding Network Group in the list and View its Details.

  3. Click Hubs to list all currently connected Hubs.

  4. Rename the hub and click Save.

Remote Hub

Remotely Configure the Hub

To configure the connected remote hub, perform the following steps.

  1. Click Host from the main menu.

  2. Select the remote hub to configure in the Change Hubs dialog and click Update.

  3. All configuration changes will now be proxied to the remote hub. When finished, select another remote hub to configure or click Host to work with the central hub.

Select Remote Hub