|   Release Notes   |   ScienceLogic Support   |   Contact Documentation   |   Tips for Using the Online Documentation

 

Device Maintenance

Download this manual as a PDF file

This section describes the ways in which you can maintain devices in SL1.

Navigation tips for the SL1 user interface:

This section includes the following topics:

What is Scheduled Maintenance?

Scheduled Maintenance is a date and time when a device is put into "maintenance mode". During maintenance mode, for the selected devices SL1 will generate only events with a severity less than the system-wide Maintenance Minimum Severity setting. By default, no events are generated during maintenance. You can choose to enable or disable polling during maintenance mode. Even if polling is enabled, SL1 will collect information from the selected devices but will not generate applicable events for the devices.

SL1 includes tools that allow you to view, edit, and define scheduled maintenance for one or more devices. The Schedule Manager page allows you to schedule one-time and recurring maintenance tasks and downtime for a device. You can use the scheduled maintenance to:

When a device is in maintenance, SL1 will generate only events with a severity less than the system-wide Maintenance Minimum Severity setting. By default, no events are generated during maintenance. You can choose to enable or disable polling during maintenance mode. Even if polling is enabled during maintenance, SL1 will collect information from the device but will not generate applicable events for the device.

You can specify a "patch window" within the larger maintenance period. The "patch window" allows SL1 to limit the suppression events to a small time-frame within the larger maintenance window. For example:

Suppose you have to patch a server that is monitored by SL1. Suppose you know you will perform this task sometime between midnight and 6:00 AM. Suppose you know that the actual patch process will require only 15 minutes of downtime for the server. In SL1, you would define a maintenance window of 24:00 - 6:00 and a patch window of 15 minutes.

  1. At 24:00, SL1 generates an event saying that the server is going into maintenance mode. Because you have defined a patch window, SL1 continues to monitor this server as normal.
  2. At 3:00, you apply the patch to the server. The server reboots, and SL1 generates an event saying that the server is offline. This first event within the larger maintenance window triggers the start of the patch maintenance window.
  3. SL1 suppresses the event that triggered the patch maintenance window and instead generates an event "Patch Maintenance Window Opened".
  4. For the next 15 minutes, SL1 will suppress all events for the device.
  5. At 3:15, SL1 will generate an event for "Patch Maintenance Window Closed". This event clears the previous event "Patch Maintenance Window Opened".
  6. SL1 will now generate events for the device, even though the maintenance window extends until 6:00.

NOTE: If the patch was applied at 5:50, the server was rebooted, and SL1 generated an event saying that the server is offline, events would be suppressed only until the end of the maintenance window, 6:00, even though the patch window is 15 minutes.

What is User Maintenance?

User maintenance is an option that allows a user to manually put a device in to "maintenance mode". During maintenance mode, for the selected devices SL1 will generate only events with a severity less than the system-wide Maintenance Minimum Severity setting. By default, no events are generated during maintenance. You can choose to enable or disable polling during maintenance mode. Even if polling is enabled, SL1 will collect information from the selected devices but will not generate applicable events for the devices.

User maintenance mode is not scheduled. That is, a user must manually enable user maintenance to put a device into this mode and a user must manually disable user maintenance to turn off this mode for a device. User maintenance mode overrides scheduled maintenance for a device.

User maintenance can be enabled and disabled in the user interface or through the API. For information about using the API, see the ScienceLogic API section.

The Maintenance Minimum Severity Setting

The global Maintenance Minimum Severity setting specifies the minimum severity required for an event to be suppressed during device maintenance and user maintenance. The default value is Healthy, which causes all events to be suppressed. To change this setting:

  1. Go to the Behavior Settings page (System > Settings > Behavior).
  2. In the Behavior Settings page, select a value in the Maintenance Minimum Severity drop-down list. The choices are Healthy, Notice, Minor, Major, or Critical.
  3. Select the Save button. Events with a severity lower than the severity you chose will now be generated for all devices in scheduled maintenance mode and user maintenance mode.

