From OpenNMS

Contents 1 Persisting Auto-configured Maps 1.1 Description 1.2 Strategy 1.3 Acceptance 1.3.1 Step 1. 1.3.2 Step 2. 1.3.3 Automatic Map Persistence 1.3.3.1 Step 1. 1.3.3.2 Step 2. 1.3.3.3 Step 3. 1.3.4 New Node Provisioned 1.3.4.1 Step 1. 1.3.4.2 Step 2. 1.3.4.3 Step 3. 1.3.5 Node Deleted 1.3.5.1 Step 1. 1.3.5.2 Step 2. 1.3.5.3 Step 3.

Persisting Auto-configured Maps

Description

While auto-configured maps are useful, sometimes a user wants to layout a map differently than the way the auto-configuration layout. This feature defines the mechanics of User Managed automatic maps, maps that started out as auto-configured but are now managed by the user. To make this discussion easier we define the following types of maps.

Automatic map 

An Automatic map is a map that has been created automatically by using the Map Provisioning Adapter config.

User Defined map 

A User Defined map is a map that has been created by the user manually.

User Managed map 

A User Managed map is an automatic map that has been saved by the user and now only updates at the user's request. Layout and nodes are only added when the user decides they should be added. This type of map is persistent but still keeps track of the auto-configured nodes and will indicate to the user when a new nodes appear.

Strategy

1. Automatic maps are 'marked as User Managed maps' by selecting 'Save' from the menus.
2. If new devices matching the auto configured for a User Managed map are provisioned, the map will display an indication in the 'data' section to the right of the map.
3. There will be a menu item that will allow users to 'add' the new devices to a User Managed map and they will be placed in some convenient location and won't change the layout of the map.

Acceptance

Each test assumes that you start with an empty opennms database.

Before running the following tests please do the following tests.

Step 1.

Drop the opennms database then run the following

 ${opennms.home}/bin/install -dis

Step 2.

Follow the instructions from Automatic_Map_Creation and provision the set of nodes defined there.

Automatic Map Persistence

This test verifies that when you save an Automatic map, it will persist across OpenNMS restarts.

Step 1.

Check the map to view that all the nodes are there.

Step 2.

Save the 'Sites' map and proceed to change the layout. For example you could create a smiley face in the layout. Then save the map again.

Step 3.

Restart OpenNMS and view the 'Sites' map. Verify that the layout is the same.

New Node Provisioned

This test verifies that the map will notify the user that a new node has been provisioned that matches the auto-config criteria

Step 1.

Save the 'Site A' map.

Step 2.

Provision a node the is named 'site-a-host'.

Step 3.

Check the 'Site A' map and verify that it indicates that a new node has been found that matches the auto-config criteria for the map.

Node Deleted

This test verifies that when a node is deleted on a reimport of the Requisition it will be removed from the User Managed map.

Step 1.

Save the 'Sites' map.

Step 2.

Delete a node from the requisition and reimport the requisition.

Step 3.

Check the 'Sites' map and verify the the node has been deleted from the map.