Connect a Gateway

Overview

Before you connect a Gateway to Gateway Hub, validate your Gateway Hub installation. See Validate an install.

You must have at least version 4.12 of both Active Console and Gateway.

When connecting a Gateway to Gateway Hub using the Gateway Setup Editor, you must provide a publishing address and REST address of one of your Gateway Hub nodes.

To use anomaly detection features you must start the Gateway in centrally configured mode. To do this, use the -gateway-hub <REST URL> command line option when starting the Gateway. The URL specified here will take precedence over any value specified in the Gateway Setup Editor. For more information, see Connecting to Gateway Hub.

Caution: Gateway Hub will reject metrics from Gateway samplers or dataviews that include the / character in their name.

Note: Gateway Hub publishing is not available from shared Gateways. Instead, you must enable publishing from the source Gateways.

Connect a Gateway to Gateway Hub using the Gateway Setup Editor

To connect the Gateway to the Gateway Hub, follow these steps:

Open Active Console.
Double-click the Gateway you wish to configure with Gateway Hub . This opens the Gateway Setup Editor(GSE).
In the GSE, double-click Gateway Hub in the Navigation tree. This creates the Gateway Hub section.
In the Gateway Hub section:
1. In Publishing address, add the host/port pair address of one of your Gateway Hub nodes. The default is <hostname>:9092/.
2. In REST address, add the REST address location of Gateway Hub. The REST address uses https. The default REST address is https://<hostname>:8081.
3. In Additional Settings, specify the location of the certificate for SSL:
```
kafka.security.protocol=ssl
kafka.ssl.ca.location=<location of CA certificate PEM file>
```
  Obtain the certificate file from your system administrator. For more information about all of the above fields, see Gateway integration technical reference.
Click Validate current document .
Note: If you see errors in the form:
Additional <headline/column/row> '<name of headline/column/row> is defined for dataview '<name of dataview>' but no schema has been defined. This dataview will not be published using internal format.
A schema definition is required for the sampler. Schemas are described in the next section. See Schema overview.
Click Save current document .

Caution: After you have started publishing to Gateway Hub, be aware that temporarily disabling publishing may result in Gateway Hub containing references to obsolete or deleted items. For example, if a managed entity is deleted, the Gateway cannot buffer this information and the Gateway Hub is not notified of the deletion when publishing is resumed. It is recommend that once started you do not disable publishing from the Gateway to Gateway Hub.