MOTOROLA SOLUTIONS

COMPASS DECISION
MANAGEMENT
SYSTEM™
VERSION 2.2.2.X

INSTALL AND
MAINTENANCE GUIDE
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

THIS MANUAL WAS CREATED ON FRIDAY, NOVEMBER 19, 2021.

DOCUMENT ID: IU-AG-MAN002-1
COPYRIGHT, TRADEMARKS, AND DISCLAIMERS
COPYRIGHT © MOTOROLA SOLUTIONS - COMPASS DECISION MANAGEMENT SYSTEM™ VIDEO SECURITY & SOLUTIONS.
TRADEMARKS
Compass Decision Management System is a registered trademark of Motorola Solutions. Microsoft and
Windows are registered trademarks of Microsoft Corporation. App Store is a service mark of Apple Inc.
Android is a trademark of Google Inc. All other trademarks mentioned in this document are trademarks of
their respective owners.
DISCLAIMER
This text is intended for general information purposes only, and due care has been taken in its preparation.
Any risk arising from the use of this information rests with the recipient, and nothing herein should be
construed as constituting any kind of warranty. Motorola Solutions reserves the right to make adjustments
without prior notification. All names of people and organizations used in the examples in this text are
fictitious. Any resemblance to any actual organization or person, living or dead, is purely coincidental and
unintended. This product may make use of third-party software for which specific terms and conditions
may apply.

INSTALL AND MAINTENANCE GUIDE

PAGE II
V1
TABLE OF CONTENTS

Copyright, trademarks, and disclaimers ii

Trademarks ii
Disclaimer ii

1 ABOUT THIS GUIDE 5

Safety notices 5

2 OVERVIEW 6
Installation components 6
Integrations 7

MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

3
INSTALLATION 8
Before you begin 8
Install Compass 9
Single server 9
After installation 11
Other software 11

4 LICENSE MANAGER INSTALLATION 12

Use a permanent license 12
Create and send a fingerprint file 12
Apply a license file 12
Use the 60 day trial license 13

5 UPGRADES 14
Upgrading Motorola Solutions Compass Decision Management System™ 14

6 INSTALLING INTEGRATION DRIVERS IN REMOTE SERVERS 15

7 ACTIVE-PASSIVE FAILOVER ARCHITECTURE 17

System setup 18
Pre-configuration 18
Active Directory Domain 19
Install Motorola Solutions Compass Decision Management System™ 22
Database replication 22
DFS replication 23
Motorola Solutions Compass Decision Management System™ activation shortcut 24
Activate the Compass secondary instance 25
The Compass primary instance in the replica role 25
Resume the pre-failure configuration 26

INSTALL AND MAINTENANCE GUIDE

PAGE III
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

8 .NET FRAMEWORK 3.5 28

9 FIREWALL REQUIREMENTS 29

10 CONFIGURE ANTI-VIRUS 30
Prevent data write issues 30
Prevent network communication failure 30

11 MANAGING CERTIFICATES 31
Replace a self-signed certificate with a trusted certificate 31

12 UNINSTALL COMPASS 32

13 TROUBLESHOOTING 33
Database update 33
Reset database 33
Other tools 34

14 FREQUENTLY ASKED QUESTIONS 35

INSTALL AND MAINTENANCE GUIDE

PAGE IV
V1
1 ABOUT THIS GUIDE

This guide is written for users of the Motorola Solutions Compass Decision Management System™
software version 2.2.2.X. It provides installation and configuration information for the system variants, as
well as a description of the hardware and specifications.
Please ensure you read the instructions provided in the guide before using the system.

SAFETY NOTICES
This guide uses the following formats for safety notices:

Indicates a hazardous situation which, if not avoided, could result in death or serious injury.

Indicates a hazardous situation which, if not avoided, could result in moderate injury, damage the
product, or lead to loss of data.

Indicates a hazardous situation which, if not avoided, may seriously impair operations.

Additional information relating to the current section.

INSTALL AND MAINTENANCE GUIDE

PAGE 5
V1
2 OVERVIEW

Motorola Solutions Compass Decision Management System™ is a web application that manages security
systems from different vendors in a single platform, with step-by-step procedures and auditing tools.
Compass can be installed in the following ways:
• On a single server.
• On a primary server and fail-over server.
► For more information, refer to the Motorola Solutions Compass Decision Management System™
User Guide.

INSTALLATION COMPONENTS
Compass installations include several components.
COMPASS Server
Used for configuring sites and devices, handling alarms, viewing live and recorded videos, and getting
reports and charts. COMPASS server runs on the Apache® Tomcat 7 web server.
Compass Manager
Used for checking if all Compass components and drivers are working properly. For drivers, Compass
Manager works like a load balancer - when a new task appears, Compass Manager checks the load of
each driver, and assigns the task to the driver with the lower load.
CompassLicenseServer
The HTTP service wrapper for the licensing tool.
Compass ServicesAdapter
The gateway, encryption and authentication tool used between drivers and Compass Backend. Compass
ServicesAdapter allows incompatible API versions to communicate with each other.
Compass VideoAdapter
Used for transferring HTML5 videos from drivers to COMPASS server.
ElasticSearch
Full text storage and search engine for alarms and events data. Used to generate reports' charts with
Kibana.
Kibana
Data visualization tool used to generate reports' charts with the data from ElasticSearch.
Compass Database (Compass DB)
The database where all Compass information is stored. Compass uses MariaDB as its default database
server.

INSTALL AND MAINTENANCE GUIDE

PAGE 6
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

INTEGRATIONS
Compass communicates with several equipment types, for example, cameras, intrusion/fire panels, and
other sensors from several manufacturers.
To communicate with each manufacturer Compass requires the installation of a specific integration driver.
To install each integration driver, refer to the specific Integration Guide for your device(s).

The integration driver can be installed in the COMPASS server. Server drivers from different
manufacturers can run in the same COMPASS server. The installation of integration drivers in
remote servers is also supported.

When an integration driver is installed, Compass automatically runs two instances of each driver. In
some cases it can be recommended to run more than two instances. Refer to the specific
Integration Guide for your driver(s).

For certain drivers, a configuration where the driver runs in a remote server only, and not in the
COMPASS server is not recommended. Refer to the specific Integration Guide for your driver(s).

INSTALL AND MAINTENANCE GUIDE

