Maps

Maps

This page describes Open-AudIT version 7. Content for earlier versions is kept further down the page, under Pre version 7.

Maps

What is it?

Your estate, drawn on an actual map. Every location you've given coordinates appears as a marker on an interactive world map, and each marker opens to show the site's details and a count of its devices, linked through to the lists. It's the geographic answer to "what do we have, and where?".

You'll find it at menu > Manage > Maps. It is a feature available to Open-AudIT Professional and Enterprise licensed customers.

What does it do?

It draws your locations. The map takes every location visible to you that has usable coordinates and places a marker, using the location type's icon. Pan and zoom like any modern map. Click a marker and the popup shows the location's name, linked to the location itself, and its device count, linked to the filtered device list, so the map is a navigation surface, not just a picture. The mapping is standard OpenStreetMap-based tiles, with nothing to sign up for and no API key to manage.

The data all comes from Locations. There's nothing to create here. The map renders what the Locations collection holds, so a site missing from the map means a location missing its coordinates, and fixing the location fixes the map.

Why?

Geography is how people actually think about sites. A list of location names means little to someone new. A map of markers is understood in a glance, which makes this the page that orients new staff, visiting auditors and managers fastest.

Coverage gaps are visible. A region with sites but thin device counts, or a site you know exists that isn't on the map at all, is the kind of thing a list hides and a map makes obvious.

How?

Give your locations coordinates. That's the whole setup. Edit each location at menu > Manage > Locations and set its latitude and longitude, then open menu > Manage > Maps and the markers are there. A location without devices still appears, its popup just counts zero, and a location without coordinates is skipped.

The other kind of map. This page is geography. The network topology map, the gateway, switches and everything hanging off them for one subnet, lives on each network. Open a network at menu > Manage > Networks and use its Map button. The Networks page has the details.


Pre version 7. Everything below this line describes Open-AudIT before version 7. Menus, screens and behaviour may differ.

Pre version 7

Introduction

Maps are part of the Open-AudIT Enterprise suite. Maps are designed to show your locations and the devices in those locations using Google Maps.

Enabling Maps

Maps should not need to be enabled as such. The correct value should be in the Open-AudIT config by default.

If the correct value has been removed or changed, click the menu item Admin -> Config and set the correct URL for opMaps. This will enable a link on the opMaps icon in the header of the Open-AudIT pages. The default value for this config item is /omk/oae/map.

Open-AudIT ships with a Default Location (Gold Coast, Queensland, Australia). All devices are initially assigned to the Default Location. Devices may have their location changed as required either individually or using the Bulk Edit functionality.

Creating a Location

Click the menu item Admin -> Locations -> Add Location. Adding Locations for Maps is very easy. Enter the complete location address details and click the "Get Lat / Long" button. You should see the latitude and longitude fields populated. These values are derived by submitting the location details to the Google API for Maps. You can also enter the Lat / Long manually. If you would prefer a different Lat / Long to the actual address details, but don't know the actual Lat / Long, you can populate the GeoCode field and click the "Get Lat / Long" button. This will populate the Lat / Long fields with the GeoCode address, rather than the entered address details. If both GeoCode and address details are populated, the "Get Lat/Long" button will use the GeoCode as preferred.

Select the "Activate Group" checkbox so that a Group will be created that will auto update when any devices are assigned to the given location.

Assigning a Device to a Location

To assign a device to a location you can view the device details and go to Summary -> Location / Contact on the left side menu. Clicking the blue dash (or text if already populated) in the Location Name field will change it to a drop down box. You can then select the location you wish the device to be allocated to.

Assigning Multiple Devices to a Location

To assign multiple devices to a location (say for example all devices in a selected subnet Group), you can view any Group list as an Open-AudIT Admin user and select the devices you need by the check boxes on the right side of the Query. If you select the check box in the column header, all devices will be selected. Next click the "Edit" button in the Query table header. You can then edit any manual fields, but importantly you can change the location of all selected devices. Click the Submit button at the bottom of the form to enact the change.

Once you have locations created, Groups created, devices assigned to locations and the URL for opMaps populated, you can click the opMaps icon in the header and be sent to the Open-AudIT Enterprise Maps web page. The page will show all your locations and when a location is clicked a summary of the number of each type of device in that location. If you click the Location Name in the popup, you will be sent to the Open-AudIT Group for that Location. If you click a device type, you will be sent to the Open-AudIT Group for that Locations, but will only the devices of the type you selected in the view.

NOTE - For a location to appear on the map, it must have a Group and devices in that Group.

An example of the Maps page is below.