From OpenNMS

Setting Up An On-call Calendar

This document is assuming you have setup more than one user and you have created a group. The group that we will be working with is called ServerAdmins, make sure you have added some users to the group.

Starting out

From the main window of OpenNMS select Admin from the menu options then Configure Users, Groups and Roles. From the Configure Users, Groups and Roles window, select the Configure Roles.

Create a Role

1. Click on the New Role button
2. Enter the name of the role: “ServerAdminsRole”
3. Set the Supervisor for the Role: “Select a Name”
4. Create a Description: “OS Administrators”
5. Select a Membership Group: “ServerAdmins”
6. Select save.

Setup the ServerAdminsRole Schedule

1. Click on the Role, (ServerAdminsRole)
2. Click on the plus icon
3. In the Edit Schedule Entry select the User: Insert User name
4. In the Edit Schedule Entry select the Start Date: Oct 3rd 2005
5. In the Edit Schedule Entry select the Start Time: 8:00 am
6. In the Edit Schedule Entry select the End Date: Oct 17th 2005
7. In the Edit Schedule Entry select the End Time: 8:00 am
8. Repeat steps 3-7 for as many users you have in the ServerAdmins group, starting with the End Date of the previous user. Unless you want to have a gap in the schedule, make sure the end time of the previous user is the same as the start time of the next user.

Removing a Schedule Element

Currently there is no graphical way to remove an entry describing which user is on call during a given time period for a given role. You will instead need to edit the groups.xml file by hand. The on-call roles are defined in the <roles> element, which follows the <groups> element. Each on-call role (e.g. ServerAdminsRole from above) is described in a <role> child element, and each <role> can have zero or more <schedule> elements, each of which describes a user being on call for a given time period. An example role with a single schedule element would look like:

<role name="ServerAdminsRole" membership-group="ServerAdmins" supervisor="joe_manager" description="On-call role for server admins">
    <schedule name="johnny_oncall" type="specific">
        <ns2:time xmlns:ns2="http://xmlns.opennms.org/xsd/types"
            begins="23-Mar-2009 20:00:00" ends="24-Mar-2009 05:00:00"/>
    </schedule>
   <!-- A -->
    <schedule name="joe_manager" type="specific">
        <ns2:time xmlns:ns2="http://xmlns.opennms.org/xsd/types"
            begins="23-Mar-2009 20:00:00" ends="24-Mar-2009 05:00:00"/>
    </schedule>
   <!-- B -->
</role>

To remove joe_manager from the on-call rotation, leaving poor johnny_oncall all by himself, simply remove everything between the A and B comments. No restart of openNMS is necessary for this change to take effect.