If you have a maintenance window or a scheduled outage for a device then you would will likely want to suspend polling and alerts alerting for that device for during that period.  Here is how.

...

.
NMIS has supported this for a long time; NMIS 8.6.2 adds a number of new capabilities.

Managing Outage Windows using the GUI

• In the NMIS GUI Select "Service Desk" -> "Alerts" -> "Outages"  

Image Modified

• Select the device or devices involved.
• Set the start and end time of the outage window.
• Insert any reference number if required in the ticket number field

Image Modified

...

...

You can also delete outages using the GUI. You can, at this time, not update outages in the GUI.

How it works

• NMIS checks for current outages whenever alerts or escalations are processed; If an outage is current, then alerting is suppressed.
• NMIS does, however, not suspend polling during an outage.
• Furthermore, the state of nodes with current outages does not contribute to the overall health metrics and KPIs, which helps with reporting statistics so your teams performance will look better!

...

Related articles

...

• In version 8.6.2 and newer, the per-node status view displays current and scheduled/future outages prominently.
• In version 8.6.2 and newer, the events Planned Outage Open and Planned Outage Closed are raised for each polled device that enters or leaves an outage window.

Recurring Outages and Flexible Selectors (8.6.2 and newer)

In version 8.6.2 it is possible to schedule outages with much more flexibility, but that requires the use of the command line tool outage_admin.pl (see next section).

Recurring Outages

NMIS supports four frequency types: once, daily, weekly and monthly.
Each has its own start and end types, which follow the conventions for opReports' period and frequency format:

Flexible Selectors

NMIS Versions before 8.6.2 support only selection of one or more nodes by name; in 8.6.2 you can use any node configuration property to determine which devices should be subject to your outage window.
Please note that the NMIS GUI does not expose any of these advanced selectors; you have to use outage_admin.pl to make use of them.

The selectors are given in the format of outage.node.<propertyname>, and one of three comparison operations are supported:

1. Explicit Single Value
   e.g. outage.node.group=MyGroupName would select nodes that belong to group MyGroupName
2. List of Explicit Values, as individual array elements
   e.g. outage.node.nodeModel.0=net-snmp outage.node.nodeModel.1=RedBack would select nodes whose model is either net-snmp or Redback
3. Regular Expression
   e.g. outage.node.roleType=/^devel/ would select nodes whose configured roleType starts with "devel".

Managing Outages from the Command Line (8.6.2 and newer)

NMIS version 8.6.2 introduces the tool admin/outage_admin.pl, which lets you perform all outage-related operations. Simply start it without arguments and you'll be given an overview of the supported operations, like this:

/usr/local/nmis8/admin/outage_admin.pl 
Usage: outage_admin.pl act=[action to take] [extras...]
    outage_admin.pl act=list [filter=X...]
    outage_admin.pl act=create [outage.A=B... outage.X.Y=Z...]
    outage_admin.pl act=update id=<outid> [outage.A=B... outage.X.Y=Z...]
    outage_admin.pl act={delete|show} id=<outid>
    outage_admin.pl act=check [node=X] [time=T]
list: shows overview of defined outage schedules
show: displays the details for an outage
create: creates new outage schedule
 for detailed help, run ./admin/outage_admin.pl act=create
update: updates existing outage schedule
 only the given outage.A, outage.X.Y properties are changed.
check: reports which outages would apply at the 
 given time (or now) and  for one node (if given) or all nodes

To see the required/possible/expected arguments for outage creation, run it with act=create but no creation arguments, like this:

/usr/local/nmis8/admin/outage_admin.pl act=create
Supported Arguments for Outage Creation:
outage.description: free-form textual description.
outage.change_id: change management ticket identifier, used for event tagging
outage.frequency: one of 'once', 'daily', 'weekly' or 'monthly'
outage.start, outage.end: date and time of outage start and end,
 format depends on frequency
  daily: "HH:MM" or "HH:MM:SS". 24:00 is allowed for end.
  weekly: "MDAY HH:MM" or "MDAY HH:MM:SS", MDAY one of 'Mon', 'Tue' etc.
  monthly: "D HH:MM:SS", "-D HH:MM:SS", "D HH:MM", "-D HH:MM"
   D is the numeric day of the month, 1..31.  -D counts from the end of the month,
   -1 is the last day of the month, -2 the second to last etc.
  once: ISO8601 date time recommended,
   e.g. 2017-10-31T03:04:26+0000
outage.options: optional key=values to adjust NMIS' behaviour during an outage
outage.selector: any number of criteria for selecting devices for this outage
  selector keys: node.X or config.Y, node config or global config properties
  selector values: single string, /regex string/ or array or single strings.
  arrays must be given as separate indexed entries.
  all selectors must match for a node to be subject to the outage.
example: ./admin/outage_admin.pl act=create \
outage.description='certain nodes are busy each month start' \
outage.change_id='ticket #42' \
outage.frequency=monthly outage.start="1 12:00" outage.end="1 13:30" \
outage.selector.node.group.0="busybodies" \
outage.selector.node.group.1="alsobad"