New Station wizard

This tool uses templates to define the starting contents of a new station. It can be selected from the main Menu by selecting Tools > New Station.

The wizard provides default station templates for creating a new controller (JACE) station or a new Supervisor station for either Linux or Windows operating systems. Additionally, the list of templates shown in the wizard window automatically includes any user-defined station templates that are available. The wizard configures the new station with services and components as determined by the selected template.

By design, the different default station templates (with the exception of names and the ports configured for Linux) create identical stations. However, the configuration of these templates may vary in future Niagara distributions and it is possible for other parties to create and distribute different station templates.
 NOTE: In the Niagara 4.6 Workbench (and later), the station templates in the New Station Wizard are updated so that the default Mobile Web Profile configuration of the users and user prototypes is the HTML5HxProfile. If you would like to change the Default Mobile Profile for when new users are created, go to the UserService Default Protoype > User Prototypes properties and set the Mobile Web Profile Type to the HTML5HxProfile. 
Figure 131.   New Station Wizard
Image

You must enter a Station Name. You can also choose whether this is a remote controller station or a Supervisor station. Click Image Next to proceed. Next you should enter an Admin Password. You can also change the Fox Port and HTTP Port. Press Image  Finish to proceed. You are then presented a view of your newly created Station at local:|file:!stations/stationname/config.bog|bog:|slot:/.

When creating a new station, if you enter a station name identical to that of an existing station, the wizard alerts you that the station exists and prompts whether or not you wish to delete the existing station. The functionality gives you an opportunity to change the new station name, if you wish, or confirm that you intend to delete the existing station.

The wizard also performs entry validation on the password fields in the second dialog, alerting you to errors. By default, the system requires strong password. In order to comply, values entered in the Admin Password and Admin Password Confirm fields must be identical and meet the following password criteria:

  • at least 10 characters
  • at least 1 digit
  • at least 1 lowercase character
  • at least 1 uppercase character

Regarding the options for which action to take when you click Finish, the options presented are determined by whether and how you have made platform connections to localhost before. One or more of the following options are presented:

  • Open it in user home - Selected by default, on completion the station is created in your User Home directory and a property sheet view of the station’s config.bog displays.

    At this point the new station exists only in your User Home directory and not in the User Home of the local platform daemon.

  • Copy it to the platform for “localhost” with Station Copier - On completion, the station is created in your Workbench User Home directory. Then you are prompted to login to make a local platform connection. After you login, the Station Copier starts the transfer (copy). After the station is copied, the Application Director opens with the new station visible in the daemon’s User Home.

    At this point the new station exists in two locations: on your local host (in your Workbench User Home) and also in the platform daemon User Home.

     NOTE: If you make any changes to the station now (while it is running on the platform daemon User Home), it is a good idea to copy the station back to your Workbench User Home so that you have a local copy of the updated station. This is useful if you plan to install it on any remote platform.  

  • Close the wizard - On completion, the station is created in your Workbench User Home directory, the wizard closes, and an alert window appears notifying you of successful station creation.

Figure 132.   New station template containing configurable Foxs and HTTPS Port parameters
Image

In cases where the selected station template contains exposed (configurable) parameters, those are included as editable fields on the second wizard window, such as the port parameters indicated in the above image. This gives you the opportunity to modify those values as needed to complete the configuration for your new station.

 NOTE: When creating a station from the NewSupervisorStationLinux template the resulting station's Web Service is configured for HTTP on port 8080 and HTTPS on port 8443. Note, that you need to add a rule in your network firewall to allow data transmission on these ports. 

The default station templates (controller, supervisor) have two port configuration parameters. However, anyone can create and distribute a custom station template that provides different parameters or none at all. Whether the wizard window displays alternative parameters, additional parameters, or no parameters is determined by the station template. If there are parameters they display in this space. When there are more parameters than the space allows, a scroll pane appears.