Provisioning slot additions in a profile.bog file

NoteThis applies if the Supervisor is configured for provisioning its NiagaraNetwork (typical).

The niagaraStation in the “profile.bog file” on a subordinate JACE can represent both the folder structure and “properties/device extension” configuration that the Supervisor uses to model this JACE station. You can (and typically should) perform a lot of pre-engineering on the JACE station, working in its profile.bog file, even before the JACE is attached to the same network (thus before any Join is even possible).

If you want to minimize subsequent Supervisor station engineering required to fully assimilate the JACE, and have it instead Join “as fully configured as possible”, there is a missing child container slot that you should possibly add under the niagaraStation component in the station profile.bog file on the JACE.

If you add (and configure) this slot and properties prior to the first Join for the JACE, it will minimize the need for subsequent configuration in the Supervisor.

To add provisioning properties in the station profile.bog file

  1. Open the JACE’s platform bog file in its File space.

  2. Go to the slot sheet for the niagaraStation node. (right-click the niagaraStation, and select Views->Slot Sheet from the popup menu)

  3. In the bottom of the slot sheet view, right-click and select Add Slot.

  4. In the popup Add Slot dialog (as shown above) enter the following:

    • Name:  provisioningNiagara_PlatformConnection  (type in that exact string)

    • Type (select first):  provisioningNiagara      (select second):  PlatformConnection

    And click OK. A Platform Connection device extension is added to the profile.bog file.

  5. Go to the slot sheet of this new Platform Connection extension.

  6. In the slot sheet, right-click the “secure” slot and select Config Flags from the popup menu.

    Clear (uncheck) the Hidden flag.

  7. Next go to the property sheet and expand the Platform Connection.

    In the property sheet, enter the necessary values for the Supervisor to make a platform connection to this JACE, including:

    • Port — 3011 (default) is typical for a “regular” (non-SSL) platform connection, whereas 5011 is typical for a secure (platform SSL) connection.

    • Credentials — Enter the platform username and password. These are the same credentials used when making a Workbench platform connection to this JACE.

    • Securefalse (default) specifies a “regular” (non-SSL) platform connection—this is appropriate for any JACE-2 or -4/5 series host, or any JACE-6 or JACE-7 that is not configured for platform SSL. Otherwise, if the JACE is configured to support platform SSL only, this must be set to true.

  8. Save the profile.bog file (right-click the SupervisorName_profile.bog file and select Save).

By making these configuration changes to the profile.bog file in the JACE’s file space, the client proxy in the Supervisor will automatically be configured to use the appropriate platform connection parameters for provisioning—including (if so configured) for a platform SSL connection.