Motorola Solutions Compass Decision Management System Installation Guide

Motorola Solutions Compass Decision
Management System™
Built-In Map
Driver Version 1.4.5
Integration Guide
Part Number Title page P/N

Compass Decision Management System

This manual was created on April 19, 2023.
Document ID: IU-AG-MAN011-2
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.
Please contact the Compass Tech Support team at compasstechnicalsupport@motorolasolutions.com with any suggested corrections and/or improvements to this manual.

About This Guide

This guide is written for users of the Motorola Solutions Compass Decision Management System™. 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.

1.1 Safety notices
This guide uses the following formats for safety notices:

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

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

Notice
Indicates an important situation which, if not avoided, may seriously impair operations.
Additional information relating to the current section.

Introduction

Motorola Solutions Compass Decision Management System™ supports a built-in alternative to Google Maps, implemented by the GeoServer Web map server (WMS) application, as a geographic map.
Geographic maps can be imported and loaded to GeoServer through the following methods:

• An image file. See “Small areas” on page 7.
• An OpenStreetMap (OSM) data file. See “Large areas” on page 12.

Tip
Installation of GeoServer consumes 1 CPU core and 1024 MB of memory on the host machine.

Install GeoServer on the Compass server

For the integration with Motorola Solutions Compass Decision Management System™, GeoServer must be installed on the Compass server. To install GeoServer, do as follows:

1. Download a copy of the latest Built-In Map software using the URL provided by your Compass reseller.

2. Run geoserver-2.8.5.exe on the Compass server machine, and follow the onscreen instructions.

3. On the Java Runtime Environment page, enter C:\Program Files (x86)\Compass\runtime\x64\jre.

4. Select Next.

5. On the GeoServer Administrator page, enter the credentials given in Table 1: GeoServer login credentials, and select Next.

6. Select a port to be used by the GeoServer.
   The default port number is 8080.

7. Select Next.

8. On the Type of Installation page, check Install as a service.

9. Select Next.

10. Select Install.
    The installation will continue and when completed successfully the completed window is displayed.

11. Select Finish to exit setup.

12. To confirm that GeoServer is running, access the following link: http://[COMPASS_SERVER_HOST]:[GEOSERVER_PORT]/geoserver/web/

Table 1: GeoServer login credentials

Define a map

GeoServer can be configured for the following geographic areas:

• Small areas, for example, a city. See “Small areas” on page 7.
• Large areas, for example, countries. See “Large areas” on page 12.

4.1 Small areas
This method is recommended when the geographic area of interest is smaller than, or similar to, a city.
With this method, a raster image file can be used as a geographic map in Motorola Solutions Compass Decision Management System™. When imported, the image is displayed over a builtin, simplified world map.

Notice
For best results, Compass recommends that the minimum resolution of the image is 1 px/m.
Tip
For larger areas, including a country, continent, or the administrative region of a country, the alternative OSM data file method is recommended. See “Large areas” on page 12.
To use this method, GeoServer must be configured. To configure GeoServer, do as follows

1. Download the pre-configured zip archive folder Compass_Builtin_Map.zip using the URL provided by your Compass reseller.
2. Extract the method1.zip folder and copy the data_dir_geotiff.zip archive folder from the geotiff_source folder.
3. Stop the GeoServer 2.8.5 Windows service.
4. Delete the data_dir file from the GeoServer installation path.
5. Extract the data_dir folder from data_dir_geotiff.zip to the GeoServer installation path.
6. To allow GeoServer to use more memory than specified by default, replace wrapper\wrapper.conf in the GeoServer installation path with the values given in Table 2: Replace GeoServer values.

Table 2: Replace GeoServer values

4.1.1 Import a raster image file
Compass recommends using a raster image, for example, PNG or JPG, as a source for the geographic map.
To import a raster image, you must do as follows:

1. Geo reference the image file. See “QLandkarte” on page 8.
2. Convert the file to GeoTiff format. See “Convert image file” on page 10.

4.1.1.1 QLandkarte
To install QLandkarte GT, do as follows:

1. Download a copy of the latest Built-In Map software using the URL provided by your Compass reseller.

2. Run the QLandkarte GT installer.

3. On the QLandkarte GT Setup page, select Next.

4. Accept the license agreement, and select Next.

5. On the Choose Components page, select Next.

6. Select the path for the installation files.

7. Select Next.

8. Select Install.
   The installation begins.

9. Select Finish.

After installation, run QLandkarte GT, and do as follows to convert the image:

