2 DIVAprotect Configuration

This chapter describes DIVAprotect configuration, and includes the following information:

Main Configuration

You must perform the main configuration tasks described in this section. You configure DIVAprotect on the DIVAprotect tab in the Oracle DIVArchive Configuration Utility.

Note:

Some configuration options require logging in with the Engineer user account, which is reserved for Oracle Support.

Configure the following options, contacting Oracle Support as necessary:

Configuration Utility GUI: Enable/Disable DIVAprotect Configuration

This option enables you to view the DIVAprotect panel in the Configuration Utility. The Engineer log in is required to modify this parameter; contact Oracle Support.

DB: Maximum Possible History of Events in Months

This option identifies the maximum number of events that can be stored in the system. After this number is exceeded, DIVAprotect removes the oldest entries using an automated database job that executes every hour.

DB: Maximum Possible Number of Metrics

This option identifies the maximum number of metrics that can be stored in the system. After this number is exceeded, DIVAprotect removes the oldest entries using an automated database job that executes once per day, every day.

Manager: Enable/Disable DIVAprotect Data Collection

This option enables or disables DIVAprotect Data Collection. The Engineer log in is required to modify this parameter; contact Oracle Support.

Manager: Size Triggering Event Queue DB flush (nb events)

This option identifies the number of events collected ands stored in memory before saving them to the database.

Manager: Time Delay Triggering Event Queue DB flush (seconds)

This option identifies the maximum time interval for saving events to the database. If this interval is reached before the Size Triggering parameter is reached, the events are saved to the database regardless of how many have been collected.

DIVAprotect Resources

The DIVArchive Configuration Utility includes configuration elements specific to DIVAprotect as follows:

Tape Drives

You edit the drive serial number in the Drive Edit dialog box. This is useful if the information was either not retrieved, or entered improperly, during a Sync DB process. The firmware of the drive is displayed in a uneditable field. The firmware information is obtained from the Actors when they scan for tape drive devices. You can view this information on the Drives tab in the Configuration Utility

Oracle DIVArchive Actors

The Actors panel on the System tab in the Configuration Utility displays the First Utilization Date in a uneditable field. There is no additional DIVAprotect configuration necessary for the DIVArchive Actors.

Libraries

The Libraries panel on the Robots tab in the Configuration Utility includes an editable Name field to enter (or edit) the library description, and a uneditable First Utilization Date field. There is no additional DIVAprotect configuration necessary for the libraries.

Configuring DIVAprotect Events and Metrics

The Event Definitions panel displays the list of event definitions available for use in the metrics. Event definitions are factory set and cannot be modified. See Event Definitions for a list of predefined event definitions.

You can double-click an event definition to display a dialog box listing its associated parameters.

The Metric Definitions panel lists the available metrics. Built-in metrics (DIVAPROTECT* metrics) cannot be edited, and therefore do not appear in the Metric Definitions panel. See Metric Definitions for a list of predefined metric definitions.

You can double-click a Metric Definition to display an edit dialog box where you can examine or modify the metric. This has the same effect as selecting a metric in the list, and then clicking the Edit button. The + and - buttons allow adding or deleting a metric.

You can enter a description of the metric in the Description field that is displayed next to the Metric Name in the Metric Definitions panel. The description is also displayed in the Control GUI when you pause your mouse over an entry in the Metric Definition menu list.

The Enabled check box enables (selected) or disables (deselected) data collection for the metric.

The Collection Type fields specify which event parameter (for example, Transfer Size) is collected as the data, and the statistical computation operated on it (for example, Sum). The available statistics are as follows:

  • Average

  • Count

  • Maximum

  • Minimum

  • Sum

  • Weight Based Average

The Weighted By field specifies the divider parameter for Weight Based Average collection (for example, Duration).

The Collected Event list specifies the events from which the collected event parameter is retrieved. The list only displays event types suitable for the parameter specified in the second field for the Collection Type. Event types with no such parameter attached are absent from the listing.

The Resource menu list specifies which resource to use to break down the data. For example, if you select Drive Serial Number, DIVAprotect generates separate metrics for each drive.

The Interval field specifies the interval for metric calculation. For example, selecting 1 Day generates a metric daily (if corresponding data is available). The metric calculation is based on the associated events that occurred in the last 24 hours.

Sample Metric Configuration

This is a sample configuration procedure to create your own metric that captures the average duration of read and write operations on a tape in a DIVArchive system. You use the following procedure to capture this data:

  1. Open the Configuration Utility and navigate to the DIVAprotect tab.

  2. Locate the Metric Definitions panel and click + to begin adding a new metric.

    The Metric Definition dialog box is displayed.

  3. Enter a unique name for the metric in the Name field. For example ACTOR_READ_WRITE_ABORTED_NUMBER_SD.

  4. Add a description in the Description field, and then enable it by selecting the Enabled check box.

  5. Set both Collection Type fields, and the Weighted By field as appropriate.

    If you select Weight Based Average in the first list for the Collection Type, it enables the Weighted By field. You must then select a value to weigh the metric definition. The values for the Weighted By field are identical to those in the second Collection Type field (for example, Event ID).

  6. Select the events to collect using the Collected Event check boxes.

  7. Use the menu list top select the Aggregation Resource type.

  8. You can use the menu list to set the Aggregation Interval, but it can be left at the default (one hour).

  9. Click OK to complete the process.