PAGE 7
V1
3 MOTOROLA SOLUTIONS COMPASS
DECISION MANAGEMENT SYSTEM™
INSTALLATION

This section provides information on the installation of Motorola Solutions Compass Decision Management
System™ on a single server.

For the installation of each integration driver, refer to the corresponding Integration Guide.

BEFORE YOU BEGIN

Before you begin, make sure you have completed the requirements given in Table 1.

TABLE 1 PRE-INSTALLATION CHECKLIST

REQUIREMENT ✓

A clean installation of Windows Server 2019. c

Enabled the .Net 3.5 Framework feature in Windows Server Manager. See ".NET Framework 3.5" on page
28. c

A static IP for Windows Server. c

A static Mac address. c
Setup a shared Windows folder on a backup server. c
Make sure that no software or services use the reserved ports. See "Firewall requirements" on page 29. c
The latest versions of Google Chrome and/or Firefox installed on Windows Server. c
Enabled Remote desktop protocol (RDP) access for remote access. c
Downloaded a copy of the latest Compass software using the URL provided by your Compass reseller. c

A static Mac address is only required if the Windows Server runs on a Virtual machine (VM).

It is recommended that you setup a Windows shared folder on a backup server to allow Compass to
backup database information automatically.

Make sure there are no previous installations of Windows Roles or MySQL/MariaDB databases.

INSTALL AND MAINTENANCE GUIDE

PAGE 8
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

INSTALL COMPASS
The installation process for Compass is different for the single server and for the remote server.

SINGLE SERVER
To install Compass on a single server:
1. Unzip the provided Compass software installer package.
2. Run COMPASS_v2.1.[X].[X]_Setup.exe as administrator.
3. On the COMPASS Database and Plugin Setup page, enter the data given in Table 2.
4. Select Next.
5. On the COMPASS Server Setup page, enter the data given in Table 3.
6. Select Next.
7. On the COMPASS Backup Setup page:
a. Select the backup folder for the Compass automatic backup function.
b. Select the backup frequency for the Compass automatic backup function.
We recommend a daily backup.

Compass needs to backup to a folder outside of the server. The recommended configuration is one
of the following:
• A shared network folder with no access credentials.
• A pen drive in the Compass physical server so Compass can backup automatically.

Compass recommends backing up daily.

8. Select Next.
9. Accept the License Agreement.
10. Select Next.
11. On the Select Destination Location page, specify the installation location for COMPASS.
12. Select Next.
13. On the Select Components page, select COMPASS Base.
14. Select Next.
15. On the Ready to Install page, select Install to start the Compass installation.
16. Select OK to confirm the installation of a self-signed certificate. See "Managing certificates"
on page 31.
17. On the Welcome to the Sentinel Runtime Installation Wizard page, select Next to install
Gemalto License Manager.
18. Accept the License Agreement.
19. Select Next.
20. On the Ready to Install the Application page, select Next to start the installation.
21. Select Finish.
The Sentinel Run-time Environment Installation dialog opens.
22. Select OK.
23. On the Completing the COMPASS Setup WIzard page, select Finish to exit setup.

INSTALL AND MAINTENANCE GUIDE

PAGE 9
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

After installation, it is recommended that you replace the automatically installed self- signed
certificate with your own certificate.

After installation, open the latest version of Google Chrome or Firefox and enter the following URL:
https://<compassserverIP>.

TABLE 2 DRIVER SETUP PARAMETERS

PARAMETERS DESCRIPTION

The initial TCP port number to be used by Compass drivers.

Initial Port for Plugins
The default initial port is set to 9100.
Database IP The IP of the database server *.

The IP port for Compass to communicate with the database.

Database Port
The default value is 3306.
* This parameter must not be changed.

TABLE 3 SERVER SETUP PARAMETERS

PARAMETERS DESCRIPTION

The IP address of the HTTP/HTTPS server.

IP
By default this is the localhost IP.

Port The IP port of the HTTP/HTTPS server *.

Additional Server IP An alternate IP address of the HTTP/HTTPS server *.

* This parameter must not be changed.

INSTALL AND MAINTENANCE GUIDE

PAGE 10
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

AFTER INSTALLATION
After installation, make sure you have completed the requirements given in Table 4.

TABLE 4 POST-INSTALLATION CHECKLIST

REQUIREMENT ✓

Activated a license to use the application features. See "License Manager installation" on page 12. ઙ

Installed drivers for your devices. c

Configured antivirus settings for the COMPASS server and services. See "Configure anti-virus" on page
30. c

Added a trusted CA-signed certificate to the COMPASS server. See "Managing certificates" on page 31. c
Configured the software. See the Configuration Guide. c

For information on installing drivers for your devices, refer to the specific Integration Guide for your
device(s).

After installation, if you cannot access the Compass login page, do one or more of the following, as
necessary:
• Confirm that all Compass services are running. If one of the services if not running, try to
restart.
• Make sure that you are using the correct URL.
• Make sure that the ports used by the COMPASS server are not being used by other
applications. See "Firewall requirements" on page 29.
• Confirm with your Network Administrator that the workstation you are using to access the
COMPASS server can route IP traffic to COMPASS server ports. See "Firewall requirements"
on page 29.
If some services do not run after installation, you may need to set up exceptions in the anti-virus software
running on COMPASS servers. For more information, refer to your anti-virus software manual.

OTHER SOFTWARE
The following softwares are recommended to use with Compass:
• Notepad++: Download Notepad++.
• 7zip: Download 7zip.

INSTALL AND MAINTENANCE GUIDE

PAGE 11
V1
4 LICENSE MANAGER INSTALLATION

You must install Motorola Solutions License Manager with an up-to-date license on the server.

USE A PERMANENT LICENSE

To use a permanent Motorola Solutions License Manager file, do as follows:

CREATE AND SEND A FINGERPRINT FILE

Motorola Solutions Compass Decision Management System™ is licensed to run on specific computers.
Compass's license code must include the information required to identify the computer in the form of a
fingerprint file. To create a fingerprint file, do as follows:
1. From the Windows menu, start the Motorola Solutions License Manager.
2. On the License Manager page, select Request a new Motorola Solutions license.
3. Click Next.
4. Choose where to save the License Manager fingerprint file and click Next.
The License Manager shows the location of the new fingerprint file and contact details for
Motorola Solutions Sales Orders.
5. Send the fingerprint file to Motorola Solutions Sales Orders with your Motorola Solutions
order acknowledgement number.
Motorola Solutions will provide a license file.

