View Source

Periscope Prerequisites

SkySpark (3.0.12+) is a supported platform on Periscope 4.0 versions and higher
Any station running Periscope must have at least 6MB available.
Officially supported browsers: latest Chrome or Firefox.

The "su" global permission user account must be commissioned on the SkySpark host

su stands for "Super User" and is the master account that has access to the project databases themselves, effectively granting access to the whole server to this user. Periscope utilizes the existence of this account to execute queries across the entire SkySpark cluster in order to build out the appropriate Context Sensitive Views and hierarchical information as it pertains to your projects.

Java 8 - (Oracle Download Link)

While SkySpark will technically run on it's own with Java 7, Periscope itself has dependencies on Java 8 - remaining in-line with Niagara's Java 8 dependencies.

If not on JAVA 8, it will be immediately obvious when attempting to enable the extension later on because you will receive an error: "Method not mapped to java.lang.reflect correctly"

Periscope > Installation (SkySpark) > image2017-12-7_9-35-36.png

Installing Periscope

Installing Periscope Pod file

Copy the periscopeExt.pod file distributed by Activelogix into the lib/fan directory of the SkySpark installation

It's important that the host this pod is installed on matches up with the host ID that was licensed. You may find your skyspark Host ID in the diagnostics tab of the debug app.

Enabling the Extension

As an administrator, navigate to the project in SkySpark that you would like to use the extension with
Navigate to the Settings app, then click the Exts tab and select Extensions in the tree-menu on the left
Scroll until you see Periscope and click Enable

Enabling this extension will automatically use the existing Folio database and create the necessary periscope tagged records for operation. Disabling this extension will not remove these records.

Periscope works on the latest version of SkySpark version 3.0 at the time of writing. It's possible the old 2.0 style apps (such as extensions/settings) may change in later versions, if so, please see Skyspark documentation on enabling extensions.

Installing License File

The Periscope license needs to be installed separately. The license can be automatically "fetched" from our licensing server as long as the installation server has access to the internet.

Automatic Installation

In Periscope 4.0+, automatic installation is possible via the About page as an administrator next to the site chooser.

After clicking Fetch License, your license file will be downloaded from Periscope servers, copied into the appropriate directory, and loaded. You should now be able to access Periscope through a browser at http://{IP_of_host}/api/{proj}/ext/periscope. Where "{proj}" is the name of the SkySpark project the extension was enabled for previously (without the open and closing brackets).

If enabled for the demo project the URL would be:

http://host/api/demo/ext/periscope

Manual Installation

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

{SKYSPARK_INSTALL_DIRECTORY}/var/lic