User Tools

Site Tools


observer_updateset_installation

Installation

Prerequisite

The core Perspectium for ServiceNow update set must be installed prior to installing the Perspectium Observer update set. Otherwise Observer will not function properly if the core update set has not previously been installed. For any questions, please contact support@perspectium.com.

Prior to v3.15.0, Observer was included as part of the core Perspectium for ServiceNow update set and does not require a separate install. The below steps are for v3.15.0+ where Observer is disabled by default in the core update set and requires a separate update set.

Step 1: Download

Visit the Observer Releases page and request the download link from support@perspectium.com for the listed current version. The file will be in a zipped format representing an exported update set XML file. When prompted, save the file into your browser's designated Downloads folder. After saving the downloaded zip file, proceed to unzip it using your preferred method.

Step 2: Upload

Log into your ServiceNow instance and navigate to Retrieved Update Sets list. At the bottom of this list, you will discover a link Import Update Set from XML, select it. The resulting page will prompt you to Choose a file to upload, select the Choose file button and browse to where you have unzipped the file in set 1. After selecting the Update Set XML file, click the Upload button. A progress worker will show the status of the upload.

You can also refer to ServiceNow's documentation for this step here

Step 3: Preview

The previewing step is a ServiceNow feature that ensures update collisions are displayed and resolved before applying the update. Select the Preview Update Set button and wait for it to end.

You may see errors due to conflicts with updates from the core Perspectium for ServiceNow update set which is expected as both share some components. We recommend that you override all errors by selecting every conflict in the list and selecting the Accept Remote Update option at the bottom of the list.

You can access more information regarding previewing of Update Sets here

Step 4: Commit

After previewing the Update Set and making sure all conflicts are resolved, you are now ready to Commit it. Select the Commit Update Set button, after the progress dialog finishes showing the progress status, your Perspectium application will be installed.

More information about committing update set here

Step 5: Validate

Complete the installation by validating Observer is collecting metrics and sending them to Perspectium. Visit Outbound messages and filter the list by Show Matching on the value of “statsx” for the type field. You should see entries as follows:

Like other Outbound messages, these entries will have a state of “Ready” until the Perspectium job runs to send out the messages (by default the job runs every 30 seconds) at which point they will show a state of “Sent”.

Your installation is now complete!

ACL Update Set

v3.18.0

To limit the Perspectium application to only the perspectium user that is installed with the application, you can request from support the ACL update set which will add ACL rules.

ACL update sets are available for both the Perspectium Replicator and Observer applications. ACLs will be created for the following ServiceNow tables:

Table Version Access Operation Product(s)
UI Pages (sys_ui_page) 3.18.0 read Replicator, Observer

Duplicate ACLs on the same table may conflict with each other with one overriding the other. Please verify any ACLs that exist on the above tables before installing this update set.

2017/02/10 15:42 · Paul Nguyen
observer_updateset_installation.txt · Last modified: 2017/02/10 16:01 by paul