APPLY A LICENSE FILE

You can use the License Manager tool to apply your Motorola Solutions license file to the License Server.
Do as follows:
1. From the Windows menu, start the Motorola Solutions License Manager.
2. On the License Manager page, select Apply a new or updated Motorola Solutions license.
3. Click Next.
4. Select the Motorola Solutions license file that was sent to you, and click Next.
5. Click Finish.
The new license is applied.
6. Restart the COMPASSServer.
7. Enter the following command prompt to terminate the COMPASSServer process:
taskkill /fi “SERVICES eq COMPASSServer” /f
8. Login with the default credentials given in Table 5.

Compass will request that you change your password when you first login.

TABLE 5 DEFAULT LOGIN CREDENTIALS

USERNAME PASSWORD

Administrator admin

INSTALL AND MAINTENANCE GUIDE

PAGE 12
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

USE THE 60 DAY TRIAL LICENSE

To use a trial Motorola Solutions License Manager license, do as follows:
1. Start the Motorola Solutions License Manager at C:\Program Files
(x86)\IndigoVision\LicenseManager.
2. Download the Compass_trial_60days.v2c file provided by your reseller and run the Motorola
Solutions License Manager again.
3. On the License Manager page, select Apply a new or updated Motorola Solutions license.
4. Click Next.
5. On the License Manager - Apply License page select the downloaded V2C file that was sent
to you.
6. Click Next.
7. Click Finish.
8. Restart the COMPASSServer.
9. Enter the following command prompt to terminate the COMPASSServer process:
taskkill /fi “SERVICES eq COMPASSServer” /f
10. Login with the default credentials given in Table 6.

Compass will request that you change your password when you first login.

When the trial license expires, contact your reseller to get a permanent license.

TABLE 6 DEFAULT LOGIN CREDENTIALS

USERNAME PASSWORD

Administrator admin

INSTALL AND MAINTENANCE GUIDE

PAGE 13
V1
5 UPGRADES

Before the upgrade starts, the Motorola Solutions Compass Decision Management System™ installer
makes a backup of all the current version application files to the bck folder.
The new application files are then extracted to a folder with _newversion as a suffix. This keeps the
Compass instance running until it is necessary to stop all services and replace old files with new files.

The process stops Compass services for a minimum time at the cost of requiring more disk space.

To successfully upgrade the system, you must upgrade Motorola Solutions Compass Decision
Management System™ then update the database.

The anti-virus may check all files which can slow the copy process.

UPGRADING MOTOROLA SOLUTIONS COMPASS

DECISION MANAGEMENT SYSTEM™
To upgrade Compass, do as follows:
1. Download the installer (ZIP file) using the URL that was provided to you.
2. Unpack the ZIP file.
3. Run the provided Compass installer package COMPASS_v2.1.[X].[X]_Setup.exe
as administrator.
4. If Windows warns that it cannot verify who created the file, select Run.
5. On the Setup dialog, select Yes.
The installer shows the version currently installed and which version Compass will be
upgraded to.
6. On the Ready to Install page, click Install to start the upgrade.
7. On the Setup dialog you will be informed that all COMPASS services will be stopped, click
OK to continue.
8. When the update is complete, select OK.
Now you can open the Compass URL https://<compassserverIP> and log in.

The transfer of files and folders to a backup folder can take up to 40 minutes, depending on the
computer configuration.

INSTALL AND MAINTENANCE GUIDE

PAGE 14
V1
6 INSTALLING INTEGRATION DRIVERS IN
REMOTE SERVERS

The integration driver must be installed on a remote server, or multiple remote servers, when
recommended in the driver Integration Guide. Motorola Solutions Compass Decision Management
System™ components must be installed in each remote server to support the manufacturer driver.

A single server must be installed before you can install drivers on a remote server. See "Single
server" on page 9.

This procedure is used for installing integration drivers in remote servers.

Before you begin, follow the pre-installation checklist. See "Before you begin" on page 8.

To install Compass on a remote server, do as follows:

1. Unpack the Zip file.
2. Run the provided Compass installer package COMPASS_v2.1.[X].[X]_Setup.exe
as administrator.
3. In the COMPASS Agent Setup page, enter the data given in Table 7.
4. Click Next.
5. In the COMPASS Server Setup page, enter the data given in 6 .
6. Click Next.
7. Follow the single server installation procedure. See "Single server" on page 9.
8. Install the required driver.

For information on installing drivers for your devices, refer to the specific Integration Guide for your
device(s).

9. In Windows Explorer, go to the driver's directory: %COMPASS_PATH%\drivers.

10. In the driver's directory, edit the conf\agent.properties file by adding/editing the following
lines:
backendUrl=http://COMPASS_SERVER_IP
service-adapter.url=https:// COMPASS_SERVER_IP
:8443/compassAPI
11. Run the register.bat file as an administrator to register the driver on the system.

INSTALL AND MAINTENANCE GUIDE

PAGE 15
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

TABLE 7 INTEGRATION DRIVER SETUP PARAMETERS

PARAMETERS DESCRIPTION

Driver Port The first port number of the driver port range.

The IP of the database server.

Database IP By default this is the localhost IP. If the database is on another server, enter the COMPASS
server IP address.

Database The IP port for Compass to communicate with the database.

Port The default value is 3306.

TABLE 8 SERVER SETUP PARAMETERS

PARAMETERS DESCRIPTION

The IP address of the HTTP/HTTPS server.

IP
By default this is the localhost IP.

The IP port of the HTTP server.

Port
The default value is 80.
An alternate IP address of the HTTP/HTTPS server.
Additional Server IP
By default this is the localhost IP.

INSTALL AND MAINTENANCE GUIDE

PAGE 16
V1
7 ACTIVE-PASSIVE FAILOVER
ARCHITECTURE

1
If you are updating from Agora/Agora-Indigo to Compass, your domain will remain agora.local, and
the computer names will remain Agora-Primary and Agora-Secondary.
Replace these within the commands given in this section.

