3 Configuring DIVArchive Overview

This chapter describes a general overview of the DIVArchive configuration and includes the following information:

Module Configuration Files

Each DIVArchive software module has its own static configuration text file with parameters needed to launch that particular application. The files are typically denoted with the .conf file name extension. There are some DIVArchive modules that use an XML based file rather than a text file for their configuration and those will be noted where applicable.

Unlike older releases of DIVArchive that stored these configuration files in the same folder as the application itself, DIVArchive 7.6 centralizes them to a dedicated conf subfolder under the DIVArchive Program Group.

The configuration files are typically updated with additional or changed settings in newer releases of the software. A new or patch release of DIVArchive will have the new releases of the .conf files appended with a .ini extension. For example, the new release of the DIVArchive Manager Configuration file will be named manager.conf.ini. You must remove the .ini extension after the installation is complete and the new configuration file updated.

Each configuration file can be opened and edited with any plain text editor (for example, Windows Notepad).

Any changes made to the configuration file of a DIVArchive software component requires that the component be shut down and then restarted for the changes to take effect. The exceptions to this are the Manager and Access Gateway options, both of which allow configuration changes to be reloaded while they are still running. There are codependencies between some applications in the DIVArchive platform, so other components may also need to be restarted for changes to take effect.

DIVArchive Databases

At the system level, settings that relate to the overall operation of each DIVArchive component and their interaction are configured and retained by an Oracle Database. This is commonly known (and will be referred to in this document) as the DIVArchive Database (or just simply as the database).

User modification of this database is performed through the DIVArchive Configuration Utility.

The DIVArchive Configuration Utility connects only to the database and does not necessarily require the DIVArchive Manager to be running. It is only intended for experienced users and caution should be exercised when altering settings using the utility. An incorrect setting can impede DIVArchive operations or prevent the DIVArchive Manager from starting successfully. Contact Oracle Support for assistance if you are unsure about making a particular change.

When launched, the DIVArchive Manager obtains the DIVArchive system configuration from the database. However, it does not poll the database for changes made through the Configuration Utility. Therefore, the database must be notified of any changes made. This is performed using the Notify Manager menu item in the Configuration Utility.

You can accomplish most changes to the configuration while the DIVArchive Manager is running. There are a small number of configuration changes that require a restart of the DIVArchive Manager to become effective. A full list of changes that can be made to the system configuration dynamically while the Manager is running is listed in Appendix B.

The Configuration Utility also does not dynamically poll the database for changes that are made when the Manager is running. In such cases, you click the Update button in the utility to refresh the information displayed from the database.

You can install the Configuration Utility on any computer that has TCP/IP connectivity to the database and a supported Java Runtime Environment installed. DIVArchive release 7.6 requires the Java Runtime Environment 64-bit (build 1.8.0_45-b14), to be installed to launch the Configuration Utility successfully.

In some cases, a network firewall between the two can prevent a connection. For complete operation and functionality of the Configuration Utility, the Oracle Listener Port (typically 1521) and the DIVArchive Robot Manager Ports (typically 8500 and higher) must be opened in the firewall. Full functionality of the Control GUI also requires that the DIVArchive Manager Port (typically 9000) is open.

Metadata Database

The DIVArchive Metadata Database has very high performance and almost unlimited scalability. The Metadata Database should be treated with the same caution as the Oracle Database. It should be backed up at regular intervals through the DIVArchive Backup Service.

Oracle highly recommends that the Metadata Database files are stored on a RAID disk array. The Metadata Database should not be on a standard disk due to decreased performance and the real-time backup functionality that a RAID array offers the system.

Metadata Database files stored on a standard disk are vulnerable to data loss if a single disk failure until the information is replicated through the DIVArchive Backup Service. Storing the Metadata Database files on a RAID array isolates the data from this type of failure.

The information stored in the Oracle Database is already stored on a RAID-1 array and is not subject to data loss if a single disk fails.

Metadata Database Sizing

The following formula can be used as a rough guide to determine the minimum amount of disk space required to support the Complex Object Metadata Database:

(100+average_path_filename_size)*1.15*avg_num_component_files*num_objs

The following is a general example using the equation:

average_path_filename_size = 60

For example, this/nested/subdir01/As_The_World_Turns_24fps_scenes1-10.avi

avg_num_component_files = 200,000

The Average Number of Files and Folders within the complex object.

num_objs = 50,000

The number of complex objects to be archived.

In this example, minimum budgeting for a Metadata Database size of approximately 1.67 TB would be recommended.

When planning the system, you must allocate enough Metadata Database disk space to ensure for expected, or unexpected, growth of the environment. The same amount of disk space must also be allocated for the Metadata Database in all of the backup systems.

Environment Variables

Some DIVArchive software components may require defining one or more Windows operating system environment variables for those components to launch successfully.

An environmental variable allows the configured variable to be available to all programs rather than requiring it to be configured from the application each time it is executed. This makes the variable independent of the application and therefore you do not need to manually insert or update the value when the application software is updated or modified.

A User Environmental Variable only applies to an individual Windows User Profile. A System Environmental Variable is applicable to all Windows User Profiles.

