IBM DataPower Operations Dashboard v1.0.11.0

A newer version of this product documentation is available.

You are viewing an older version. View latest at IBM DPOD Documentation.

Maintenance Concepts

Maintenance Activity

A maintenance activity defines the set of maintenance actions required for a specific goal. An example of such an activity is "Perform Secure Backup on device X".
Additionally, the maintenance activity contains other specific definitions for the action. This may include for instance which certificate should be used for the Secure Backup or which deployment policy should be used for a configuration sync operation.

Maintenance Plan

A maintenance activity such as backup or sync is defined inside a plan, e.g. a backup plan, a sync plan etc. A plan only contains a single type of activities.
A plan contains common definitions for all activities included within it, such as scheduling definition, email and syslog addresses to report to, etc.
A plan must contain at least one activity in order for it to be enabled.

Maintenance Task

A maintenance task is the execution of an operation on a device. An example of a maintenance task would be a secure backup activity on devices QA1 and QA2 which executes two backup tasks - one for each device.

Maintenance Window

A maintenance window defines a period of time during which maintenance plans are allowed to start run.
The definition of a maintenance window consists of two parameters in 24h format (e.g. 22:00)

  • Maintenance window start time 
  • Maintenance window end time

A maintenance window may be defined separately for each Maintenance Plan. Alternatively, the installation may use a default system value (see Maintenance Configurable Parameters for more information)
Maintenance Plans will not initiate the execution of any new tasks outside the maintenance window.
If, when the Maintenance Window has ended, some of the plan's tasks are still waiting to execute, they will be marked as cancelled and the plan execution will end. Executing tasks will not be interrupted.

Error Policy

The error policy controls what happen when a task fails (during either validation or execution)
When the error policy is "Halt" - all waiting tasks will be cancelled and will not execute. Executing tasks will not be interrupted.
When the error policy is "Ignore" - remaining tasks will continue to execute as normal.

How to Execute Maintenance Plans

There are three methods to execute a maintenance plan.
Note that regardless of the method used, to execute a plan it must first be enabled.

  1. Scheduled run: Enter a value in the plan's schedule field. The format is the same as the one used for scheduling a report
  2. Via REST API: Consult the Backup REST API or Sync REST API pages for more details
  3. Ad-hoc:  By clicking "Execute" on the Plan Details Page

Using Patterns for Device and Domain Names

Whenever device or domain patterns are allowed within a plan (e.g. when choosing which devices or domains to backup), DPOD accepts an asterisk to designate a pattern, or a comma to list values

Some examples for device selection are listed below:

PatternDetailsSelection
Prod*  Asterisk at the end of the patternAll devices starting with "Prod" e.g.
  • Prod1
  • Prod_Alternate
  • Prod 
*1Asterisk at the beginning of the patternAll devices ending with "1" e.g.
  • Device1
  • D1
  • Device_External_1 
Device_QA_*1Asterisk in the middle of the pattern

All devices starting with "Device_QA_" and ending with "1" e.g. 

  • Device_QA_Number_1
  • Device_QA_1
  • Device_QA_With_Alternate_IP_1 
Device*QA*Multiple asterisks in pattern

All devices starting with "Device", having "QA" somewhere in the name e.g

  • Device_QA
  • Device_for_QA_of_systems
  • DeviceQA
Device-QA1, Device-QA2, Device-*3List of values, with or without asterisk in them

All devices exactly matching values in the list. If an asterisk is used - the rules for asterisks apply e.g.

  • Device-QA1 (exact name match)
  • Device-QA2 (exact name match)
  • Device-QA3 (wildcard match) 
*Asterisk only.All device names configured in DPOD will be matched.

IBM DataPower Operations Dashboard (DPOD) v1.0.11.0