This section provides information about the active-passive failover architecture. The role of the failover
architecture is to activate the secondary Motorola Solutions Compass Decision Management System™
instance when the functionality of the primary Compass instance is compromised.
The active-passive failover architecture consists of the following elements:
• Two identical servers with Compass installed:
• The primary Compass instance.
This is the active in-production instance.
• The secondary Compass instance.
This is the back-up instance, ready to be manually put in production at any time.
• A database and file system synchronization mechanisms.
Used to activate the secondary Compass instance in a state as close as possible to the state
of the primary Compass instance.
• The database synchronization mechanism.
Based on the primary/replica replication functionality provided by MariaDB. The
changes that Compass makes to the database are logged by the server, and
asynchronously replicated to the replica.
• The synchronization of the media and report PDF files stored in the file system Data path.
Based on Microsoft's Distributed File System (DFS) replication functionality. See "DFS
replication" on page 23.

INSTALL AND MAINTENANCE GUIDE

PAGE 17
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

FIGURE 1: ACTIVE-PASSIVE FAILOVER ARCHITECTURE DESIGN

SYSTEM SETUP
This section provides information about the setup of the Compass primary instance and the Compass
secondary instance.

PRE-CONFIGURATION
Pre-configuration of the Compass primary instance and the Compass secondary instance consists of
assigning a static hostname to each instance.
To set the hostnames of the Compass instances:
1. Open the Run command window.
2. In the Run command window, run the following commands:
a. dism /online /enable-feature /featurename:OEM-Appliance-
OOBE
b. C:\Windows\System32\Sysprep\Sysprep.exe /generalize /oobe
/reboot
The system reboots and reloads with the new configuration. The Initial Configuration Tasks
window is displayed.
3. From the Provide Computer Information category, select Provide computer name and
domain.
The System Properties window opens.
4. Select the Computer Name tab.
5. Select the Change button.
The Computer Name/Domain Changes window opens.

INSTALL AND MAINTENANCE GUIDE

PAGE 18
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

6. In Computer name, enter the new computer name:

• For the Compass primary instance, enter Compass-Primary.
• For the Compass secondary instance, enter Compass-Second.
7. Confirm the change with the OK button.
8. In System Properties, select OK to close the window.
A system restart window is displayed.
9. To restart the system, select Restart Now.

ACTIVE DIRECTORY DOMAIN

To enable DFS replication, you need to set up Active Directory Domain, with both Compass instances
acting as Active Directory Domain Controllers.
Definitions used in this section:
• Active Directory (AD): A technology used to manage computers and other devices on a
network.
• A domain: A group of network objects, such as devices or users, that share the same Active
Directory database.

Set up Active Directory Domain on the primary Compass instance

To set up Active Directory Domain on the primary Compass instance, complete the steps below.
1. In the Network Connections control panel, set the DNS server to localhost:
a. Right-click the target network interface and select Properties.
b. In the Networking tab of the network properties window, highlight Internet Protocol
Version 4 (TCP/IPv4) and select Properties.
c. In the Internet Protocol Version 4 (TCP/IPv4) Properties window, select Use the following
DNS server addresses.
d. In the Preferred DNS server field, enter 127.0.0.1.
e. Save your changes.
2. In Server Manager, add the Active Directory Domain Services role:
a. In the upper bar, select Manage > Add Roles and Features.
b. In the Add Roles and Features Wizard window, select Next.
c. On the Installation Type page, select Role-based or feature-based installation, and select
Next.
d. On the Server Selection page, from the server list select the COMPASS server, and
select Next.
e. On the Server Roles page, select Active Directory Domain Services.
f. If the Add features that are required for Active Directory Domain Services window
opens, select the Include management tools (if applicable) checkbox, and select Add
Features.
g. On the Features page, select the .NET Framework 3.5 Features checkbox.
h. Make sure that under .NET Framework 3.5 Features, HTTP Activation and Non-HTTP
Activation are not selected.
i. Select Next.
j. On the AD DS page, select Next.
k. On the Confirmation page, select Install.
l. If prompted, install any requested additional components.
m. On the Results page, you can view the installation progress.
When the installation is complete and the role is successfully added, select Close.

INSTALL AND MAINTENANCE GUIDE

PAGE 19
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

3. In Server Manager, install Active Directory Domain Services and create a domain:
a. Select the notification icon.
b. In the Post-deployment Configuration message, select Promote this server to a domain
controller.
The Active Directory Domain Services Configuration Wizard window opens.
c. On the Deployment Configuration page, under Select the deployment operation, select
Add a new forest.
d. In the Root domain name field, enter compass.local, and select Next.
e. On the Domain Controller Options page, from the Forest functional level list, select
Windows Server 2016.
f. Under Specify domain controller capabilities, make sure the Domain Name System
(DNS) server checkbox is selected.
g. In the Password field, enter a new password for the Directory Services Restore Mode
(DSRM) administrator.
This password will be used to repair or restore an Active Directory database, if needed.
h. Select Next.
i. On the DNS Options page, select Next.
j. After the wizard verifies the NetBIOS domain name, select Next.
k. On the Paths page, select Next.
The default values for Database folder, Log files folder, and SYSVOL folder are used.
l. On the Review Options page, review the summary of your selections, and select Next.
m. On the Prerequisites Check page, when the validation of prerequisites is complete,
select Install.
n. When the installation is complete, select Close.
The server restarts.
4. To reconnect to your server, you need to log in:
a. Select Switch User, and then select Other User.
b. In the user name field, enter compass.local\Administrator.
c. Enter the password that you created.
d. Select the Login button.

Set up Active Directory Domain on the secondary Compass instance

To set up Active Directory Domain on the secondary Compass instance, complete the steps below.
1. In the Network Connections control panel, set the DNS server to the IP of the Compass
primary instance:
a. Right-click the target network interface and select Properties.
b. In the Networking tab of the network properties window, highlight Internet Protocol
Version 4 (TCP/IPv4), and select Properties.
c. In the Internet Protocol Version 4 (TCP/IPv4) Properties window, select Use the following
DNS server addresses.
d. In the Preferred DNS server field, select IP of the Primary instance.
e. Save your changes.
2. In Server Manager, add the Active Directory Domain Services role:
a. In the upper bar, select Manage > Add Roles and Features.
b. In the Add Roles and Features Wizard window, select Next.
c. On the Installation Type page, select Role-based or feature-based installation, and select
Next.

INSTALL AND MAINTENANCE GUIDE

PAGE 20
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