The following example illustrates how to configure the DIVA_JAVA_HOME environment variable on a Windows system.

Note:

This is simply an example and NOT required for DIVA_JAVA_HOME as it is already pointing to a valid JRE after installation.

This variable defines the path of the Java Runtime Environment for DIVArchive applications on the Windows host. This particular parameter is required on any Windows computer that will run either the DIVArchive Configuration Utility or the DIVArchive Control GUI.

Use the following procedure to configure an environment variable:

  1. Open the Windows Control Panel.

  2. Double-click the System icon.

  3. Click the Advanced tab.

  4. Click the Environment Variables button.

  5. Click the New button.

  6. Enter the variable name in the Variable name field. In this example the name is DIVA_JAVA_HOME.

  7. Enter the variable value in the Variable value field. This is the path (or other value) to use for the named variable. In this example the value is C:\DIVA\java.

  8. Click OK to complete the process.

You have now defined the variable and it is displayed in the System variables list. The DIVA_JAVA_HOME environment variable is now accessible to all users (and applications) on the system and does not need to be defined each time an applications is executed.

SSL Authentication and Security

DIVArchive 7.6 introduces SSL Certificate Authentication for authentication of services, and securing the internal and API communications in DIVArchive. Certificate authentication provides unique identification and secure communications for each DIVArchive service in a network.

Certificate authentication functions similar to identification cards like passports and drivers licenses. For example, passports and drivers licenses are issued by recognized government authorities. SSL (Secure Sockets Layer) certificates are signed by a recognized CA (Certificate Authority). An SSL certificate verifies the identity of its owner. When the SSL certificate is presented to others, it helps verify the identity of its owner based on the quality of the contents of the certificate.

DIVArchive it comes with Default Root Certificate Authority called DIVA_CA. The DIVA_CA is a self signed CA created for this purpose, and signs all SSL certificates for the DIVArchive services. Every DIVArchive service now has its own password protected private keys and an SSL certificate which will be signed by the DIVA_CA.

See SSL (Secure Sockets Layer) and Authentication for configuration information.

External Certificate Authorities

You can use external third party CAs (for example, VeriSign, Comodo, and so on) with DIVArchive. The external CA must create a CSR (Certificate Signing Request) for DIVA_CA, signed by the third party CA, and the third party certificate must be added to the Trust Store to satisfy the certificate chain.

See SSL (Secure Sockets Layer) and Authentication for instructions to create the CSR, and installing the thirty party CA in your DIVArchive installation.

DIVArchive Configuration Utility Overview

Caution:

The Configuration Utility is intended only for experienced users. Incorrect or incomplete changes in the Configuration Utility can adversely affect DIVArchive operations (and possibly even delete data from the archive), or prevent the DIVArchive Manager from running. Contact Oracle Support for assistance if you are unsure about making desired changes.

The DIVArchive Configuration Utility primarily connects to the DIVArchive Database, and for some tasks, directly to the DIVArchive Robot Managers (if installed). After launching the utility you must first connect to the database to edit the DIVArchive system configuration. The Oracle user name and password for DIVArchive is arbitrary and can vary between installations. These details are documented in the DIVArchive Site Configuration for your site.

The utility can be installed and run on any computer with TCP/IP connectivity to the DIVArchive Database, Manager, and Robot Managers. Because it is a Java-based utility, a valid Java Runtime Environment (JRE) must also be installed on the host. For the Configuration Utility to launch, the DIVA_JAVA_HOME environmental variable in the host operating system must also be defined (see the previous section). This variable should match the absolute directory path to the JRE bin folder. For example DIVA_HOME\Java (where DIVA_HOME is the chosen DIVArchive installation directory). The required release of Java is delivered with DIVArchive, and installed during the DIVArchive installation process.

Connecting to the DIVArchive Database

Use the following procedure to connect the Configuration Utility to the DIVArchive database:

  1. Open the DIVArchive Configuration Utility.

  2. Click File, and then Connect.

    Alternatively click the Connect icon just under the File menu.

  3. Enter the following information in the fields on the DB Connection dialog box:

    User Name

    The database user name (typically diva).

    Password

    The Oracle password associated with the entered user name.

    S.I.D.

    The Oracle System Identifier (typically lib5).

    IP Address

    The IP address of the computer where the DIVArchive Database is installed.

    Oracle Port

    The Oracle Listener Port (typically 1521).

  4. Click OK to connect to the database.

The connection status is displayed in the notification area at the bottom of the screen. If the connection fails an error message is generated, including an error code, and displayed in this area. Contact Oracle Support if you still cannot connect after attempting to resolve the error.

Disconnecting from the DIVArchive Database

Disconnect the Configuration Utility from the database when not in use. Use the following procedure to disconnect from the database:

  1. Click File, and then Disconnect.

    Alternatively click the Disconnect icon just under the File menu.

  2. Click Yes in the displayed Confirm dialog box.

  3. Click OK in the displayed Disconnected dialog box.

The notification area at the bottom of the screen will display the Not Connected message.

Configuration Utility Frame Buttons

