Periscope Prerequisites

• Periscope (versions 3.0+) must run on a Niagara4 station, version 4.0 or higher.  It is recommended that Periscope run on a Niagara Web Supervisor or SoftJACE due to increased storage capacity and speed, but it can also run on any Niagara4 compatible JACE.
• Any station running Periscope must have at least 6MB available.
• Periscope is a web application and requires a modern browser. Officially supported browsers include IE10+ as well as the latest versions of Chrome and Firefox.

Installing Periscope

Saving and stopping your station:

• Open your Niagara Platform and open the Application Director

• Save your running station (Save Bog)

• Stop the station (Stop)

Installing Periscope JAR file

• Using Windows Explorer, navigate to your current build of Niagara
  • Typically: C:/Niagara/Niagara-4.X
• Place the periscope-rt.jar file and any other Periscope-related modules in the modules folder under your Niagara build

Adding the Periscope Service in Niagara4

• Open Workbench, reopen your Platform and access the Application Director
• Start the station
• Open the periscope palette:
  • In Workbench's upper options menu, select Window > Side Bars > Palette
  • In Palette on lower-left corner of Workbench, select the folder icon and search for periscope
• Drag and drop the PeriscopeService from the periscope palette into your station's Services container

Installing License File

The license file provided is not a normal Niagara license and needs to be installed separately.  The license can be automatically installed as long as the Niagara server has access to the internet.  

Automatic Installation

To automatically install the license:

1. Navigate to Services/PeriscopeService within your Workbench station
2. Right-click on PeriscopeService and select Action > Fetch License

At this point your license file will be downloaded from Periscope servers, copied into the appropriate directory, and loaded.

Manual Installation

To manually install the license, copy the license file into the following folder:

• {STATION_HOME}/shared/periscope
  • On a typical CPU, this will be: C:\ProgramData\Niagara-4.X\{brand}\station\{station_name}\shared\periscope
    
• The "periscope" folder should be created if it does not already exist in your station shared folder.