Enabling and Disabling User Maintenance for a Single Device

You can enable and disable user maintenance mode in the Device Properties page.

To enable or disable user maintenance mode for a device:

Enabling and Disabling User Maintenance for One or More Devices

The Device Manager page contains a drop-down field in the lower right called Select Action. This field allows you to apply an action to multiple devices at once. From the Select Action menu, you can enable or disable user maintenance mode for multiple devices, simultaneously.

To enable or disable user maintenance mode for multiple devices:

Scheduling Maintenance for a Single Device

In the Schedule Manager page (in the Device Administration panel), you can schedule maintenance and downtime for a device.

You can also view and manage all scheduled processes from the Schedule Manager page (Registry > Schedules > Schedule Manager). For more information, see the section on Managing Scheduled Tasks.

Viewing the Schedule Manager

The Schedule Manager page (Registry > Devices > Device Manager > wrench icon > Schedule) displays the following information about each scheduled or recurring device maintenance window:

To edit a scheduled or recurring device maintenance window, click its wrench icon () and update the settings as needed on the Schedule Editor modal page. (For more information, see the section Defining a Scheduled or Recurring Device Maintenance Window for a Single Device.)

Defining a Scheduled or Recurring Device Maintenance Window for a Single Device

You can schedule a device maintenance window in SL1 from the Schedule Manager page. SL1 will automatically set the status of the device to "maintenance" at the scheduled time.

To define a scheduled or recurring device maintenance window:

  1. Go to the Schedule Manager page (Registry > Devices > Device Manager > wrench icon > Schedule).
  2. Click Create. The Schedule Editor modal page appears.

  1. On the Schedule Editor modal page, enter values in the following fields:

Basic Settings

Time Settings

If you want SL1 to automatically adjust for daylight savings time (if applicable), then you must select a named region (such as America/New York) in the Time Zone field. If you select a specific time zone (such as EST) or a specific time offset (such as GMT-5), then SL1 will not automatically adjust for daylight savings time.

If you select By Interval, the following additional fields appear:

Action Settings

For example:

Suppose you have to apply a patch to a server that is monitored by SL1. Suppose you know you will perform this task sometime between midnight and 6:00 AM. Suppose you know that the actual patch process requires only 15 minutes of downtime for the server. In SL1, you would define a maintenance window of 24:00 - 6:00 and a patch window of 15 minutes. In this scenario:

NOTE: If the patch was applied at 5:50, the server was rebooted, and SL1 generated an event saying that the server is offline, events would be suppressed only until the end of the maintenance window, 6:00, even though the patch window is 15 minutes.

  1. Click Save.

Scheduling Maintenance for One or More Devices

The Device Manager page contains a drop-down field in the lower right called Select Action. This field allows you to apply an action to multiple devices at once. From the Select Action menu, you can schedule maintenance for multiple devices, simultaneously.

To schedule maintenance for multiple devices:

Enabling or Disabling Scheduled Maintenance for One or More Devices

You can enable or disable one or more scheduled or recurring device maintenance windows from the Schedule Manager page (Registry > Devices > Device Manager > wrench icon > Schedule). To do this:

  1. Go to the Schedule Manager page (Registry > Devices > Device Manager > wrench icon > Schedule).

  1. Select the checkbox icon for each scheduled process you want to enable or disable.
  2. Click the Select Action menu and choose Enable Schedules or Disable Schedules.
  3. Click the Go button.

Deleting Scheduled Maintenance for One or More Devices

You can delete one or more scheduled or recurring device maintenance windows from the Schedule Manager page (Registry > Devices > Device Manager > wrench icon > Schedule).

To delete maintenance windows:

  1. Go to the Schedule Manager page (Registry > Devices > Device Manager > wrench icon > Schedule).

  1. Select the checkbox icon for each scheduled process you want to delete.
  2. Click the Select Action menu and choose Delete Schedules.
  3. Click the Go button.