Periscope Prerequisites
- Periscope must run on a NiagaraAX station, version 3.5 or higher. A station is defined as an instance of Niagara running on a hardware platform, so Web Supervisors and JACEs are considered a station. It is strongly recommended that Periscope run on a Niagara Web Supervisor station due to the increased storage capacity, but it can be installed on a JACE station also.
- Any station running the Periscope service should have at least 5MB available. The Periscope module itself takes up about 2MB, and it will need room to maintain configuration and user dashboard options.
- The connected NiagaraAX station must have oBIXTM (Open Building Information Xchange) installed and enabled in the station’s drivers folder.
- Periscope requires the installer and end-user to install the Adobe® Flash plug-in for their browser. Users will be prompted if they have not installed the necessary files to view Periscope.
- Installing Periscope
First, the Periscope JAR file must be installed on the Web Supervisor (or JACE). An oBIX Network must also be added to the driver’s folder if not already present. Once both files have been added, open the alxPeriscope palette, and drop the PeriscopeService into the services category. A valid license and certificate file must be obtained and added in the platform’s license manager as well. Periscope is now installed and licensed, but it must be configured before being used.
Installing Periscope
First, the Periscope JAR file must be installed on the Web Supervisor (or JACE). An oBIX Network must also be added to the driver’s folder if not already present. Once both files have been added, open the alxPeriscope palette, and drop the PeriscopeService into the services category. A valid license and certificate file must be obtained and added in the platform’s license manager as well. Periscope is now installed and licensed, but it must be configured before being used.
Initial Periscope Configuration
To configure Periscope, go to http://(IP address of the Web Supervisor/JACE)/periscopeconfig and log in as a super user. Under the locations tab, add several locations or buildings by selecting the new location button at the bottom of the screen. Also make sure to enter a square footage and a blended rate for electricity, and other utilities as desired. At least one trend, point, meter, or web/PX page should be added before accessing Periscope. Periscope’s automatic discovery wizard will instantly import all available numeric points and trends, as well as any meters or PX pages discovered in the Web Supervisor/JACE database. Any additional variables added after the initial discovery will not show up in Periscope until the user does a manual discovery. This is done by pressing the “discover” button at the bottom of the respective variable’s configuration screen. Once configured, the user can access Periscope by going to http://(IP address of the Web Supervisor/JACE)/periscope and entering their credentials.
User Setup
All users are capable of accessing their own Periscope dashboard if they meet these requirements:
- Operator Read access to all mapped points is enabled
- Admin Invoke on the PeriscopeService, Meter and Rollover objects