d. On the Server Selection page, from the server list select the COMPASS server, and
select Next.
e. On the Server Roles page, select Active Directory Domain Services.
f. If the Add features that are required for Active Directory Domain Services window
opens, select the Include management tools (if applicable) checkbox, and select Add
Features.
g. On the Features page, select the .NET Framework 3.5 Features checkbox.
h. Make sure that under .NET Framework 3.5 Features, HTTP Activation and Non-HTTP
Activation are not selected.
i. Select Next.
j. On the AD DS page, select Next.
k. On the Confirmation page, select Install.
l. If prompted, install any requested additional components.
m. On the Results page, you can view the installation progress.
When the installation is complete and the role is successfully added, select Close.
3. In Server Manager, install Active Directory Domain Services, and set this instance as a
domain controller of compass.local:
a. Select the notification icon.
b. In the Post-deployment Configuration message, select Promote this server to a domain
controller.
The Active Directory Domain Services Configuration Wizard window opens.
c. On the Deployment Configuration page, under Select the deployment operation, select
Add a domain controller to an existing domain.
d. In the Domain field, enter compass.local.
e. Next to Supply the credentials to perform this operation, select the Change button.
f. In the user field, enter Administrator.

If the You must apply a user account message displays, enter

compass.local\Administrator.

g. In the password field, enter the previously created domain administrator password.
h. Select Next.
i. On the Domain Controller Options page, under Specify domain controller capabilities,
make sure the Domain Name System (DNS) server and Global Catalog (GC) checkboxes
are selected.
j. In the Password field, enter a password.
This can be the same password you created for the primary instance.
k. Select Next.
l. On the DNS Options page, select Next.
m. After the wizard verifies the NetBIOS domain name, select Next.
n. On the Paths page, select Next.
The default values for Database folder, Log files folder, and SYSVOL folder are used.
o. On the Review Options page, review the summary of your selections, and select Next.
p. On the Prerequisites Check page, when the validation of prerequisites is complete,
select Install.
q. When the installation is complete, select Close.
r. Restart the server.
4. To reconnect to your server, you need to log in:

INSTALL AND MAINTENANCE GUIDE

PAGE 21
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

a. Select Switch User, and then select Other User.

b. In the user name field, enter compass.local\Administrator.
c. Enter the password that you created.
d. Select the Login button.
When you complete this procedure, both computers should be displayed in the Domain Controllers option,
under the Active Directory role.

Additional settings
The DNS server service can be memory-consuming. To prevent such issues, do as follows:
1. In the Network Connections control panel, set the DNS server to the IP of the Compass
primary instance as follows:
a. Right-click the target adapter and select Properties.
b. In the Networking tab of the network properties window, clear the Internet Protocol
Version 6 (TCP/IPv6) checkbox.
c. Save your changes.
2. In the command-line interface, run the following commands:
Dnscmd /Config /SocketPoolSize 10
Dnscmd /Config /EnableEDnsProbes 0
3. Restart the DNS Server service.

INSTALL MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT

SYSTEM™
To install Compass. follow the installation procedure. See "Install Compass" on page 9.

The installation procedure is the same for the Compass primary instance and the Compass
secondary instance.

Each Compass instance requires its own license, created specifically for its server hardware.

System Properties are not covered by the database replication mechanism. For this reason, if you
need to change the Compass System Properties configuration, you need to do this on both
Compass instances, and in each System Properties section respectively.

DATABASE REPLICATION
To set up database replication, do as follows:
1. On the Compass secondary instance, open the command-line interface.
2. Run the following command:
net stop COMPASSManager
3. Run the following command:

INSTALL AND MAINTENANCE GUIDE

PAGE 22
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

cd %COMPASS_PATH%\bin && ..\runtime\x86\jre\bin\java.exe -

classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool secondary_setup Compass-
Primary
4. When prompted, confirm the setup process steps.
5. When the setup process is finished, run the following command to check the status of the
synchronization mechanism:
cd %COMPASS_PATH%\bin && ..\runtime\x86\jre\bin\java.exe -
classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool secondary_status

This procedure is only for the Compass secondary instance.

DFS REPLICATION
The DFS replication management role is assumed by the Compass secondary instance. You also need to
install this role for the Compass primary instance, so that the primary instance performs DFS replication in
case of the secondary instance failover.

Set up DFS replication

To set up DFS replication, do as follows:

1. In Server Manager, add the DFS Replication Services role:
2. In the upper bar, select Manage > Add Roles and Features.
3. In the Add Roles and Features Wizard window, select Next.
4. On the Installation Type page, select Role-based or feature-based installation, and select
Next.
5. On the Server Selection page, from the server list select the COMPASS server, and select
Next.
6. On the Server Roles page, expand the File and Storage Services node and the File and iSCSi
Services sub-node.
7. Select the DFS Replication checkbox.
8. If the additional role services or features window opens, select Add Features.
9. Click Next.
10. On the Features page, click Next.
11. On the Confirmation page, select Install.
On the Results page, you can view the installation progress.
12. When the installation is complete and the role is successfully added, select Close.

Create a new DFS replication group

To create a new DFS replication group and configure the data folders on both Compass instances, do as
follows:
1. In Server Manager, select Tools > DFS Management.
2. On the DFS Management page, right-click Replication and select New Replication Group.
3. On the Replication Group Type page, select Multipurpose replication group, and click Next.
4. On the Name and Domain page, in the Name of the replication group field, enter Compass
Replication as the replication group name.

INSTALL AND MAINTENANCE GUIDE

PAGE 23
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

5. In the Domain field, enter compass.local, and click Next.

