OpenNMS Maps - the OpenNMS User Conference Website!

OpenNMS Maps
Antonio Russo
antonio@opennms.it

Maps: are useful?
About maps history
OpenView vs OpenNMS maps (Tarus!)‏
Visual Organization
Context Visualization
Visual Correlation
Executive require maps
Free design for maps...only hierarchy

The technology
SVG – Client side
Spring MVC – Server side
map.properties –client
configuration file
mapDispatcher-servlet.xml

Map layout: Map Panel
Background
Color #ab1100
Image -> Url
MapElement
Link
Icon
Label
Semaphore (Views: Availability, Severity, Status)‏
Dash-Array
Description

Views
Map layout: Map Panel
Availability – Calculate availability using opennms
standard api and database function
Status – Worst
status.default=nodeup
status.unknown.uei=undefined
Severity – Calculate severity
Map(severity.map=worst)‏
Node(worst)‏

Alarms
New Style:
Map layout: Alarms
• final String sqlQuery = "select nodeid,
eventuei,severity from alarms where nodeid is not null
and severity > 3 order by nodeid, lasteventtime desc";
• final String sqlQuery = "select distinct
outages.nodeid, eventuei,eventseverity from
outages left join events on events.eventid =
outages.svclosteventid where ifregainedservice is
null order by nodeid";

Map layout: Work Panel
Toolbar Menu
Map Menu: Admin Mode e Normal Mode
Node Menu: Admin Mode
View Menu: Normal Mode
Refresh Menu: Admin Mode and Normal Mode
Text Info
MapInfo
TopInfo
DownInfo
History

Map layout: contextMenu
Double click on MapElement!
Default Context Menu:
ELEMENT_ID
ELEMENT_LABEL
-----> MapElement “submap” or “node”
ELEMENT_ID=mapid if submap
ELEMENT_ID=nodeid if node

Map Access Control
-MapOwner (default admin)‏
-MapGroup (default null)‏
-MapAccess (RW|RO) RWRO
IF RW|RO then all users can access the map
IF RWRO on user that match mapOwner or
user that are in group that match mapGroup
Only OPENNMS_ROLE=ADMIN_ROLE can
modify visible maps
RWRO only in mapsadapter. No way in the Map
Gui

Map Contents
- Map.svg (start file, how can customize this file)‏
- ECMAScripts (contain SVG classes from ECMAS
used by the maps)‏
-js/helpers.js
-images/elements/
-images/background/
-response/ (jsp fro ping and traceroute)‏
-index.jsp (entry page, just load Map.svg)‏

-svgjavascript
– ApplicationHelpers.js
– ApplicationMap.js
– ApplicationMenu.js
– ApplicationVariables.js
– ApplicationWin.js
– ContextMenu.js
– ElemMap.js
– Label.js
– Link.js
– Map.js
– MapElement.js
– Menu.js
– MoveableSVGElement.js
– Node.js
– Semaphore.js
Map Contents

Map Personalization
How to add a new icon
How to add a new Background
How to personalize Context Menu
How to add a new status
How to add a new link

Enhance maps example
I want to visualiza an alarm with severity critical
when the number of errors exceed a fixed
threshold in a specified time
1) create event/alarm
uei.opennms.org/automation/eventCounts
2) create automation that trigger this
3) Define a new status in map.properties

Map OverLoad
what is this?

what is this?
Map OverLoad

Map Issues
Do not query the database, use a service very
similar to rtc
Use rtc to get availability (ie automatically
create avail categories using the map)‏
Use Rest interface or Json for client/server
communication
OnMouseMove on Safari is broken
Questions?