Installing the OpenADR – DRAS Simple Client Driver

You can install the OpenADR – DRAS Simple Client Driver under a NiagaraAX station Drivers node.

The DRAS server and client communication uses secured socket layer protocol (SSL). The DRAS module depends on the crypto module, which helps establish secured communication.

The following sections describe how to install and configure the OpenADR – DRAS Simple Client Driver. Perform the tasks in the order listed below:

Install the Crypto Service

The Crypto Service (CryptoService) is provided as part of the crypto module and is available in the crypto palette.

  • The target platform must be running NiagaraAX-3.5.25.2 or later.

  • The target platform must have the “adr” and “crypto” modules installed.

  • The target platform must have the “adr” and “crypto” features in its license.

The following task assumes that the user has established a connection to the target platform using NiagaraAX-3.5.25.2 or later.

  1. From the WorkbenchAX main menu, select Window > Side Bars > Palette.
    Note:

    If the Side Bar pane is not open, select Window > Side Bars > Show Side Bar from the main menu.

  2. In the Palette side bar, click the Open Palette menu control.

    The Open Palette dialog box opens.

  3. In the Open Palette dialog box, select the “crypto” module and click the OK button.

    The crypto palette displays in the palette side bar.

  4. From the crypto palette, drag and drop the CryptoService component onto the target station’s Services node ( Station > Config > Services).

    Figure 1. Add the CryptoService under the Services node.



    The CryptoService component displays under the Services node.

  5. In the nav tree, double-click on the CryptoService component.

    The CryptoService property sheet view displays in the view pane.

  6. In the CryptoService property sheet view, expand the Ssl node and check the following properties, as required:
    Note:

    For the DRAS Simple Client Driver, default settings, shown below, should never be changed.

    Figure 2. CryptoService properties.



    • Key Store

      The path to the file that contains the key entries for the DRAS client. By default, this string value is file:!security/ssl.tks, which is under the security folder of the Niagara installation directory.

    • Key Store Password

      The string password by which the keystore file is protected. The password is: “tridium”.

    • Key Store Type

      The type of keystore file. This is preconfigured information. NiagaraAX key store file is of type “TKS”.

    • Trust Store

      The file path containing the certificate entries. The entries in this file validate the secured server to which the client connects. By default this slot points to SSL.tks file located under the security folder of the Niagara installation directory.

    • Trust Store Password

      The string password by which the trust store file is protected. The default password is “tridium”.

    • Trust Store Type

      Type of the trust store file. This is preconfigured information. Niagara trust store file is of type “TKS”.

  7. With all properties set as desired, click the OK button.

    The property settings are saved.

The CryptoService installation is complete.

Install the DRAS Network

The DRAS Network is provided as part of the dras module and is available in the DRAS palette or from the Driver Manager’s New dialog box.

  • The target platform must be running NiagaraAX-3.5 or later.

  • The Crypto Service is installed and configured.

  • A platform connection exists between your WorkbenchAX platform and the target platform.

  1. In the WorkbenchAX nav tree, double-click on the Drivers node.

    The Driver Manager view displays.

  2. At the bottom of the Driver Manager view, click the New button.

    The New dialog box displays.

  3. In the New dialog box, choose Dras Network from the Type to Add option list, enter “1” in the Number to Add field, and click the OK button.

    A second New Dialog box displays.

  4. In the New Dialog box, edit the name of the network, if desired, set the Enabled property to true and click the OK button.

    The DrasNetwork entry appears in the Driver Manager view and the DrasNetwork component appears in the nav side bar under the Drivers node.

The DrasNetwork installation is complete.

Install the DRAS Device

The Dras Device component is provided as part of the dras module and is available in the DRAS palette or from the Dras Device Manager’s New dialog box.

  • The target platform must be running NiagaraAX-3.5 or later.

  • The DrasNetwork is installed.

  • A platform connection exists between your WorkbenchAX platform and the target platform.

Note:

The DRAS client is a “device-level” component. Each DRAS device represents a participant configured in the DRAS server.

  1. In the WorkbenchAX nav tree, double-click on the DrasNetwork node.

    The Dras Device Manager view displays.

  2. At the bottom of the Dras Device Manager view, click the New button.

    The New dialog box displays.

  3. In the New dialog box, choose Dras Device from the Type to Add option list, enter “1” in the Number to Add field, and click the OK button.

    A second New Dialog box displays.

  4. In the New Dialog box, edit the name of the device, if desired, set the Enabled property to true and click the OK button.

    The DrasDevice entry appears in the Dras Device Manager view and the DrasDevice component appears in the nav side bar under the Drivers node.

The DrasDevice is installed. Default settings should be sufficient for the device to be enabled. For more information about property settings, see “Related Links”.

Related information
About the DRAS Device