Each frame in the Configuration Utility includes a set of buttons that perform various functions as follows:

Plus (+)

This button is a plus sign (+). Clicking the button launches a dialog box to add an entry to the frame.

Edit

Highlighting a frame entry and clicking this button enables editing of the entry's properties.

Minus (-)

This button is a minus sign (-). Highlighting a frame entry and clicking this button will remove the entry from the frame. Entries with child dependencies cannot be removed.

Update

Clicking this button refreshes the associated frame content listing from the database.

DIVArchive Control GUI Profiles and Passwords

The DIVArchive Control GUI provides four fixed user profiles (Administrator, Operator, Advanced Operator, and User) to provide varying levels of access. The Administrator, Operator, and Advanced Operator profiles require a password that you can change using the Configuration Utility.

The difference between the Operator and Advanced Operator profiles are the Insert and Eject commands, which are only accessible from the Advanced Operator profile. You use the Operator profile during normal operations unless you are inserting or ejecting a tape.

There is no default password to log in to the Control GUI as an Administrator or Operator. You must assign an Administrator and Operator password in the Configuration Utility after DIVArchive installation is complete. Without an assigned password you are not permitted to switch to the respective profile in the Control GUI. If you attempt to switch to Administrator or Operator mode without first assigning a password to the profile, an error message is displayed notifying you that you must set a password. After you set the profile password in the Configuration Utility the first time, it no longer matters what you use for the old password when changing passwords.

Setting the Control GUI Administrator Password

Use the following procedure to set the Administrator password:

  1. Open the Configuration Utility.

  2. Connect to the DIVArchive Database.

  3. Click the Tools menu item.

  4. Click the Change GUI Administrator Password menu item (or use Control+G).

    This option is only available when the Configuration Utility is connected to the database.

  5. Enter the following information in the appropriate fields on the Change GUI Administrator Password dialog box:

    Old Administrator Password

    Enter the old Administrator password in the Old Administrator Password field. You must leave this field blank the first time you set the Administrator password.

    New Password

    You enter the new password in the New Password field.

    Confirm Password

    You enter the new password again in the Confirm Password field.

  6. Click OK to save the password.

Setting the Control GUI Operator Password

Use the following procedure to set the Operator password:

  1. Open the Configuration Utility.

  2. Connect to the DIVArchive Database.

  3. Click the Tools menu item.

  4. Click the Change GUI Operator Password menu item (or use Control+G).

    This option is only available when the Configuration Utility is connected to the database.

  5. Enter the following information in the appropriate fields on the Change GUI Administrator Password dialog box:

    Administrator Password

    Enter the Administrator password in the Administrator Password field.

    New Operator Password

    You enter the new password in the New Operator Password field.

    Confirm Password

    You enter the new password again in the Confirm Password field.

  6. Click OK to save the password.

Changing the Database Logging Level

Use the following procedure to change the Database Logging Level:

  1. Open the Configuration Utility.

  2. Connect to the DIVArchive Database.

  3. Click the Tools menu item.

  4. Click the Change DB Logging Levels menu item (or use F12).

    This option is only available when the Configuration Utility is connected to the database.

  5. Use the menu lists to select the desired logging level for each package listed in the Change DB Logging Levels dialog box. Available levels are:

    FATAL

    When selected, this level displays very severe errors that may cause DIVArchive to terminate.

    ERROR

    When selected, this level displays errors that still allow DIVArchive to operate.

    WARN

    When selected, this level displays warning messages that are potentially harmful to operations.

    INFO

    When selected, this level displays informational messages about the progress of the operations.

    TRACE

    When selected, this level displays messages used to help debug the system.

  6. Click OK to save your changes.

Configuration Utility Tabs Overview

The following sections describe a general overview of each tab in the Configuration Utility. Each tab includes multiple frames where you configure different aspects of the system.

To notify the Actors of any changes in the Actor configuration, click the Notification menu item, and then Notify Actors while connected to the Manager. The Actors must be running and connected to the Manager to receive the notifications.

System Tab

The System tab defines key parameters for your DIVArchive installation and is the starting point for creating your DIVArchive configuration.

You should create a drawing of the system components before entering details into the Configuration Utility. The drawing includes the data and control paths between components, how they interact with each other, established naming conventions for resources such as disks and tapes, and the workflow of the platform. Some parameters are difficult to change once they have dependencies from other configuration parameters in the database.

System Tab Frames

The System tab includes the following frames:

Production System Definitions

All DIVArchive installations have at least one production system. Additional production systems allow dedication of a particular Actor for specific destinations.

Sites

All installations have at least one site. Additional sites are optional and may be considered by the DIVArchive Manager for optimal resource allocation.

Note:

Site Support must be enabled in the DIVArchive Manager configuration, otherwise all sites will be considered equally.
Sources and Destinations

These define where DIVArchive archives from (Sources) and restores to (Destinations).

Actor Settings

These define Actor host definitions and logical functions. All installations have at least one Actor. See Appendix A for Oracle DIVArchive options and licensing information.

Transcoders

These define DIVArchive transcoders and analyzers. DIVArchive automatically selects the Actors either attached to a Bitstream Flip Factory Transcoder installation or integrated with the DIVAnalyze Harris QuiC compressed file analysis software. DIVArchive allows a single transcoder to perform multiple transcodings. DIVArchive assigns additional ports as needed from the base port specified in the configuration. Therefore, a gap of one hundred between individual transcoder port settings is recommended to avoid port conflicts.

Actor Configuration in the Database

Except for the Service Name and Port, all Actor configuration settings are located in the Configuration Utility under the Actor Advanced and Partial Restore Settings tabs of the Actor frame of the Systems tab. Some settings are only available In Engineering Mode and are labeled with an X in the Engineering Mode column of the following tables.

Table 3-1 Advanced Actor Parameters

Name Type Min. Max. Engineering Mode Default

DISABLE_DISK_PREALLOCATION

Boolean

   

X

Yes

TAPE_TEST_UNIT_READY_TIMEOUT (S)

Integer

60

1200

 

180

DO_NOT_CHECK_OBJECT_NAME

Boolean

     

No

DO_NOT_CHECK_CATEGORY

Boolean

     

No

SIMULATION

String

   

X

 

SIMULATION_READING_ERROR_RATE (%)

Integer

0

100

X

0

SIMULATION_WRITING_ERROR_RATE (%)

Integer

0

100

X

0

SIMULATION_TAPE_SIZE (MB)

Integer

20

500000

X

300000

SEACHANGE_CHECK_DELAY (MS)

Integer

0

10000

X

1000

PROFILE_READ_BLOCK_SIZE (B)

Integer

1500

262144

 

1500

PROFILE_WRITE_BLOCK_SIZE (B)

Integer

1500

262144

 

32768

QUANTEL_RENAME_CLIPS

Boolean

     

No

QT_SELF-CONTAINED_THRESHOLD (MB)

Integer

10

100

 

50

RENAME_TRANSCODED_CLIPS

Boolean

   

X

 

DIRECTORY_SERVER_ENABLED

Boolean

   

X

Yes

DISK_FTP_PASSIVE_MODE

Boolean

     

No

DISK_FTP_BLOCK_SIZE

Integer

1024

524288

 

32

DISK_FTP_SOCKET_WINDOW_SIZE (B)

Integer

65536

10485760

 

65536


Table 3-2 Partial File Restore Parameters

Name Type Min. Max. Engineering Mode Default

QT_IGNORE_START_TIMECODE

Boolean

     

No

QT_OMNEON_FIRST_FRAME_HANDLING

String

     

Reset

AVI_IGNORE_START_TIMECODE

Boolean

     

No

EVS_MXF_IGNORE_START_TIMECODE

Boolean

     

No

GXF_TIMECODE_REFERENCE

Integer

0

2

 

1

GXF_PROGRESSIVE_TIMECODE_TRANSLATION

Boolean

     

No

LXF_IGNORE_START_TIMECODE

String

     

No

MXF_PARTIAL_RESTORE_DICTIONARY_FILE

String

       

MXF_TIMECODE_FROM_SOURCE_PACKAGE

Boolean

     

No

MXF_TIMECODE_VALUE_TO_SWITCH_PACKAGE

String

     

-1

MXF_ENFORCE_CLOSED_HEADER

String

     

Yes

MXF_RUN_IN_PROCESSOR

String

       

MXF_IGNORE_START_TIMECODE

Boolean

     

No

MXF_USE_BMX_LIBRARY

Boolean

     

No

MXF_USE_OMNEON_DARK_METADATA

Boolean

     

No

MXF_SERIALIZE_DEPTH_FIRST

Boolean

     

No

MXF_GENERATE_RANDOM_INDEX_PACK

Boolean

     

Yes

MXF_NUMBER_FRAMES_PER_BODY_PARTITION

Integer

50

500

 

250

MXF_UPDATE_TCTRACK_ORIGIN

Boolean

     

No

MXF_TOLERANCE_ON_TCOUT

Integer

0

250

 

0

MXF_DURATION_FROM_FOOTER

Boolean

     

Yes

MXF_MAX_QUEUE_SIZE

Integer

100

1000

 

200

SEACHANGE_IGNORE_START_TIMECODE

Boolean

     

No

MPEG2_TRANSPORT_STREAM_IGNORE_START_TIMECODE

Boolean

     

No

MPEG2_PROGRAM_STREAM_IGNORE_START_TIMECODE

Boolean

     

No


Robots Tab

All DIVArchive installations include the Robots tab, although not every installation necessarily has a library. This tab defines basic associations with the robotics software and hardware components.

Robots Tab Frames

The Robots tab includes the following frames:

Robot Managers

This frame defines to DIVArchive the connection parameters to each host running a DIVArchive Robot Manager Instance. See Appendix A for Oracle DIVArchive options and licensing information.

Libraries

Displays the tape or DVD libraries currently configured through one or more DIVArchive Robot Managers and their online status.

Media Compatibility

This frame maps the Tape Media Type defined in the Tapes tab, to the Drive Types defined in the Drives tab. Although you can manually remove entries in this frame, they can only be added or updated during a database synchronization with a Robot Manager.

Robot Managers-ACS

This frame associates each Robot Manager with an Automated Cartridge System (ACS) number. Although you can manually remove entries in this frame, they can only be added by performing a database synchronization with the specific Robot Manager.

Disks Tab

The Disks tab defines the physical disks that are to be used by DIVArchive, how they are grouped together for either permanent or cache storage, and how each disk is logically accessed by the Actors.

Disks Tab Frames

The Disks tab includes the following frames:

Arrays

An Array defines a logical association of disks in which one or more physical disks are assigned for use by DIVArchive. The Array Name is equivalent to the Group Name for tapes.

Disks

The symbolic name and location for each disk in your system, whether confined to a single host or shared between hosts. These disks are then assigned to Arrays.

Actor-Disk Connections

Configures how each disk is logically connected to each DIVArchive Actor, and how it is to be used. For shared disks accessible by more than one Actor, the disk connection must be declared for all Actors. See Appendix A for Oracle DIVArchive options and licensing information.

Object Storage Accounts

Configures how each object storage account is logically connected to each DIVArchive Actor, and how it is to be used. See Appendix A for Oracle DIVArchive options and licensing information.

Drives Tab

The Drives tab is where the drives in your tape libraries are identified and configured for use with DIVArchive and its Actors. In some installations, a tape library and its drives may be shared with other applications. The configuration options enable you to disable any of the identified drives from DIVArchive use. See Appendix A for Oracle DIVArchive options and licensing information.

Drives Tab Frames

The Drives tab includes the following frames:

Drives

Displays the drives currently identified to DIVArchive in a database synchronization and their current status.

The Drive Edit dialog box enables editing the Serial Number, Status (online or offline), Enabled Operations (Archive, Restore, and so on), and Used (yes or no), information for a drive. This is useful if this information was not retrieved, or was entered improperly, during a SyncDB process. The firmware release for the drive is also displayed in a non-editable field. The firmware information is obtained from the Actors when they scan for tape drive devices. Other additional non-editable information is also displayed in this dialog box, and all of the information is displayed in the Drives frame.

Drive Properties

This displays the drive models currently configured for use with DIVArchive. Although you can manually remove entries in this frame, they can only be added by performing a database synchronization with a Robot Manager. See Appendix A for Oracle DIVArchive options and licensing information.

Actors-Drives

Indicates to DIVArchive which Actors have access to the drives configured in the Drives frame. In this area associations can be added, edited, or deleted.

Clicking the + button adds an existing Actor-Drive association. The Add New Row in Actors-Drives dialog box is displayed. Use the menu list to select the Actor, and then use the check boxes next to each drive to associate with the selected Actor.

Clicking the Edit button enables edit of an existing Actors-Drives association. The Edit Drives Entry dialog box is displayed. Make the required or desired updates and click OK to save the changes.

See Appendix A for Oracle DIVArchive options and licensing information.

Tapes Tab

The Tapes tab defines each Tape Media Type capacity in DIVArchive, and each individual tape's write, repack or to be cleared status. Tapes that do not contain any DIVArchive objects (that is, they are empty or are from another archive application in a shared library environment) and have been ejected from a DIVArchive managed library can also be deleted from the DIVArchive database from this tab.

Tapes Tab Frames

The Tapes tab includes the following frames:

Tape Properties

Displays the Tape Media Types and configuration parameters currently configured in DIVArchive after a library database synchronization.

In the Tape Properties frame, you can highlight an existing tape and click Edit to open the Tape Properties dialog box.

Empty Ejected Tapes

Displays the tapes that no longer have any DIVArchive content and have been ejected from an attached library. Clicking the - button permanently removes the selected tape from the DIVArchive Database.

Inserted Protected Tapes

When a tape is externalized, it is set to Protected Mode by DIVArchive. You must manually remove this state after reinsertion into the library if the tape is to have content written to it.

Tape States

A tape will appear in this frame if either the Enable for Writing or the Enable for Repack states is set to N. The Enable for Writing state can be automatically disabled by DIVArchive if it encounters an error during a read, write, or repack operation.

Click the + button in the Tape States frame to add a tape to the Tape States. Select the tape to add from the list in the displayed dialog box, and then click OK to add the tape.

The Tape States frame gives an overall indication of the reliability of your tape drives. Tapes appearing in this frame (if not manually inserted) indicates that either a read or write error occurred on that tape during DIVArchive operations. If you have many tapes present here this may indicate an issue with one or more of your tape drives and should be promptly investigated.

Sets, Groups & Media Mapping Tab

You use the Sets, Groups & Media Mapping tab to allocate tapes into pools for use by DIVArchive. The Set ID represents each media pool. The Set ID is typically used to distinguish different types of tape media. However, it may also be used to dedicate a specific set of tapes to specific groups.

A Group is a logical name for the storage of DIVArchive objects. Each group is assigned a Set ID of tapes to draw upon. Each group can only be assigned one Set ID. Several groups can share the same Set ID.

