In the Join Profile Manager, select the JoinProfile for the Supervisor, and then click the button for a popup dialog, as shown in Figure 20.
Alternatively, you can simply double-click the JoinProfile for its property sheet, which contains all the properties shown
below, plus a “Status” property and a “Station Info” container. See StationInfo for additional details.
The following fields are in this dialog:
-
Enabled
By default, this is false. Set this to true on the JoinProfile for the Supervisor station (only).
-
Station Display Name
(Optional) Here you can enter whatever “friendly name” is desired to represent this local JACE station in the Supervisor station. Upon a Join, this appears as the display name of the NiagaraStation that represents this station, instead of the actual component name.
This field also accepts “BFormat” scripting using the JoinProfile’s “Station Info” properties. For example, if Station Info
has properties “State” and “City”, and you wanted this incorporated in the station display name, you could enter something similar to this:Relay Tower (%stationInfo.City% %stationInfo.State%)If the Station Info properties wereState=VirginiaandCity=Blacksburg, the NiagaraStation created in the Supervisor would have the display name:Relay Tower (Blacksburg Virginia) -
Default Subordinate User
This is the local (JACE) station user account to be used by the Supervisor for Fox client connection—typically a service type account (with admin-level permissions) used for station-to-station connections. If the subordinate station includes component tags added to program objects which are also enabled, both the service account (used for subordinate to Supervisor communication) and the user invoking the Join job require "super user" permissions. If the Supervisor already has a configured NiagaraStation for this station, it is not used (may be left blank).
-
Default Subordinate User Password
This is an added property in AX-3.7u1 and later. The local (JACE) station user password to be used by the Supervisor to connect back to this station. Like the other “Default” properties in this dialog, it may be left blank if the Supervisor already has a configured NiagaraStation for this station.
You must configure the Default Subordinate User Password when pre-engineering a subordinate station to join to a Supervisor.
Failure to configure the password will result in authentication errors when the Supervisor attempts to make a connection to
this subordinate JACE (that the Supervisor is not already “aware” of).
-
Default Subordinate IP Address
This is the IP address of the local (JACE) hosting this station, used by the Supervisor for Fox client connection. If the Supervisor already has a configured NiagaraStation for this station, it is not used (may be left blank).
-
Default Subordinate Port
This is the local (JACE) software port to be used by the Supervisor for Fox client connection—where the default variable
%foxService.port%tracks the currently used Fox port. If the Supervisor already has a configured NiagaraStation for this station, it is not used. -
Default Subordinate Use Fox SSL
(New starting in AX-3.7, by default false) Whether or not the Supervisor should use Fox SSL (Foxs) client connection to the local JACE for Join operations. Set this to true only if the local JACE is properly configured for certificate-based SSL communications, with Foxs enabled in its FoxService. The Supervisor is also typically configured for SSL communications, and both platforms require a valid certificate which is signed by a trusted CA whose root certificate is located in the reciprocal station's trust store.
-
Default Subordinate Fox SSL Port
(New starting in AX-3.7) Applies only if “Default Subordinate Use Fox SSL” is true. This is the local (JACE) software port to be used by the Supervisor for Foxs client connection—where the default variable
%foxService.foxsPort%tracks the currently used Foxs port. If the Supervisor already has a configured NiagaraStation for this station (using Foxs), it is not used. -
Station File
Typically left at defaults, this is the local file ord to the “profile.bog file” that acts as the folder/container “template” used on the NiagaraStation that represents this station, as it will be exported to the Supervisor station. The default value is:
file:^joinProfiles$(defaultStationFileName).bogFor related details, see station bog file.
If you edit this ord after the JoinProfile has already been enabled, you will need to disable and then re-enable the JoinProfile for a new profile.bog file to be created—otherwise, Join errors may result. Be aware that this does not delete (or rename)
the original profile.bog file.
In AX-3.7u1 and later, when you are pre-engineering a JACE for eventual Join to a Supervisor, (where you want to do as much engineering as possible in the JACE station or if you do not have access to the Supervisor station), there are properties that you need to configure. Specifically, the default subordinate user credentials in the JoinProfile must be configured in order to avoid authentication errors during the Join process.
-
Under the subordinate JACE station’s NiagaraNetwork, double-click the SubordinateExportTagNetworkExt to open the Join Profile Manager view.
-
Select the JoinProfile for the Supervisor, and then click the button for a popup dialog.
-
Enter a Default Subordinate User name (something that the Supervisor will recognize).
Typically, the Default Subordinate User account should be a user that was created especially for station-to-station access,
typically with admin write privileges, and not otherwise used for normal (login) access of the station.
-
Enter the Default Subordinate User Password for that user.
-
Click after making changes, as shown here:
After adding these properties you can issue a Join from the JACE station. The new NiagaraStation (representing that JACE) is added, where it has all the pre-engineered PxViews, points, etc from its export tags.
If an incorrect user name or password (or no password) is used, the Join will fail with authentication errors. Refer to the Job Log to confirm, as shown here:
