Index | Prev | Next

Installing a station copy on another platform

At times you may need to install a copy of a station which was created on another platform. In such cases, the station bog file passphrase most likely differ from that of the target platform, and many times the passphrase and user credentials are unknown. In that case, before you can run the station you must edit the bog file offline. This procedure describes the steps to edit the bog file offline, set a new passphrase, change the admin user password, and install the copied station on the target platform. This procedure works for a Supervisor or controller station, and assumes the copied station is provided as a ZIP file.
Prerequisites:
  • The source and target controllers are running the latest Niagara version.
  • You are using Workbench running on a PC.
  • You have a NiagaraStation copy that was created on another platform and the BOG file passphrase is not known.
     NOTE: The copied station might be a single *.bog file but typically it is provided as a ZIP file containing a collection of files that may include any combination of the following: components (*.bog), templates (*.ntpl), Px files (*.px), graphic images, and etc. 
  1. Using Windows File Explorer, extract the downloaded ZIP file and copy the station folder to your User Home stations folder for your installation, (C:\Users\UserName\Niagara4.x\brand\stations).
  2. In the Workbench NavTree, expand My Host > My File System > User Home and navigate to the station folder just copied to that location.
  3. Expand the station folder and double-click config.bog to open the file.
  4. On the Workbench tool bar, click Image (Bog File Protection tool).
    The Bog File Protection tool allows you to enter, change, or add a bog file passphrase.
     CAUTION: Any password values that are encoded with the current passphrase will be cleared. So you will need to enter/re-enter the passwords that the station uses as a client, such as the passwords configured on a station-to-station connection or the Email Service. 
  5. In the Bog File Passphrase window, click Force the file to start using a different passphrase that you specify, enter the new Passphase and Passphrase Confirm values and click Update and on the subsequent view, click Close.
  6. In the NavTree, expand config.bog > Services, and double-click UserService.
  7. In the AX User Manager, double-click the admin user and under Authenticator, change the Password and Password Confirm values.
    Repeat this step as needed to change passwords for other users.
  8. Right-click the config.bog file and click Save.
  9. Open the Station Copier and copy the station from the your User Home to the target platform.
On completion, you have successfully edited the station config.bog offline, set a new passphrase, and changed the admin user password.

Typically, the station will autostart after copying. If not, use Application Director to start it. At this point you can connect to the station.

Related Links

  • Secure communication (Parent Topic)

    • Index | Prev | Next