You can use the Configuration Utility to define the format of an array or group. The format is configured in the Disks and Sets, Groups & Media Mapping tabs for arrays and groups respectively. Alternatively, you can use the addGroup API call define a group or array and its format. The default format is AXF. This can also be achieved by selecting Legacy in the Configuration Utility, or specify the corresponding value for the format using the API call.

Changing the format of an array is performed through the Edit Array Entry dialog box. Changing the format of a group is performed through the Edit Groups Entry dialog box. In either case, highlight the desired array or group and then click Edit to open the associated dialog box. Use the menu list to select the format (Legacy or AXF). Use the following procedure to change the format of an array or group:

  1. Navigate to either the Disks (for arrays) or the Sets, Groups & Media Mapping (for groups) tab.

  2. Highlight the desired array or group in the displayed list.

  3. Click the Edit button at the top of the frame.

  4. Use the Tape Format menu list to select the format for the selected array or group.

  5. Click OK to complete the change.

Sets, Groups & Media Mapping Tab Frames

The Sets, Groups & Media Mapping tab includes the following frames:

Unused Tape Sets

Displays empty tapes that are recognized by DIVArchive and the library module where they are located. The Set ID of each tape can also be defined in this frame.

You can highlight an existing tape and click Edit to display the Edit Unused Tapes Sets Entry dialog box. When done editing the Tape Set click the Refresh button to refresh the list.

The Unused Tape Sets frame includes the following columns:

Barcode

These are tapes not currently in use by a group.

ACS

The ACS number is the specific library where the tape is located.

LSM

The LSM number is the specific library where the tape is located.

Media Type

This is the set's Media Type.

Set ID

This is the tape's Set ID. Click the desired tape to edit and then click the Edit button.

You can select multiple tapes by holding the CTRL key and clicking each tape. You select a range of tapes by holding the SHIFT key, click the first tape in the range, and then click the last tape in the range. Click Edit to open the Edit Multiple Rows dialog box.

Select the Set ID for the tape from the Set ID list. Only Set IDs that have already been created in the Groups window will be listed.

Setting the Set ID to 99 indicates that the DIVArchive is not to use the tape. This particularly applies to cleaning tapes installed in the library if they are reported to DIVArchive after a library audit. For example, a cleaning tape's typical barcode is CLNnnnn.

This also applies to some installations where DIVArchive shares its libraries with other applications. Tapes in use by other applications should also have their Set ID set to 99 to prevent DIVArchive from using them.

Groups

Adds, removes, or edits existing groups and each group's association with the tape pools defined in the Unused Tapes Sets frame. A group can only be removed when it no longer contains any DIVArchive objects.

Additional Set IDs for the Unused Tape Sets frame are only available after they are first created in a group. Tapes that should not be used by DIVArchive (for example, cleaning tapes) must be configured with a Set ID of 99.

The Groups frame includes the following columns:

Id

This is the library ID the group belongs to. This is automatically generated by the system and not editable.

Group Name

The name assigned to the group. These names will appear in the MEDIA list of an Archive request in the Control GUI.

Set ID

Default Set ID of each group is 1. You cannot assign tapes to additional Set IDs until after they are included in a group.

Description

This is an arbitrary description of the group.

Media Types

This is the tape Media Types currently in use by this group. This is updated automatically when a tape is assigned to the groups Set ID in the Unused Tapes Sets frame.

Tape Format

This is the format of the tape (Legacy or AXF).

Encryption

Identifies whether tape group encryption is enabled or disabled.

Compression Enable

Identifies whether tape group compression is enabled or disabled.

Worse Fit Enable

By default, DIVArchive attempts to fill any tapes already assigned to a group before assigning an unused tape. The Worst Fit option attempts to span objects on as many tapes as possible.

Repack Reservation

This only applies if the Worst Fit option is enabled. It sets the number of unused tapes in the pool to reserve for tape repacking. All other groups that also use this group's Set ID must also have identical values.

VW

This column identifies whether Verify Write is on or off for the group.

Media Mapping

Media Mapping enables DIVArchive to automatically alter the specified media in an Archive request to another Disk Array, Tape Group or Storage Plan. In this way, you can alter the storage for Archive requests without requiring any changes in the archive initiator (automation or MAM system).

To edit an existing Media Map, highlight the desired mapping and then click Edit to edit the entry. Click OK to save your changes.

Click the + button in the Media Mapping frame to add a Media Mapping entry. Enter the Name for the mapping in the Name field. Use the menu lists to select the From (source), Media to Map to and Storage Plan to Map to, and then click OK to save the entry.

DIVAprotect Tab

The DIVAprotect settings are identified in the Configuration Utility's DIVAprotect tab as described in the following sections.

Configuration Frame

You set the main parameters in the Configuration frame as follows:

DB: Maximum possible history of Events in Months

Enter the number of months to retain DIVAprotect event history.

DB: Maximum possible number of Metrics

Enter the maximum number of DIVAprotect Metrics stored in the system. DIVAprotect will remove the oldest entries after this number is exceeded. This is completed through an automated database job that executes once per day, every day.

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