6. On the Replication Group Members page, select Add.
The Select Computers window opens.To find the computers to add, select Advance and Find
Now.
7. From the results list, select Compass-Primary and Compass-Second.
8. To confirm your choice, select OK twice.
9. Ensure that both computers are displayed in the Members list, and click Next.
10. On the Topology Selection page, select Full mesh, and click Next.
11. On the Replication Group Schedule and Bandwidth page, set the bandwidth and schedule.
If possible, we recommend selecting Replicate continuously using specified bandwidth with
Bandwidth: Full.
12. ClickNext.
13. On the Primary Member page, from the Primary member list, select Compass-Primary, and
click Next.
The primary member is always set to Compass-Primary, because DFS replication works both
ways.
14. On the Folders to Replicate page, select Add.
The Add folder to replicate window opens.
15. Browse for the path of the Compass data folder configured in the System Properties panel in
the Compass Configuration Interface, and select OK.
This is the data folder for the Compass primary instance. The folder defaults to the Data
folder in the Compass installation path.
16. Double-check the selected path, and click Next.
17. On the Local Path of data on the Other Members page, select the Compass-Second member,
and select Edit.
18. In the Edit window, select Enable.
19. Browse for the path of the Compass data folder configured for the Compass secondary
instance.
20. Double-check the selected path, and select Next.
21. On the Review Settings and Create Replication Group page, select Create.
22. On the Confirmation page, select Close.
23. In the Replication Delay window, select OK.
24. Repeat See "Set up DFS replication" on page 23 and Create a new DFS replication group on
the primary Compass instance.
25. In the command-line interface, run the following command to check the DFS replication
status:
dfsrdiag ReplicationState /all

MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

ACTIVATION SHORTCUT
Compass recommends creating a shortcut to the command that executes the Motorola Solutions Compass
Decision Management System™ activation procedure. You should create the shortcut on both Compass
instances by completing the steps below.
To create the Motorola Solutions Compass Decision Management System™ activation shortcut, do as
follows:

INSTALL AND MAINTENANCE GUIDE

PAGE 24
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

1. On PC with the Compass instance, go to Desktop, or any other folder where you want to
create the shortcut.
2. Right-click in the folder and from the context menu, select New > Shortcut.
The Create shortcut window opens.
3. In the Type the location of the item field, enter the string below:
"C:\Program Files (x86)\COMPASS\runtime\x86\jre\bin\java.exe"
-classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool activate
4. Click Next.
5. In the Type a name for this shortcut field, enter Activate Compass, and select Finish.
The shortcut icon is created.
6. Right-click the shortcut icon and from the context menu, select Properties.
The Properties window opens.
7. In the Start in field, enter the path below.
C:\Program Files (x86)\COMPASS\bin
8. Select OK.

The FailoverTool activate command used in step 3 stops the failover database
synchronization mechanism.

ACTIVATE THE COMPASS SECONDARY INSTANCE

To activate the Compass secondary instance, you need to disable the Compass Replication DFS replication
group first.
To disable the Compass Replication DFS replication group:
1. In Server Manager, select Tools > DFS Management.
2. On the DFS Management page, select Replication > Compass Replication.
3. In the Memberships tab, right-click the Replicated Folder row and from the context menu,
select Disable.
4. In the confirmation window, select Yes.
5. Repeat step 3 and step 4 for the second Replicated Folder row.
To activate the Compass secondary instance:
1. On the Compass secondary instance, open the folder with the Compass shortcut.
2. Run the shortcut.
The Compass secondary instance is now active and put into production.

THE COMPASS PRIMARY INSTANCE IN THE

REPLICA ROLE
This section provides information about making the Compass primary instance perform the previous role of
the Compass secondary instance, that is, the replica role.
Before you start this procedure, you need to activate the Compass secondary instance.

INSTALL AND MAINTENANCE GUIDE

PAGE 25
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

► For more information on activating the Compass secondary instance, see "Activate the Compass
secondary instance" on page 25.
To activate the database replica role on the Compass primary instance:
1. On the Compass secondary instance, create a database dump:
a. Open the command-line interface.
b. Run the command provided below.
Replace target_db_dump_path with an actual file path, for example,
C:\Users\Compass\Desktop\filename.
cd %COMPASS_PATH%\bin && ..\runtime\x86\jre\bin\java.exe -
classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool dump_primary 'target_db_
dump_path
2. Move the created database dump file to a location on the Compass primary instance.
3. Activate the database replica role:
a. On the Compass primary instance, open the command-line interface.
b. Run the command provided below.
Replace db_dump_path with an actual file path, for example,
C:\Users\Compass\Desktop\dumpfilename.
cd %COMPASS_PATH%\bin && ..\runtime\x86\jre\bin\java.exe -
classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool secondary_setup Compass-
Primary 'db_dump_path'
4. When the procedure is finished, run the following command to confirm that the
synchronization mechanism works correctly:
cd %COMPASS_PATH%\bin && ..\runtime\x86\jre\bin\java.exe -
classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool secondary_status
To enable the Compass Replication DFS replication group:
1. From the menu Start, select Administrative Tools > DFS Management.
2. On the DFS Management page, select Replication > Compass Replication.
3. In the Memberships tab, right-click the Replicated Folder row and from the context menu,
select Enable.
4. In the confirmation window, select Yes.
5. Repeat step 3 and step 4 for the second Replicated Folder row.
6. To check the DFS replication status:
a. Open the command-line interface.
b. Run the command below.
dfsrdiag ReplicationState /all

RESUME THE PRE-FAILURE CONFIGURATION

This section provides information on how to resume the pre-failure configuration, that is:
• The Compass primary instance running as the active instance.
• The Compass secondary instance running as the replica.
To resume the pre-failure configuration, you must first complete the Compass Command and Control
replace role procedure. Only then, all data between the instances will be synchronized.

INSTALL AND MAINTENANCE GUIDE

PAGE 26
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

► For more information on activating the database replica role on the Compass primary instance,
see "The Compass primary instance in the replica role" on page 25.
To activate the Compass primary instance:
1. On the Compass primary instance, open the folder with the Compass shortcut.
2. Run the shortcut.
The Compass primary instance is now active and put into production.
To revert the Compass secondary instance to the database replica role:
1. On the Compass primary instance, create a database dump:
a. Open the command-line interface.
b. Run the command below.
Replace target_db_dump_path with an actual file path, for example,
C:\Users\Compass\Desktop\filename.
cd %COMPASS_PATH%\bin && ..\runtime\x86\jre\bin\java.exe -
classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool dump_primary 'target_db_
dump_path

This process will override the Compass database on the primary instance. Make sure this database
is up to date.

