Managing CylanceGATEWAY Connectors Skip Navigation

Managing
CylanceGATEWAY Connectors

After you've registered
CylanceGATEWAY Connectors
, you can specify a health check URL and restrict IP addresses for your connectors. If a health check URL is not specified, an alert message is displayed that prompts you to add the URL. Error messages that indicate failed DNS and HTTPS checks are also displayed on the
CylanceGATEWAY Connectors
screen. For the
CylanceGATEWAY Connectors
, you can perform the following:
Screen
Actions
On the
CylanceGATEWAY Connectors
list screen
  • View the number of connections that are active.
  • View the version of each connector instance.
  • View the status of your connectors.
  • Reload the
    CylanceGATEWAY Connectors
    information.
  • Download the log files of each connector instance.
  • Disable a connector to prevent new connections from being routed through the connector. Active network connections are not interrupted.
On the Connector info page
  • Edit the Private URL field for a connector and open the URL in a separate page.
  • Disable a connector to prevent new connections from being routed through the connector. Active network connections are not interrupted.
  • View the version of the connector.
  • View the connection status of the connector.
  • Download the log files for the connector.
  • View the Public Key
  • View the connection history of the connector. The connection history time is in UTC.
Restricting source IP addresses provides additional security to ensure that only
CylanceGATEWAY Connectors
with the IP addresses you specify can connect to your private network. If you restrict source IP addresses, your
CylanceGATEWAY Connectors
should have a fixed IP address, either by setting a static IP address for the
CylanceGATEWAY Connector
when it is deployed in a vSphere environment or ESXi environment, or creating a DHCP IP reservation on your network.
Depending on the number of active
CylanceGATEWAY
users in your environment, a component of the
BlackBerry Infrastructure
that is responsible for managing incoming tunnels from the connector might scale the resources that are allocated to your organization. Each
CylanceGATEWAY Connector
establishes a tunnel to this component and has a health check performed on it. The Tunnel, DNS, HTTP, and Status columns then provide an indication of the state of those tunnels from the connector to the component that is responsible for managing them. For example, if the Tunnel column displays
X
/2, this means that two of the components are allocated to your organization at that time. If the column displays 2/2, the connector has successfully established two tunnels to the component. If you see 0/2 or 1/2 that means the connector has either not established a tunnel or has established 1 out of the 2 tunnels that are required. If the status is The Attention icon, some but not all of your users are able to access resources on your private network.
The health check URL can be any URL within your private network that you want
CylanceGATEWAY
users to be able to connect to.
CylanceGATEWAY
periodically sends an HTTP or HTTPS GET request, including a DNS lookup, through each
CylanceGATEWAY Connector
tunnel to this URL. The Tunnel, DNS, and HTTP columns display the connection status for each connector. A status of 2/2 indicates that everything is working correctly. A status of 0/0 indicates that the status check of a new connection is still pending.
The Status column displays the enrollment status of the
CylanceGATEWAY Connector
with the
BlackBerry Infrastructure
. The The Connected icon indicates that the
CylanceGATEWAY Connector
has successfully completed the enrollment process and has established a connection to the
BlackBerry Infrastructure
. The status column displays the connection state and might include a security message (for example, if the connector requires a restart to apply an update). 
Column
Description
Tunnel
This is the status of the
CylanceGATEWAY Connector
connection to the
BlackBerry Infrastructure
. If the status indicates a connection issue, contact your
BlackBerry
support representative.
DNS
This is the status of the DNS query made from the
CylanceGATEWAY Connector
to your specified DNS server. If the status indicates an issue, verify that you've correctly specified your private DNS server.
HTTP
This is the status of the HTTP query made to the
CylanceGATEWAY Connector
for the health check URL. If the status indicates an issue, verify that the health check URL can be reached from the
CylanceGATEWAY Connector
and that you have specified a DNS forward lookup zone.
Status
This is the overall status of the
CylanceGATEWAY Connector
connection to the
BlackBerry Infrastructure
including the tunnel, DNS, HTTP, and health check.
  • The Initializing icon: The connector has not completed the enrollment process. This status is displayed only the first-time connector is enrolled.
  • The pending enrollment icon: The connector has completed the enrollment process and is establishing a connection to the
    BlackBerry Infrastructure
    .
  • The Attention icon: The connector has completed the enrollment process, but not all of the connections to the
    BlackBerry Infrastructure
    have been established. If this status is displayed, read the associated security message and verify that a health check URL has been specified.
  • The Failed icon: The connector enrollment process has not completed or there is an error in establishing all the connections to the
    BlackBerry Infrastructure
    . The following error messages might be displayed:
    • Failed to register due to storage error: verify that you have sufficient disk space to register the
      CylanceGATEWAY Connector
      .
    • Health check failed: Read the associated security message. Verify that the Tunnel, DNS, and HTTP columns are displaying a status of 2/2.