Enter the number of events collected in memory before saving them to the database.

Manager: Time delay triggering Event Queue DB flush (secs)

Enter the maximum interval for saving events to the database. If this interval is reached before the size triggering parameter is reached, the events will be saved to the database regardless of how many have been collected.

Event Definitions Frame

The Event Definitions panel displays the list of Event Definitions available for use in the metrics. Double-clicking an Event Definition or clicking Open will display a dialog box listing its associated parameters

Event Definitions are factory set and cannot be modified. Built-in metrics (DIVAPROTECT* metrics) cannot be edited and therefore do not appear in the Metric Definitions frame.

Metrics Definitions Frame

You double-click a Metric Definition to display an editing dialog box where the metric can be examined or modified. This has the same effect as selecting a metric in the list and clicking the Edit button.

The + and - buttons at the top of the frame enable adding or deleting a metric.

When adding a metric definition or editing an existing one, the Metric Definitions Properties dialog box is displayed. You can now enter or edit the following information as necessary:

Name

This is the name of the Metric Definition.

Description

This field enables you to enter a description of the Metric Definition that is displayed next to the Metric Name in the Metric Definitions panel. This description also appears in the Control GUI when pausing your mouse over an entry of the Metric Definition list.

Enabled

Select this check box to enable the metric. Deselect it to disable the metric.

Collection Type

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

  • Average

  • Count

  • Maximum

  • Minimum

  • Sum

  • Weight-based Average

Weighted By

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

Collected Event

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

Resource Type

The Resource Type field specifies which resource breaks down the data. For example, if you select Drive Serial Number, separate metrics will be generated for each drive. Use the menu list to select the resource type for the metric.

Interval

The Interval specifies the interval for metric calculation. For example, selecting 1 Day will generate a metric each day (if corresponding data is available). The metric calculation is based on the associated events that occurred in the last 24 hours. Use the menu list to select the desired interval.

Default Events and Metrics Configuration

The following table identifies the default events and metrics that are internal to DIVArchive:

Table 3-3 Default Event and Metric Definitions

Event Field ID Displayed Name Is Aggregatable? Is Resource? Is Collectable? Date or Number Quantifier

1

Event ID

No

Yes

Number

 

2

Event Type

Yes

No

   

3

Tape Type

Yes

No

   

4

Tape Barcode

Yes

No

   

5

Drive Type

Yes

No

   

6

Drive Name

Yes

No

   

7

Drive Serial Number

Yes

No

   

8

Actor Name

Yes

No

   

9

Object Name

Yes

No

   

10

Object Category

Yes

No

   

11

Object Instance

No

No

   

12

Media

Yes

No

   

13

Request ID

No

No

   

14

Event End Time

No

No

   

15

Event Duration

No

Yes

Number

Seconds

16

Transfer Size

No

Yes

Number

Bytes

17

Transfer Rate

No

Yes

Number

MB/Second

18

Transfer Error Rate

No

Yes

Number

Errors/GB

19

Error Code

Yes

No

   

20

Error Message

No

No

   

21

Disk Name

Yes

No

   

22

Library Serial Number

Yes

No

   

23

SD Name

Yes

No

   

24

Transcoder Name / Analyzer Name

Yes

No

   

25

Local DIVArchive System

Yes

No

   

26

Number of Operations

No

Yes

Number

 

Sample Metrics Definition

The following is a sample use case scenario:

You want to create your own metric for average duration of read and write operations on a tape in a DIVArchive system. You use the following procedure to create this metric:

  1. Open the Configuration Utility.

  2. Click the DIVAprotect tab.

  3. Click the + button on the Metrics Definitions frame to open the Metric Definition dialog box.

  4. Enter a unique name for the metric in the Name field.

  5. Enter a description in the Description field.

  6. Select the Enabled check box to enable the metric.

  7. Set the Collection Type and Weighted By fields as appropriate using the menu lists.

    For example, if you select Weight-Based Average as the Collection Type, the Weighted By field is enabled. Because the Weighted By field is active, you are required to select a value to use to weigh the metric definition. In this case, the values for the Weighted By field are identical to the second Collection Type field.

  8. Use the check boxes in the Collected Event area to select the events for collection.

  9. Use the menu list to select the aggregation Resource Type.

  10. Use the menu list to select the aggregation Interval.

  11. Click OK to save your metric definition and complete the process.

Media Tab

The Media tab displays information (properties) of the media identified in the DIVArchive system. The display is for informational purposes and read only. You click the Refresh button to refresh the displayed list.

The Source Media Priority determines which source instance is preferred during the instance selection process of a Restore, Partial Restore, and Copy To Group request, by the media on which the instance resides. Instances on media with a higher priority are preferred. If two instances reside on media with the same priority, DIVArchive will select an instance based on its internal algorithm (same algorithm used in earlier versions of DIVArchive).

Note:

Cloud instances are only copied or restored if all local instances are offline or no local instances exist. In other words, this condition is an absolute condition independent of the Source Media Priority.

Storage Plans Tab

Caution:

Misconfiguration of the Oracle DIVArchive Storage Plan Manager (SPM) may lead to unexpected and disastrous results! Minor changes can lead to catastrophic consequences. For example, the deletion of hundreds of thousands of instances on tape or database corruption. Without special training and familiarity with the product, it is recommended to contact Oracle Support before making any changes to SPM. Failure to do so may result in severe damage to the DIVArchive system or even permanent data loss.

The Storage Plans tab enables creation of simple and advanced rules for automated management and movement of content within the archive.

For detailed configuration information, see the Oracle DIVArchive Storage Plan Manager (SPM) User's Guide in the Oracle DIVArchive Additional Features documentation library. See Appendix A for Oracle DIVArchive options and licensing information.

Storage Plans Tab Frames

The Storage Plans tab includes the following frames:

Storage Plans

Displays the Storage Plan names and definitions.

You click the + button in the Storage Plans frame to add a Storage Plan. Enter the Storage Plan name in the Storage Plan Name field. Use the menu lists to select whether to Allow Last Instance Deletion, Please Specify Origin (Internal/External) (this is typically Internal), and the Group/Array Name to associate with the Storage Plan. Click OK to save the changes.

You highlight a desired Storage Plan, and then click Edit to edit the selected Storage Plan. Click OK to save your changes.

Media Groups

Defines the tape groups or disk arrays to be allocated to slots, and if content deletion will be managed by the Storage Plan Manager.

You click the + button in the Media Groups frame to add a Media Group. Enter the Medium Name and Storage Name in the designated fields. Use the menu lists to select the Group/Array Name, Watermarked, and the Disk Cleaning Strategy. Click OK to save the changes.

You highlight a desired Media Group, and then click Edit to edit the selected Media Group.

Storage Plans

Displays the Storage Plan names and definitions.

You click the + button in the Storage Plans frame to add a Storage Plan. Enter the Storage Plan name in the Storage Plan Name field. Use the menu lists to select whether to Allow Last Instance Deletion, Please Specify Origin (Internal/External) (this is typically Internal), and the Group/Array Name to associate with the Storage Plan. Click OK to save the changes.

You highlight a desired Storage Plan, and then click Edit to edit the selected Storage Plan. Click OK to save your changes.

After you click OK, A warning dialog box appears asking whether you want to continue saving the changes. Click Yes to save the changes, or No to cancel.

Filters

This frame displays filter definitions related to the Storage Plan Objects. It enables performing actions on all or specific objects (based on object filters).

Slots Tab

This tab defines the Slots associated with the Storage Plans for the Storage Plan Manager. Slots define which tape groups or disk arrays are related to each storage plan, and the parameters for storage plan execution.

For detailed configuration information, see the Oracle DIVArchive Storage Plan Manager (SPM) User's Guide in the Oracle DIVArchive Additional Features documentation library.

Slots Tab Frame

The Slots tab includes only one frame named Slots.

You click the + button in the Slots frame to add a Slot. Configure the Slot's parameters by entering the information desired for this slot, or using the menu lists to select the options. Click OK to save the changes.

You highlight a desired Slot, and then click Edit to edit the selected Slot. Click OK to save your changes.

The Slot Configuration screen serves two purposes; new slot configuration and editing an existing slot configuration. Both functions use the same dialog box. However, the information displayed in the dialog box is determined by whether a slot is being added, or an existing slot is being edited.

Manager Setting Tab

You use the Manager Setting tab to set several parameters related to the Media and the Metadata Database in the system.

Media Configuration

There are two settings to configure for the Media in the Manager Setting tab:

Media/Storage Plan Submission Delimiter

The object is assigned to a specific Storage Plan and saved to the specified media. The Media Name and the SP Name must be separated by the & delimiter.

Maximum Number of Records in DP_OPERATIONS Table

The maximum number of records maintained in the DP_OPERATIONS table in the database.

Metadata Database Configuration

You must configure the following three parameters in the Manager Settings tab to enable complex objects processing:

Complex Objects Metadata Database Location

Enter the full path to the Metadata Database files in this field.

Database Backup Notification

Select the check box to enable the Metadata Database backup notifications, or deselect the check box to disable notifications.

Notifications must be enabled to receive DIVArchive Backup Service messages to the Control GUI. If this parameter remains disabled, there will be no notification of errors or warnings displayed in the Control GUI. The default is enabled (selected).

Enable Metadata Database Feature

Select the check box to enable the Metadata Database Backup feature. The default is disabled (deselected).

Keystore Configuration

The Keystore password is set in the Configuration Utility in the Manager Configuration view. You enter the Keystore password in the Export: Tape Encryption Keystore Password field. The password must be at least eight characters and contain at least one digit, at least one lowercase alphabetic character, at least one upper case alphabetic character, and at least one special character within a set of special chars (!@#%$^).

You enable exporting encryption keys by selecting the Export: Enable Export of Encryption Keys check box. Exporting encryption keys is disabled by default. You must be in Engineering mode to view or edit both settings.

You can verify the integrity of the Keystore file using the Java keytool. See https://docs.oracle.com/javase/6/docs/technotes/tools/solaris/keytool.html for details on Java's keytool.