2. Move the created database dump file to a location on the Compass secondary instance.
3. Activate the database replica role:
a. On the Compass secondary instance, open the command-line interface.
b. Run the command below.
Replace db_dump_path with an actual file path, for example,
C:\Users\Compass\Desktop\dumpfilename.
cd %COMPASS_PATH%\bin && ..\runtime\x86\jre\bin\java.exe -
classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool secondary_setup Compass-
Second 'db_dump_path'
4. When the procedure is finished, run the following command to confirm that the
synchronization mechanism works correctly:
cd %COMPASS_PATH%\bin && ..\runtime\x86\jre\bin\java.exe -
classpath classes;lib/* -Djava.library.path=lib
pt.observit.failover/FailoverTool secondary_status

INSTALL AND MAINTENANCE GUIDE

PAGE 27
V1
8 .NET FRAMEWORK 3.5

.NET is a developer platform including tools, programming languages, and libraries used for building
applications running under Windows. .NET Framework is responsible for running websites and other
services/applications under Windows.
To find out more about .NET Framework, click here.

To install .NET Framework 3.5

1. Go to Server Manager.
2. In Server Manager, select Manage.
3. Select Add Roles and Features.
4. In the wizard window, select Next to get to the Select installation type page.
5. In the Select installation type page, select Role-based or feature-based installation.
6. Select Next.
7. In the Select destination server page, select the COMPASS server from the server pool.
8. Select Next.
9. In the Select server roles page, select Next to get to the Select features page.
10. In the Select features page, select the check box next to .NET Framework 3.5 Features.

Make sure HTTP Activation and Non-HTTP Activation under .NET Framework 3.5 Features are not
selected.

11. Select Next to get to the Confirm installation selections page.

12. In the Confirm installation selections page, select Install.

If requested, install any additional components.

13. When the installation is complete, click Close.

INSTALL AND MAINTENANCE GUIDE

PAGE 28
V1
9 FIREWALL REQUIREMENTS

When setting up a network of Motorola Solutions Compass Decision Management System™ equipment
that includes firewalls, the following information should be used to configure the firewalls.
Some ports must be reserved for the COMPASS server and its components. The default port configuration
is given in Table 9.

TABLE 9 FIREWALL REQUIREMENTS

PORT COMPONENT SET DURING INSTALLATION

80 COMPASS server Yes

443 COMPASS server Yes

3306 COMPASS DB Yes

5601 Kibana No

8443 HTTPS services No

9000 COMPASS streamer No

9050 COMPASS manager No

9060 COMPASS license manager No

9080 COMPASS services adapter No

9100 COMPASS agent* Yes

9200 Elasticsearch No

* A minimum of two ports will be reserved by the driver, depending on the number of devices connected to it.
For example, using the default configuration, if drivers are installed for three different manufacturers, the ports
used will be: 9100, 9102, 9104, 9106, 9108, and 9110.

INSTALL AND MAINTENANCE GUIDE

PAGE 29
V1
10 CONFIGURE ANTI-VIRUS

When anti- virus software runs an automated scan on a heavily used Motorola Solutions Compass
Decision Management System™ server, it can prevent video data from being written.
Some anti-virus software packages are equipped with live process scanning and incorporated firewalls.
These features can cause communication failures between cameras and Network video recorders (NVRs),
or between NVRs and clients.
To prevent this, you may need to set up exceptions in the anti-virus software running on COMPASS
servers. For more information on how to exclude locations and applications from scanning, see your anti-
virus software manual.

PREVENT DATA WRITE ISSUES

To make sure that the anti-virus software does not impede Compass's ability to write video data and other
important files, exclude %COMPASS_PATH% from being scanned.

Windows Defender is also an anti-virus software.

PREVENT NETWORK COMMUNICATION FAILURE

To prevent communication failure, exclude the following from having their network traffic scanned or
analyzed:
• %COMPASS_PATH%\Backend\bin\tomcat7.exe
• %COMPASS_PATH%)\licenseserver\licenseserver.exe
• %COMPASS_PATH%)\runtime\x64\jre\bin\java.exe
• %COMPASS_PATH%)\odfe\elastic\jdk\bin\java.exe
• %COMPASS_PATH%)\odfe\kibana\node\node.exe
• %COMPASS_PATH%\data

INSTALL AND MAINTENANCE GUIDE

PAGE 30
V1
11 MANAGING CERTIFICATES

By default, the Motorola Solutions Compass Decision Management System™ server uses a self-signed
certificate to secure client communications. This self- signed certificate is included in the Compass
installation, and the keystore is generated automatically during installation.
The keystore certificate includes the following information:
• Subject alternate names (SAN) property.
• The IP and hostnames of all network interfaces available on the COMPASS server.

Motorola Solutions recommends that you use a trusted CA-signed certificate or other intermediate
certificate, for example, a Windows CA or custom CA certificate.
You must be a Windows Administrator to make these changes.

By default, the self-signed certificate used by Compass is flagged by browsers as not secure.

REPLACE A SELF-SIGNED CERTIFICATE WITH A

TRUSTED CERTIFICATE
The new trusted certificate must fulfill the requirements given in Table 10.

TABLE 10 TRUSTED CERTIFICATE REQUIREMENTS

REQUIREMENT ✓

The new certificate complies with X.509 v3 standard. c

Make sure you properly set the Subject Alternative Names (SAN) with all the DNS names and IP
addresses used to connect to the COMPASS server, either by users through a web browser or by c
Compass remote servers. Make sure to include 127.0.0.1 IP address and localhost DNS name.
Make sure you provide a certificate file (.crt) and a private key file (.key). c

To replace a self-signed certificate, do as follows:

1. Copy the certificate file and the private key file to the COMPASS server.
2. Open a command line and go to C:\Program Files (x86)\COMPASS\tools\CertificateCreator.
3. In the opened command line, run the following commands:
• openssl-standalone\bin\openssl.exe pkcs12 -export -name
tomcat -in <path_to_crt_file> -inkey <path_to_key_file> -out
.keystore -password file:conf\keystore_pass.txt
• copy /y .keystore "C:\Program Files (x86)\COMPASS\conf\"
• copy /y .keystore "C:\Program Files
(x86)\COMPASS\odfe\elastic\config\"

INSTALL AND MAINTENANCE GUIDE

PAGE 31
V1
12 UNINSTALL COMPASS

If there are drivers installed, you will need to uninstall them first.

To uninstall Compass, do as follows:

1. In the search box on the Windows taskbar, enter Add or remove programs and
select it from the results.
2. Select COMPASS_v2.2.[X].[X] and click Uninstall. Then follow the directions on the screen.
The COMPASS Uninstall dialog opens.
3. Click Yes.
4. On the Uninstall wizard page, select the Remove all files checkbox if you want to remove all
files, including all the data.
5. Click Uninstall.
6. Select OK to confirm that all COMPASS services will be stopped.
7. Wait for the uninstall to finish. This can take up to 5 minutes.
8. When the uninstall is complete, select OK.

INSTALL AND MAINTENANCE GUIDE

PAGE 32
V1
13 TROUBLESHOOTING

When you use Motorola Solutions Compass Decision Management System™, it can be necessary to carry
out troubleshooting.

DATABASE UPDATE
To update the database, do as follows:
1. Open https://127.0.0.1 in your browser.
2. If a database update is required, the Login page is displayed.
3. Select Log in.
4. On the Sign in page, enter the default credentials given in Table 11.
5. Select Sign in.
6. On the System Manager page, select Update DB.
7. After completion of the update the Database successfully updated message is shown.
8. Select Shutdown server.
After shutdown the operating system will restart. This action will validate the database with
the update.

TABLE 11 DEFAULT LOGIN CREDENTIALS

USERNAME PASSWORD

Administrator admin

RESET DATABASE
To reset the Compass database, do as follows:
1. Drop the COMPASS database.
2. Create the COMPASS database again on the MariaDB server..
3. From your browser, open https://127.0.0.1/manager.
4. Enter the default credentials given in Table 12 and select Sign In.
5. On the System Manager page, select Create DB.
You must wait until the database updates successfully.
6. Select Shutdown server, and wait for several minutes.
7. From your browser, open http://127.0.0.1.
8. Login with the default credentials given in Table 12.
Compass will request that you change your password.

TABLE 12 DEFAULT LOGIN CREDENTIALS

USERNAME PASSWORD

Administrator admin

INSTALL AND MAINTENANCE GUIDE

PAGE 33
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

OTHER TOOLS
uses several tools to integrate with Compass.
Processexp
Proccessexp is available in the Compass tools folder. The primary function is to list all system processes.
Baretail
The primary function of Baretail is to show driver logs. To determine the driver, do as follows:
1. From Compass, select Configuration.
2. Select System Status.
3. Select Agents.
4. Expand the agents to find which driver is used by your device.

INSTALL AND MAINTENANCE GUIDE

PAGE 34
V1
14 FREQUENTLY ASKED QUESTIONS

Examples of Motorola Solutions Compass Decision Management System™ frequently asked questions are
given in Table 13.

TABLE 13 COMPASS FREQUENTLY ASKED QUESTIONS

ISSUE SOLUTION

I have a different SQL

No. Motorola Solutions uses a slightly modified version of MariaDB to ensure
Server database. Can I use
reliability and performance.
it instead of Compass DB?

I already have an
No. Motorola Solutions uses a slightly modified version of ElasticSearch/Kibana to
ElasticSearch/Kibana
ensure reliability and performance.
installation. Can I use it?

If you had a backup database before upgrading, recover it and update the
I got an error message with
database again. See "Database update" on page 33.
Database Update after
If you do not have a backup database or you continue to receive the same error
upgrading Compass
message, contact Customer Support.

What should I do after

Refer to the Configuration Guide, and the specific Integration Guide for your
installation to use
device(s).
Compass?

How do I view Google

The browser must be connected to the internet to view a Google Maps image.
Maps images?

Some services do not run You may need to set up exceptions in your anti-virus software. For more
after installation information, see your anti-virus software manual.

How do I live stream video? Use VLC and Onvif Device Manager to open a live stream.

Your credentials are incorrect or the device is offline.

The connection was To test the connection:
successful, but only a
• Establish a connection with Product integration.
technical logical device
was created • Insert the same credentials in Avigilon.
• Check if you can log in.

You can log in to Compass using your credentials. Go to Configuration > System
Status to view a list of logs and their status. from here, you can restart some
Where are the log files? components and download log files.
Alternatively, from Windows Explorer, access the %COMPASS_PATH% directory
and open the logs folder. You will see several log files from Compass.

Compass runs the following processes:

• COMPASSDB

What processes does • COMPASSLicenseServer

Compass run? • COMPASSManager
• COMPASSServicesAdapter
• Apache Tomcat 7.0 COMPASSserver

INSTALL AND MAINTENANCE GUIDE

PAGE 35
V1
MOTOROLA SOLUTIONS COMPASS DECISION MANAGEMENT SYSTEM™

ISSUE SOLUTION

• ElasticSearch 7.10.2 (elasticsearch-service-x64)

• Kibana

The management policy is represented by the following:

• Audit reports are deleted at 01:30 when they are older than the number specified on Configuration
> System properties > Maintenance > Business Intelligence Reports persistency (days).
• Client reports are deleted at 01:00 when they are older than the number specified on Configuration
> Sites > Site Name > General > DATA PERSISTENCY > Reports.
• Media content, for example, images and videos, are deleted hourly when they are older than the
What is the management number specified on Configuration > Sites > Site Name > General > DATA PERSISTENCY > Media.
policy? • All memory dump files are deleted at 02:30.
• Occurrence records are deleted at 00:30 when they are older than the number specified on
Configuration > Sites > Site Name > general > DATA PERSISTENCY > Reports.
• The disk space monitor runs every 10 minutes to check if free disk space is less than the number
specified on Configuration > System Properties > Maintenance > Free disk space safety window
(MB). If free disk space is less than the number specified, media older than three days is deleted.
• The logs monitor deletes log files that are older than 30 days.

The Compass folder structure is as follows:

• Backend: Represents the Apache Tomcat web server where there are other folders, for example,
webapps. This folder stores the Compass Server component.
• bin: Stores the .dll files required for the Compass Server.
• conf: Sets the Compass configuration.
• data: Stores client files, for example, images and reports.
• drivers: Stores installed drivers.

What is the Compass folder • ffmpeg: Stores ffmpeg software.

structure? • licenseserver: The license server service folder.

• logs: Records all events that occur in Compass components.
• odfe: Elasticsearch and Kibana services folder.
• runtime: Java folders.
• servicesadapter: The Services Adapter service folder.
• Streamer: The Streamer service folder.
• temp: Stores temporary files.
• tools: Stores tools, such as baretail and procexp.

My problem isn't listed If what you want to do is not available, contact your Compass reseller.

INSTALL AND MAINTENANCE GUIDE

PAGE 36
V1