1. Select Map > Edit / Create Map.
2. Select Convert a TIFF into GeoTiff by geo referencing it. from the Source dropdown.
3. In the Input file: field, select the image file to be converted.
4. In the Output file: field, select the data_dir/data folder from the GeoServer installation path.
5. In the Map projection field, select the projection wizard button.
6. On the Proj4 Wizzard dialog, enter the parameters given in Table 3: QLandkarte configuration.
7. Check all Overviews checkboxes.
   An example of the configuration result is given in Figure 1.

Table 3: QLandkarte configuration

4.1.1.2 Convert image file
To convert an image file in GLandkarte GT, do as follows:

1. Select Map > Edit / Create Map.
2. Select Convert a TIFF into GeoTiff by geo referencing it. from the Source dropdown.
3. In the Input file: field, select the image file to be converted.
4. In the Output file: field, select the data_dir/data folder from the GeoServer installation path.
5. In the Map projection field, click the projection wizard button.
6. On the Proj4 Wizzard dialog, enter the parameters given in Table 4: QLandkarte configuration.
7. Check all Overviews checkboxes.
   An example of the configuration result is given in Figure 2. Table 4: QLandkarte configuration
   

8. From the Step 2 tab, select Add Ref to add reference points.

9. Drag the pin to a known position and enter the latitude and longitude values in the Coord. column. An example of the expected result is given in Figure 3.
   Notice
   When you do step , the values must be entered in the format [latitude] [longitude].
   Notice
   You must create a minimum of three reference points. The reference points must not be collinear and must be spaced far apart.

10. Select the Process tab, and wait for the process to complete with — finished —.
    This can take several minutes.

11. Restart the GeoServer 2.8.5 Windows service.
    To begin using the imported map, see “Configure Motorola Solutions Compass Decision Management System™ for maps” on page 17.

Tip
By default, Compass does not restrict the geographic area in which users can navigate. The available area of interest can be restricted. See “(Optional) Restrict map bounds to a specific geographic area of interest” on page 19.

4.1.2 Replace current map with a new raster image
If the previous map data was not imported correctly, the procedure must be completed. See “Small areas” on page 7.
After completing the procedure, or if it has already been performed, do as follows:

1. Import a raster image file, replacing the current planet.tif file with a new file. See “Import a raster image file” on page 8.
2. Clear the cached data. See “Clear cached data” on page 21.

4.2 Large areas
This method uses an OSM data file as a source for the geographic map on Compass. It is recommended when the geographic area of interest is the size of a small country, or larger.
When imported, the resulting map data is displayed over a built-in, simplified world map.

Tip
For city-sized or smaller areas, the alternative raster image file method is recommended. See “Small areas” on page 7.

To use this method, GeoServer must be configured. To configure GeoServer, do as follows:

1. Download the pre-configured zip archive folder Compass_Builtin_Map.zip using the URL provided by your Compass reseller.
2. Extract the method2.zip folder and copy the data_dir_postgis.zip archive folder from the osm_source folder.
3. Stop the GeoServer 2.8.5 Windows service.
4. Delete the data_dir file from the GeoServer installation path.
5. Extract the data_dir folder from data_dir_postgis.zip to the GeoServer installation path.

4.2.1 PostgreSQL
To configure maps for large areas, the PostgreSQL 9.5.4 database must be installed with the PostGIS 2.2.2 driver. To install PostgreSQL 9.5.4, do as follows:

1. Download a copy of the latest Built-In Map software using the URL provided by your Compass reseller.
2. Run the PostgreSQL installer on the Compass server machine, and follow the onscreen instructions.
3. Enter the password Agora05M.
4. Retype the password, and select Next.
5. Follow the onscreen instructions.
6. On the Completing the PostgreSQL Setup Wizard screen, uncheck the Launch Stack Builder at exit? checkbox.
7. Select Finish.

► To clear the PostgreSQL database and import a new OpenStreetMap file, see “Clear the PostgreSQL database” on page 22.

4.2.2 PostGIS
To install the PostGIS driver, do as follows:

1. Download a copy of the latest Built-In Map software using the URL provided by your Compass reseller.

2. Run the PostGIS installer on the Compass server machine.

3. Accept the license agreement, and select Next.

4. On the Choose Components screen, check the Create spatial database checkbox, and select Next.

5. Select Next.

6. On the Database Connection screen, enter the credentials given in Table 5: PostGIS driver credentials.

7. In the Database Name: field, enter agora_imported_osm.

8. Select Install.
   The installation begins.

9. Select No for the three popups.

10. Select Close to exit the installation screen.

Table 5: PostGIS driver credentials

4.2.3 Import an OpenStreetMap file
OSM is a collaboration of geographic information stored in various file formats. Compass recommends the file format .osm.pbf.

Tip
.osm.pbf files can be obtained from http://download.geofabrik.de/.

When you have downloaded the .osm.pbf file for your desired region, use the osm2pgsql tool on the Compass server machine to import the OSM file data to the PostgreSQL/PostGIS database. To import an OSM file, do as follows:

1. Download a copy of the latest Built-In Map software using the URL provided by your Compass reseller.
2. Extract the osm2pgsql folder to a path in the Compass server machine.
3. Open a console terminal and navigate to the extracted folder.
4. Run the following command: osm2pgsql -d agora_imported_osm –slim -C [CACHE_SIZE_MB] -U postgres -W -H localhost [OSM_DATA_FILE_PATH] The parameters are given in Table 6: osm2pgsql parameters.
5. Enter the password Agora05M, and select Enter.
   When the import process is complete, the message Osm2pgsql took XXXs overall is displayed.

To begin using the imported map, see “Configure Motorola Solutions Compass Decision Management System™ for maps” on page 17.

Table 6: osm2pgsql parameters

[CACHE_SIZE_MB]| The maximum RAM, in MB, that must be used during the import process A value of 2048 is recommended
---|---
[OSM_DATA_FILE_PATH]| The path to desired OSM data file

Notice
Depending on the size of the area covered by the imported data, the import process can take up to several hours.

Tip
If you are adding additional maps to a setup that already has one or more OSM maps installed, you must use the -a flag.

Tip
By default, Compass does not restrict the geographic area in which users can navigate. The available area of interest can be restricted. See “(Optional) Restrict map bounds to a specific geographic area of interest” on page 19.

4.2.4 Replace current map with a new OSM file
If the previous map data was not imported correctly, the procedure must be completed. See “Large areas” on page 12.
After completing the procedure, or if it has already been performed, do as follows:

1. Import a new OSM file. See “Import an OpenStreetMap file” on page 14.
2. Clear the cached data. See “Clear cached data” on page 21.

4.2.5 Disk space requirements of OpenStreetMap files
When you import an osm.pbf file of a particular region, make sure you have the following disk space available:

• 1 TB for the map of the whole world
• More than 600 GB for the map of Europe
• Usually less than 100 GB for the map of a particular country

Configure Motorola Solutions Compass Decision Management System™ for maps

After you import a map to GeoServer, it is necessary to configure Motorola Solutions Compass Decision Management System™ to use GeoServer over Google Maps. To configure Compass, do as follows:

1. In Compass, log in to Configuration.
2. Select System Properties.
3. From the left menu, select Geographic Map.
4. Check the Built-in map checkbox.
5. Enter the GeoServer port number. See “Install GeoServer on the Compass server” on page 5.

(Optional) Restrict map bounds to a specific geographic area of interest

By default, Motorola Solutions Compass Decision Management System™ does not restrict the geographic areas in which users can navigate. If necessary, to restrict the available areas of interest, do as follows:

1. From your browser, enter the URL http://[COMPASS_HOST]:[GEOSERVER_PORT]/geosever/web.

2. Enter the login credentials configured during the GeoServer installation, and select Login.
   See “Install GeoServer on the Compass server” on page 5.

3. On the left menu, select Layer Groups.

4. Check the built_in_layer checkbox.

5. Under Bounds, enter the parameters given in Table 7: Bounds parameters.

6. Select Save.

Table 7: Bounds parameters

Troubleshooting

When you use GeoServer it can be necessary to carry out troubleshooting.

7.1 Clear cached data
When a new map is imported, you must clear the cached data that corresponds to the previous data.

1. From your browser, access http://[COMPASS_HOST]:[GEOSERVER_PORT]/geoserver/web.

2. Enter the login credentials configured during the GeoServer installation, and select Login.
   See “Install GeoServer on the Compass server” on page 5.

3. On the left menu, select Tile Layers.

4. Select Empty.

5. Select OK on the Fully truncate the layers tile cache dialog.

6. Confirm that the cached data has been cleared.
   The Disk Used value should now be 0.0 B.

7.2 Check maps
To make sure that a map is working correctly on GeoServer, do as follows:

1. From your browser, access http://[COMPASS_HOST]:[GEOSERVER_PORT]/geoserver/web.

2. On the left menu, select Layer Preview.

3. Select OpenLayers.
   The OpenLayers map preview opens in a new tab.

4. Try to zoom in and out of the map view.

Tip
Each action needs time to render on the screen.

7.3 Clear the PostgreSQL database
To clear the PostgreSQL database and import a new OpenStreetMap file, do as follows:

1. Open the PostgreSQL command line by running psql -U postgres.

2. Run the following commands:
   DROP DATABASE agora_imported_osm;
   CREATE DATABASE agora_imported_osm;
   \connect agora_imported_osm;
   CREATE EXTENSION postgis;
   \q;

3. Follow the procedure described in the Import an OpenStreetMap file section.

IU-AG-MAN011 – 2

References

• Geofabrik Download Server

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>