Configuring the BACnet/SC site settings - Metasys - LIT-12013959 - 13.0

BACnet/SC Workflow Technical Bulletin

Brand
Metasys
Document type
Technical Bulletin
Document number
LIT-12013959
Version
13.0
Revision date
2023-09-29
Product status
Active
Language
English
Use the BACnet/SC Management feature that is part of Metasys UI or JCT to configure your site settings. You need to configure the site settings only one time for your site.
Note: BACnet/SC site settings configured by Metasys UI or JCT apply to Metasys devices only. Equivalent settings for third-party devices need to be set by the tool for the third-party devices.

Configuring the Secure Port Number

To configure the Secure Port Number from the BACnet/SC Management window, complete the following steps:

  1. Open the Settings tab.
  2. In the Secure Port Number field, enter the secure port number.
    Note: Normally, the secure port number is the default port number (1443), but if the port has to be different, enter the number of the port that you want to use for secure web socket communication for BACnet/SC. This port is used by all Johnson Controls devices that are not acting as a hub for accepting a direct connection from another device. Normally, the same port number is used by the Primary Hub and by the Failover Hub, but it is not required.
    Note: For any Windows-based Metasys devices, for example ADX, ADS, NAE85, or LCS85 ensure that the firewall on the device does not block communication for the selected port.
  3. Click SAVE to distribute the settings to all devices on the site that are not overriding the global settings.
    Note: The distribution of the settings can take up to five minutes after you click Save. Check the SC Network Port object on any device to see if the settings have been distributed. The attributes in the SC Network Port object to check are JCI SC Primary Hub URI, JCI SC Failover Hub URI, and Secure Port Number. If these values did not get sent after waiting five minutes, you can change a different global setting that will force the values to be sent. For example, changing the Certificate Renewal Period in the Site object forces the global data to be reissued.

Configuring the SC Primary Hub

Important: To avoid communication problems, be very careful if you must change the Primary Hub URI on a site that is actively running BACnet/SC. The safest option is to set the communication mode of all devices back to Ethernet IP Only Mode, then change the URI and wait approximately five minutes until they are distributed and then set the communication mode of all devices to Secure Connect Only Mode. If this is not possible, make the changes as follows:
  1. Only change one of the Hub URIs at a time and make sure the devices are not currently connected to the Hub that is being changed. It is also best if the new Hub is not talking BACnet/SC until all devices are informed of the change. For example, if you need to change the Primary Hub URI and the devices are currently connected to it (normal operation), you should first disable BACnet/SC on the Primary Hub to force all the devices to connect to the Failover Hub. When the devices have connected to the Failover Hub, you are free to change the Primary Hub URI to the URI of the new hub, which should be currently disabled from talking BACnet/SC.
  2. Wait until the changed value is distributed to all the devices. This can take up to five minutes or more. You can check the Primary Hub URI in the SC Network Port object on select devices to determine if the change has been distributed.
  3. Enable BACnet/SC on the Primary Hub when all the devices have the new setting.

You can specify the SC Primary Hub in two ways from the BACnet/SC Management window.

If the SC Primary Hub is a Metasys device , complete the following steps:
  1. Open the Settings tab.
  2. In the SC Primary Hub URI field, select the required device from the list.
    Note: For best performance, use the preselected Site Director as an SC Primary Hub on a Metasys site.
  3. Click SAVE. The port number from the Secure Port Number field is automatically appended to the host name or IP address, along with a / at the end.
If the SC Primary Hub is a third-party device , complete the following steps:
  1. Open the Settings tab.
  2. Enter the host name or IP address of a device that can act as an SC Primary Hub on the site.
    Note: If you enter the details manually, the entry must conform to URI syntax: wss://[IP address or host name]:, optionally followed by the secure port number and /. For example: wss://10.x.xx.xxx:1443/. For third-party devices, the entry can also be followed by a path. If you include a path, you must also include a port number. For example: wss://xxx.xxx.xxx.xxx/443/hub

Configuring the SC Failover Hub

Important: To avoid communication problems, be very careful if you must change the Failover Hub URI on a site that is actively running BACnet/SC. The safest option is to set the communication mode of all devices back to Ethernet IP Only Mode, then change the URI and wait approximately five minutes until they are distributed and then set the communication mode of all devices to Secure Connect Only Mode. If this is not possible, make the changes as follows:
  1. Only change one of the Hub URIs at a time and make sure the devices are not currently connected to the Hub that is being changed. It is also best if the new Hub is not talking BACnet/SC until all devices are informed of the change.
  2. Wait until the changed value is distributed to all the devices. This can take up to five minutes or more. You can check the Failover Hub URI in the SC Network Port object on select devices to determine if the change has been distributed.
  3. Enable BACnet/SC on the Failover Hub when all the devices have the new setting.

You can specify the SC Failover Hub in two ways from the BACnet/SC Management window.

If the SC Failover Hub is a Metasys device , complete the following steps:
  1. Open the Settings tab.
  2. In the SC Failover Hub URI field, select the required device from the list.
    Note: Your SC Failover Hub cannot be the same as your SC Primary Hub.
  3. Click SAVE. The port number from the Secure Port Number field is automatically appended to the host name or IP address, along with a / at the end.
If the SC Failover Hub is a third-party device , complete the following steps:
  1. Open the Settings tab.
  2. Enter the host name or IP address of a device that can act as an SC Failover Hub on the site.
    Note: If you enter the details manually, the entry must conform to URI syntax: wss://[IP address or host name]:, optionally followed by the secure port number and /. For example: wss://10.x.xx.xxx:1443/. For third-party devices, the entry can also be followed by a path. If you include a path, you must also include a port number. For example: wss://xxx.xxx.xxx.xxx/443/hub