Media Management Configuration

Table of Contents

Overview

The Media Management parameters can be configured from the CommCell® Console.

Configure the Media Management Parameters

  1. Open the CommCell Console.
  2. On the ribbon in the CommCell Console, click the Storage tab, and then click Media Management.

    The Media Management Configuration dialog box appears.

The following sections explains various Media Management configuration parameters and there usage.

Service Configuration

Use this dialog box to establish advanced media management parameters.

Parameter Description
Allow change to data path configuration even if jobs are running Definition: Provides you with the ability to change the data path for a storage policy copy while a job is running for that copy.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: By default, the value is set to 0. To be able to change the data path, the value must be set to 1.

Allow export request to succeed without waiting for media being removed from library Definition: Returns the command line to the prompt before export operations are complete and the media is removed from the library. The export media operation run from the CommCell Console completes when the exported media is moved to the IE port.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: By default, the command line returns to the prompt after the export operations are complete and the media is removed from the library. When this option is set to 1 (enabled) the command line returns to the prompt after an export request command is run.

By default, when the export media operation is run from CommCell Console, the export process completes when the exported media is removed from the IE port. When this option is set to 1 (enabled) the export media operation completes after the exported media is moved to the IE port.

Array Management Data Collection Interval in hours Definition:  Specifies the interval (hours) that collects the details about Volumes, LUNs, and Snapshots configured on NetApp Storage Array in Array Management.

Default Value: 24 hours

Range: 0 to 720

Automatic Drive Cleaning check interval in Minutes Definition: Specifies how often the Media & Library Manager service on the CommServe should check for drives that require cleaning and start cleaning these drives. This parameter is only valid if the Enable Auto-Cleaning options are enabled in the Drive tab of the Library Properties dialog box.

Default Value: 20

Range: 2 to 1440

Usage: Dirty tape drives are the biggest concern when reading/writing to tape media. This parameter sets the interval for periodic checks for signals from the library indicating drive cleaning required. Alternative is for manual or scheduled cleaning.

Create disaster recovery storage policy or copy when new library is configure Definition: Specifies whether the disaster recovery storage policy needs to be created automatically when a new library is configured. This option will create a disaster recovery (DR) storage policy if it does not exists in the CommCell Console.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: By default, value is set to 1, which indicates that the disaster recovery storage policy is automatically created when new library is configured.

If this value is set to 0, then this option is disabled.

Deduplication pruning batch size Definition: Specifies the number of job records sent in a batch for pruning.

Default Value: 1000

Range: 0 to 100000

Usage: This is an advanced parameter that controls the number of job records sent for deduplication pruning from the CommServe to the MediaAgent.

Default low-water mark for newly-created Scratch Pools Definition: Specifies the threshold of scratch pools per library. If the number of scratch pools falls below the defined threshold, events will be triggered, and alerts, if configured, will be triggered as well.

Default Value: 20

Range: 0 to 9,999

Usage: Newly created Tape Scratch Pools will be given this value for low-water mark of the number of tapes required in the pool. Events, and Alerts if configured, are generated. This value should be set to the maximum number of tapes you anticipate consuming in a 48 hour (weekend) period. This should then give you ample warning to replenish the media in the pools to avoid data protection failures from insufficient media.

Deletion of jobs will not force full on next backup Definition: Specifies that if a job is pruned, the next job will not automatically be forced to be a full backup, it will be a differential backup.

Default Value: 0

Range:0 (disabled) or 1 (enabled)

Usage: After the initial Full backup, jobs may be pruned manually because they failed or were improperly run. To ensure data integrity a new Full backup should be run. In some cases this may not be necessary or prudent. Temporarily enabling this parameter allows the administrator to control that action as may be required.

Do not check for shared index cache when adding datapaths to storage policy copy Definition: Specifies that the shared index cache check is not performed when specifying data path in the Storage Policy Copy properties dialog box.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: Use this option is useful to disable the check for shared index cache when specifying data paths from different MediaAgents in the Storage Policy Copy properties dialog box when Round Robin between Alternate Data Path and Use Alternate Data Paths options are configured. Note that this option is applicable only for the MediaAgents which are in version 10.

Do not fail migration for client GUID conflict Definition: During CommCell Migration (CCM) operation, this parameter marks the import job as failed when the client GUID conflict error is encountered.

Default Value: 0

Range:

  • 0 - marks the import job as failed when client GUID conflict error is encountered during CCM import.
  • 1 - skips client GUID conflict error and continues the import job without any error message. This value overrides the destination client with the source client.
Do not mark media full when encountering CRC error Definition: Specifies that the media will not be marked full when CRC (Cyclic Redundancy Check) error is encountered.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: Use to control media consumption.

Enable compression on Media Agent for Oracle/Oracle RAC Non-Dedup backups Definition: Specifies the client or MediaAgent for Oracle and Oracle RAC log backups when you use a non-deduplication storage policy.

Default Value: 0

Range: 0 (client side compression) or 1 (MediaAgent compression)

Usage: Use to control compression.

Export Operation Retry Count Definition: Specifies the number of times an export operation must be retried by the MediaAgent when a mail slot is full.

Default Value: 10

Range: 0 to 10

Usage: This parameter may be used in conjunction with export alerts to ensure export is given chance to succeed before failing.

Fail Commcell Migration for Unsupported applications Definition: Specifies that CommCell Migration will fail if unsupported applications are found during migration operations.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: Microsoft Windows File System, Unix File System, Simpana OnePass for Windows and Unix, Laptop Backup for Linux and Windows support CommCell Migration. If this parameter is enabled (default), any migration involving unsupported application will fail. If this parameter is disabled, the migration will process only supported applications.

Fail Commcell Migration if Subclient to export is deleted before export completes Definition: Specifies that CommCell Migration will fail if subclients (backupsets/instances/clients) selected for export job was not available when export job was initiated.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: If the value is set to 0 then the export job will succeed even though the specified subclients (backupsets/instances/clients) are no longer available.

Ignore media and drive use count thresholds for Virtual Tape Libraries Definition: Specifies whether the media and drive count threshold is ignored for Virtual Tape Libraries.

Default Value: 1

Range: 0 (No) or 1 (Yes)

Usage: Tape drive and media usage and error thresholds, if reached, can mark the drive or media offline or bad. This is usually not necessary in a Virtual tape environment.

Import only media that were not moved to IE Port as part of export operation Definition: Specifies that media that are waiting in the I/E Port for export are not reimported into the library.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: By default, the import operation imports all media that are in the I/E Port regardless of their status. When this option is set to 1 (enabled), media that are waiting in the I/E Port for export are not reimported when outside media are imported into the library.

In CCM use destination schedule policy with same name in source Definition: Specifies that the Schedule Policy is not migrated when a schedule policy exists on the source CommCell with the same name as the destination CommCell.

Specifies that if the schedule policy on the source CommCell exists with same name on the destination CommCell, then that schedule policy is not migrated.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: By default, during CommCell migration, the source CommCell schedule policy gets migrated to destination CommCell with source CommCell name as prefix. If there are schedule policies (for example, system generated schedule policies) with the same name on source and destination CommCell, then enabling this parameter does not allow you to migrate those schedule policies to destination CommCell.

Interval (hours) between marking large disk volumes full Definition: Specifies the interval (hours) between marking all disk volumes full.

Default Value: 8 Hours

Range: 1 to 168

Usage: Used to keep disk volume sizes (and number of chunks/files per volume) to a manageable level. In this case time is used to limit the size for those situations where the data chunk sizes are smaller.

Interval (in minutes) to clean up deleted storage policies or copies Definition: Specifies the time in minutes for cleaning up deleted storage policies.

Default Value: 30

Range: 1 to 1440 minutes

Usage: Removes deleted Storage Policies from the CommCell Console

Interval (Minutes) between disk space updates Definition: Specifies how often the disk space information is updated for mount paths associated with disk libraries.

Also, if Enable Managed Disk Space for disk data option is enabled in the Retention tab of the Copy Properties dialog box, data is also deleted (if necessary) if it has been marked for deletion by a Data Aging operation.

Default Value: 30 minutes

Range: 5 to 60

Usage: Best used to free up managed disk space in a timely manner.

If the value is set to zero, then the disk space information is updated every 10 minutes.

Interval between volume size update requests Definition: Specifies how often a request is sent to update volume size for all the MediaAgent(s).

Note: If you have upgraded from V 9.0 to the current version, the Interval between volume size update requests parameter is available on the Data Aging tab.

Default Value: 360 minutes

Range: 0 to 2880 minutes

Usage: If the value is set to zero, then the request will not be sent to update the volume size.

LAN MediaAgent liveliness check interval in Minutes Definition: Specifies the interval at which the LAN MediaAgent (MediaAgent and Client are not on the same computer) will execute a liveliness check. These intervals tend to be smaller, as frequent liveliness checks are needed for a network environment.

Default Value: 30

Range: 2 to 1440

Usage: Liveliness checks are conducted to ensure necessary services are running and listening. Increasing the interval value may be recommended to minimize network traffic if you have a large number of LAN MediaAgents and you have other mechanisms in place to verify network and services availability.

LAN-Free MediaAgent liveliness check interval in Minutes Definition: Specifies the interval at which the LAN-free MediaAgent (MediaAgent and Client are on the same computer) will execute a liveliness check. These intervals tend to be larger, as fewer liveliness checks are needed for a LAN-free environment.

Default Value: 1440

Range: 2 to 2880

Usage: Liveliness checks are conducted to ensure necessary services are running and listening. Decreasing the interval value may be recommended to detect MediaAgent unavailability if MediaAgent services tend to hang or not start.

Library Arm Controller failover interval in Minutes Definition: Specifies the interval at which the library will be checked for being offline, at which point the fail-over system will take over.

Default Value: 10

Range: 2 to 1440

Usage: MediaAgents writing to a tape drive in a library get immediate indication of a tape drive going offline. The MediaAgent which has Library Arm Control does not get any indication until it needs to execute a tape movement command. As such, periodic operational status checks of the library are considered prudent. The overhead involved in performing this check is minimal. Failover interval should be set to account for the minimum time between tape movement commands.

Maximum number of attempts to continue GRC export with no consumption Definition: Specifies the number of database dump file to be generated when merge is not happening during GRC export job.

Default Value: 5

Range: 0 to 10

Usage: During export job of GRC, if the merge doesn't happen then the database dump file generation can be limited based on the number specified in this parameter. This parameter is useful to manage the number of database dump files generation and maintain disk space.

Generation of the database dump file will be stopped automatically when the number of dump file during the merge not happening exceeds the value specified in this parameter.

Maximum number of days to continue GRC export with no consumption Definition: Specifies the number of days to generate the database dump file when merge is not happening during GRC export job

Default Value: 30 days

Range: 1 to 180

Usage: During export job of GRC, if the merge doesn't happen then the database dump file generation can be limited based on the number days in this parameter. This parameter is useful to manage the database dump files generation and maintain disk space.

Generation of the database dump file will be stopped automatically when the number of generation days during the merge not happening exceeds the value specified in this parameter.

Maximum number of Exported (CCM) Dump sets to be retained in any dump location Definition: Specifies the number of dump sets (which contain the Disaster Recovery backup files) to be retained in any dump location.

Default Value: 10

Range: 1 to 9999

Usage: Used to maintain disk space used for CommCell Migration (CCM)

Maximum number to retries on snap operation Definition: Specifies the number of retries for mount, unmount, or other operations after which the operation is not attempted anymore automatically.

Default Value: 5

Range: 5 to 100

Usage: Prevents excessive retries due to SCSI errors.

Maximum size per batch to process managed disk space Definition: Specifies the maximum size per batch to process managed disk space.

Default Value: 50,000

Range: 512 to 1,000,000

Usage: Managed disk space process is run every 30 minutes to evaluate if used disk space as exceeded its maximum threshold and, if so, erases aged data until the minimum threshold level is achieved. The maximum number of jobs erased in each event is determined by this parameter. Too high a parameter may impact other jobs. Too low of a parameter may not free up space in time.

If the specified value is less than 512, it will automatically updated to 512.

Media Management Maintenance Check Interval in Minutes Definition: Specifies the interval at which the following media management maintenance issues will be checked:
  • Disk space thresholds
  • Media being offline
  • Media that needs to be marked as invalid

If any of these items fail to meet the defined thresholds then any configured events or alerts will be triggered.

Default Value: 15

Range: 5 to 1440

Usage: Default setting assumes that 15 minutes of disk write along with the time required to remove data will prevent the library from hitting capacity limits. If disk write speed is higher or capacity lower, then decreasing this setting might be prudent. Increasing this value may reduce overhead or enable the process to occur at a more convenient time.

Migrate the subclients having no jobs for GRC Definition: For GRC, use this parameter to migrate the subclients that has no backup jobs.

Default Value: 0

Range: For a selected client or backupset, value

  • 0 - imports all the subclients that has at least one backup job.
  • 1 - imports all the subclients that has no backup jobs.
Mount Path Fragmentation Threshold percentage Definition: Specifies the allowed fragmentation percentage for the mount path. If the fragmentation on the mount path is above this percentage, then the mount path would be considered fragmented.

If the defined threshold has been met, the Library Management Maintenance Required alert, if configured, will be triggered.

Default Value: 100%

Range: 1 to 100

Usage: Used in conjunction with Per File Threshold Percentage to minimize the level of fragmentation on a magnetic library mount path. Fragmentation will degrade read performance for restore or auxiliary copy operations. Amount of fragmentation can be reported for each mount path as a measure of performance expectations and need to performance maintenance.

Number of days in advance to trigger alert for low disk space for disk library Definition: Specifies the number of days in advance that you receive an alert that a disk library is about to run out of space (low disk space alert).

Default Value: 0

Range: 0 (disabled) or > 0 (enabled)

Usage: When you specify a value greater than 0, you receive a low disk space alert n days before the disk library runs out of space (where n = the value specified). If you configure a low disk space alert, you do not receive notifications for low watermark or warning watermark.

Number of disk folders to process in a single Data Aging request Definition: Specifies the number of folders that will be processed in a single request as part of disk cleanup.

Default Value: 1000

Range: 1 to 5000

Usage: Too many folders can impact Data Aging performance and timing. Too few folders might not include all of the folders that need to be reviewed for aging.

Number of Subclients to be stored in a single dump file (exported by CCM) Definition: Specifies the number of subclients in each dump file.

Default Value: 50

Range: 1 to 100

Usage: Used to manage the size of the dump file generated by a CommCell Migration Export job.

Number of volumes for size update Definition: Specifies the number of volumes that gets sent to the MediaAgents for volume size update.

Note: If you have upgraded from V 9.0 to the current version, the Number of volumes for size update parameter is available on the Data Aging tab.

Default Value: 1000

Range: 50 to 50,000

Usage: Sets the batch count per MediaAgent or volume update information.

Per-file fragmentation threshold Definition: Specifies the number of fragmentation allowed for each file. The default value is set to 10.

Default Value: 10

Range: 1 to 10000

Usage: Used in conjunction with Mount Path Fragmentation Threshold Percentage to minimize the level of fragmentation on a disk library mount path. Fragmentation will degrade read performance for restore or auxiliary copy operations.

Perform Smart Clone operation by snap engines Definition: Specifies to enable the Smart Clone for IBM SVC Flash copy operation.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: This parameter enables to perform Smart clone operation. During Smart Clone operation the regular jobs except revert operation will be continued as normal. Revert operation can be performed only when the Flash copy operation is completed.

Prefer MediaAgent having same additional setting as client Definition: Allows you to select the MediaAgents based on the geographic location as that of the client when both have PreferredMediaAgentGroup additional setting with same values.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: By default, the value is set to 0. To enable dynamic mapping between MediaAgents and roaming clients, set the value to 1.

Provide user with MediaAgent management rights additional capabilities for libraries, data paths, and storage policies Definition: Specifies how MediaAgent Management permissions are checked for a user.

If this value is set to 1, the user has the following additional rights to manage the MediaAgent that they have rights on:

  • Configure or deconfigure libraries and drives.
  • Create, update or delete a Storage Policy with libraries and drives on the MediaAgent.
  • Add data paths to the MediaAgent.
  • Add the user group (the user belongs) to the newly-configured libraries.

If this value is set to 0, the additional operations are not supported and they revert back to the default behavior. In the default behavior, the user must have Storage Policy Management and Administrative Management rights to perform the above operations.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: Used similar to the Library Administration versus Library Management rights assigned to a CommCell User Group. Library Management grants additional task capabilities that would otherwise be reserved for Administrative Management. Enabling this parameter does the same thing for MediaAgent level tasks otherwise requiring Administrative Management or Storage Policy Management rights.
Retain scratch media information when deconfiguring library Definition: Specifies whether the scratch (new/aged) media information is retained when a tape library is deconfigured.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: Controls the retention of scratch media if library is deconfigured.

Show hidden storage policies Definition: Specifies whether hidden storage policies are visible in the CommCell Console.
  • If this value is set to 0, storage policies with the Hide Storage Policy option selected are not visible from the CommCell Console. Additionally, creating or editing a subclient, the storage policy cannot be selected.
  • If this value is set to 1, all storage policies remain visible, and all previously hidden storage policies become visible.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: Once storage policies are hidden, the only way to unhide them is to enable this parameter and then clear the Hide Storage Policy option.

SIDB Reconstruction prune replay batch count Definition: Specifies the number of prunable data blocks sent in a batch to deduplication database.

Default Value: 1000

Range: 1 to 100,000

SIDB Reconstruction prune replay retry count Definition: Specifies the number of times DDB Reconstruction has to replay the prune data blocks before reporting failure.

Default Value: 100,000

Range: 1 to 100,000

Usage: Controls the retry limit for DDB reconstruction failure.

Snap Prune Interval in Minutes Definition: Snap configuration to manage and control the time interval (in minutes) between snap physical delete requests for aged and/or failed snaps from Media Manager.

Default Value: 1 minute

Range: 1 to 1440 minutes (1 day)

Usage: Use the parameter to manage the time interval between requests for physical deletes on aged snaps, failed snaps, or both.

Data Aging

Parameter Description
Allow administrators to lower job retention on WORM copies Definition: Specifies that user that are members of master user group can now modify the retention period of Retained jobs associated with WORM copy.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Consider inactive copy for Auxiliary Copy check by Data Aging Definition: Specifies that the source copy data will not be pruned if it is not copied on the inactive copy.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: If a secondary copy is created for a storage policy, all source copy data required by that destination copy – either synchronous (all data) or selective must be retained until a successful auxiliary copy operation has been completed. This action may not be desired if (a) you are creating secondary copies now with the intention of them holding data at a later point-in-time. Or (b) you forgot to delete a secondary copy and the data movement is no longer required. In either case, you can set the copy status to inactive and set this parameter to 0 (disabled), enabling subsequent Data Aging operation to prune all data being retained solely for pending auxiliary copy operations to now inactive copies.

Days to consider for pending logical pruning for Deduplication pruning threshold event Definition: This parameter allows you to generate an event message when the number of deleted records are older than the 7 days and meets the threshold value specified in the Max number of records pending logical pruning for Deduplication pruning threshold event parameter.

Default Value: 7 days

Range: 1 – 100 days

Usage: For example, you have set the number of days to four on Friday (01-20-2013) and the threshold value in the Max number of records pending logical pruning for Deduplication pruning threshold event parameter is set to 10,000. If the number of deleted records older than past Monday (01-16-2013) is greater than the threshold value that is 10,000, then an event message is generated. Once the value is set the check is performed every day to verify both the criteria.

Days to keep Content Indexing Pruning Information Definition: Specifies the number of days to maintain the history of the content indexed data that has been pruned.

Default Value: 90 days

Range: 7 to 180 days

Usage: This parameter is useful to retain the content indexing pruning information for specified number of days.

Days to keep Data Management and Collection Job Histories Definition: Specifies the number of days the data management and data collection jobs histories are preserved.

Default Value: 90 days

Range: 0 to 5000

Usage: Retaining job history for longer or shorter periods may be required for compliance, auditing, or other reasons.

Days to keep invalid chunks Definition: Specify the number of days that invalid chunks are preserved.

Default Value: 3

Range: 3 to 10 (Values set to less than 3 are reset to 3).

Usage: An invalid chunk is one where the job was interrupted and the chunk needed to be rewritten for integrity purposes. Data from these invalid chunks are usually unrecoverable, but could provide some data recovery in a DR situation where no other valid chunks exist.

Days to keep Job data cost history Definition: Specifies the number of days to retain the data cost history of the jobs.

Default Value: 90 days

Range: 7 to 180

Usage: This parameter is useful to retain the history of cost associated with each job. Once the specified number of days is reached, the job cost history will be pruned.

Days to keep job options for a completed job Definition: Specifies the number of days to retain the job option information (such as job resource history, Job failure reason, miscellaneous information and so on) in the CommServe database for a completed job.

Default Value: 30 days

Range: 7 to 999,999,999 days

Usage: Retaining job options for longer or shorter periods may be required for compliance, auditing, or other reasons.

Days to keep job status change history for GRC Definition: Specifies the number of days to retain the job status history performed in GRC.

Default Value: 90 days

Range: 7 to 180

Days to keep Library Histories Definition: Specifies the number of days to retain the information about disk usage on magnetic libraries, before it is pruned. Default value is set at 30.

Default Value: 30

Range: 7 to 180 days

Usage: Retaining disk usage for longer or shorter periods may be required for compliance, auditing or other reasons.

Days to keep Replication Backup Job Histories Definition: Specifies the number of days to retain the replication backup job histories. The default value is set to 90 days.

Default Value: 90

Range: 7 to 999,999,999 days

Usage: Retaining job history for longer or shorter periods may be required for compliance, auditing or other reasons.

Days to keep the archiver restore job histories Definition: Specifies the number of days to retain the archiver restore job history data before it is pruned. Note that when the value is set to 0, the retention is set to infinite and not zero days.

This setting is applicable only for Exchange Compliance Archiver. All other archiver restore job histories will be pruned based on the Days to keep the backup job histories parameter.

Default Value: 0

Range: 0 to 5000

Usage: Retaining job history for longer or shorter periods may be required for compliance, auditing, or other reasons.

Days to keep the failed/killed backup job and other job histories Definition: Specifies the number of days to retain backup job history data before it is pruned. This applies to: Auxiliary Copy jobs, Stub Recall jobs, failed jobs, killed jobs, jobs that failed to start, replication backup jobs, and all restore jobs except for archive restore job history.

Note: For auxiliary copy, stub recall, replication backup, and restore job history, this parameter applies to job start time.

Default Value: 90

Range: 0 to 5000

Usage: Retaining job history for longer or shorter periods may be required for compliance, auditing, or other reasons. Before reducing this number you should consider that valid chunks associated with failed/killed jobs can be restored using the Restore by Job task.

Days to keep the list of migrated foreign jobs to be pruned after processing them Definition: Specifies the number of days to maintain the history of the migrated foreign jobs.

Default Value: 7 days

Range: 3 to 30

Usage: This parameter is useful to retain the history of migrated foreign jobs for specified number of days. Once the specified number of days is reached the history of the migrated jobs gets pruned.

Days to keep the successful backup job histories Definition: Specifies the number of days to retain successfully completed backup job history data after it is pruned.

Default Value: 7

Range: 0 to 5000

Usage: Retaining job history for longer or shorter periods may be required for compliance, auditing, or other reasons. Successful backup job history is retained for as long as the data is restorable plus the number of days specified here. Increasing this number might be prudent if you are doing trend analysis on information contained within the backup job histories.

Days to retain the jobs when cycles are ignored and retention days on copy is 0 Definition: Specifies the number of days to retain a job when its cycles are ignored and retention days are 0.

Default Value: 30

Range: 1 to 999

Usage: This is to protect you from inadvertently deleting data by incorrectly setting a storage policy copy’s retention criteria.

Delete deconfigured clients that have no protected data Definition: During data aging job, if there are clients or restore-only clients that are in deconfigured state, those clients will be deleted if there are no jobs associated with them.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Usage: By default, the value is set to 0 which means that clients or restore-only clients that are deconfigured will not be deleted.

If there are no job associated with the deconfigured clients, and to delete those deconfigured clients or restore-only clients that are in deconfigured state, set the value to 1.

Notes:

  • For tape library, the deconfigured clients are deleted only when all the media associated with the tape library are recycled.
  • Auto discovered Virtual Server clients will not be deleted.
Honor Storage Policy Retention for Content Store Data Definition: Specifies to use the Storage Policy retention rules than the rules specified on the object link subclients (at the site / document level) for the object link data.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Usage: By default, the value is set to 0 which means it will honor the retention rules specified on the subclient. Set value 1 to honor the storage policy retention rules.

Ignore Completed With Errors job option for Extended Retention calculations Definition: Specifies whether or not to ignore the Completed With Errors job option for Extended Retention calculations.

Default Value: 0

Range: 0 (No) or 1 (Yes)

When the value is set to '1', the current value set for the Completed with Errors job in the agents' database is ignored for extended retention calculations. When the value is set to '0', the current value set for the Completed with Errors job is honored for extended retention calculations.

Usage: Administrator may hold extended retention Jobs to a higher standard than those used to determine normal media/retention cycle.

Ignore Compliance Policy Check For Job Data Aging Definition: Specifies whether or not to ignore the Compliance Policy Check for Job Data Aging.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Usage: Applies to the Automated Content Classification Policy. During a data aging operation, if a particular job is qualified to be processed by an Automated Content Classification Policy, the data will be retained even though it is eligible to be aged, until it is acted upon by the Automated Content Classification Policy. Setting this value to 1 will allow data aging to prune the job regardless.

Ignore Cycles Retention On De-Configured Clients Definition: Specifies whether or not to ignore the defined retention cycle rules for data associated with deconfigured clients.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Usage: Without cycle retention (parameter value set to 1), only days are used to retain data on deconfigured clients. Ultimately, all data will be pruned in this case. The default keeps at least the last cycle of the data.

Note: The following Simpana OnePass agents ignore the Ignore Cycles Retention on De-Configured Clients parameter:

  • BlueArc
  • Celerra
  • NetApp
  • Non-NDMP File Servers
  • Unix
  • Windows
  • Exchange Mailbox
Max number of records pending logical pruning for Deduplication pruning threshold event Definition: Specifies the threshold value of the deleted records that are not pruned from the disk.

Default Value: 10000

Range: 5000 – 1000000

Usage: For example, you have set the threshold value to 10,000 records, and the number of days in the Days to consider for pending logical pruning for Deduplication pruning threshold event parameter is set to four on Friday (01-20-2013). If the number of deleted records older than past Monday (01-16-2013) is greater than the threshold value that is 10,000, then an Event message is generated. Once the value is set the check is performed every day to verify both the criteria.

Maximum job entries to use for calculation of media retention expire time Definition: Every few minutes the media retention time is recalculated for media that is written to in that time. This entry specifies how many entries are processed.

Default Value: 5000

Range: 0 (all) to 9,999,999

Prune All Database Agent Logs Only By Days Retention Rule Definition: Specifies whether or not to ignore the log rule for all Database agents.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Usage: Database logs retention can be linked to the retention of the related database file. Therefore, if you retain a full database backup, related transactional logs will also be retained until the full database backup is pruned regardless of any lesser retention setting for the logs.

  • When the value is set to 0 the log rule is honored.
  • When the value is set to 1 the log rule is ignored and only days to retain logs is used. This might be riskier for point-in-time recovery.
Retain DDB Backups of sealed stores Definition: Specifies whether or not to retain the DDB backup of a sealed DDB.

When the value is set as 1 the last DDB backup job that was backed up before sealing the DDB is kept. Set value as 0 to not retain the DDB backup job.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Auxiliary Copy Configuration

Parameter Description
Allow AuxCopy for deduplication database backup jobs Definition: Specifies to select or skip the DDB backup jobs during Auxiliary Copy operation. Once disabled, the DDB backup jobs on the primary copy are disabled (grayed) to copy during Auxiliary Copy operation.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Usage: This is useful to skip DDB backup jobs during Auxiliary Copy operation to save the space on the storage and to reduce network bandwidth usage.

Allow multiplexed data to be copied to deduplication enabled storage policy copy Definition: Specifies to copy multiplexed non-deduplicated data to a deduplicated storage policy copy.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Allow user to modify selective copy job selection period start time Definition: The job selection period for selective copy is based on the copy creation time. Enabling this parameter allows you to modify the selection period for advanced backup frequency criteria (such as for Every <n> cycles/days/weeks/months). Once enabled, the following options are displayed in the Copy Policy tab - Selective Copy Properties dialog box.
  • Prev Period Start Time
  • Current Period Start Time
  • Next Period Start Time
  • Move Job Selection Period Start Time by [ x ]

These options appear after closing and re-opening the CommCell Console. See Modifying the Job Selection Period for the step-by-step procedure.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Copy first full jobs for new subclients on secondary copy with deduplication enabled before copying other data Definition: Specifies to copy only the first full backup jobs of the subclients during Auxiliary Copy operation.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: This parameter is useful to copy only first full backup jobs of the subclient during Auxiliary copy operation when there is large amount of data to be copied and when:

  • There are no full backup jobs available on the secondary deduplicated copy.
  • There is a new secondary deduplication copy.
  • The deduplication database of the secondary copy is sealed.

For more information, see Configure Auxiliary Copy to Copy First Full Backups of the Subclient.

DDB Recover job progress update to job manager interval (mins) Definition: This is an advanced parameter that specifies the interval to update the progress of the DDB reconstruction job to the Job Manager service.

Default Value: 5 minutes

Range: 0 to 30 minutes

Interval (Hours) between Auxiliary Copy Fallen Behind alerts Definition: Specifies the interval at which the storage policy will be checked for the following criteria:
  • data to be copied is more than n GB
  • jobs have not been copied in more than n days

    (n is set by the user in the Storage Policy Properties (Advanced) dialog box.)

If the defined thresholds have been met, an alert, if configured, will be triggered.

Default Value: 24 hours

Range: 1 to 168 hours

Usage: An Auxiliary Copy operation is usually schedules on a frequent (24 hours) basis to ensure that additional copies of the source data exist when the source data become bad or otherwise unavailable. As Auxiliary Copy operations have a lower priority for resources, there can be situations where the data movement is delayed beyond acceptable limits or has grown to such a size as it may adversely impact other operations. Threshold alert warnings can be configured for these conditions. This settings allows the administrator to set how often these conditions are checked.

Interval (in minutes) to retry a failed stream Definition: Specifies the interval, in number of minutes, to retry a failed data stream for auxiliary copy, offline content indexing or data verification.

Default Value: 15

Range: 1 to 9999

Usage: When source/ target media/drive may experience problems causing streams to fail.

Mark a job bad on encountering corrupt data during auxiliary copy/data verification operation Definition: During Auxiliary Copy or Data Verification operations, prevents the job that has invalid data from being copied. The status of a job on a secondary copy is set to Do Not Copy, set to Bad on source copy.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: Used for automatically flagging jobs with invalid underlying data so that the Auxiliary Copy and Data Verification operation does not fail.

Maximum number of stream retry count Definition: Specifies the value to retry every stream for failed data chunk before the job is marked as pending.

Default Value: 2 times

Range: 2 to 30

Usage: This is useful when one of the job encounters stream failure due to no-access to media/volume and you want to allow job to retry every stream for failed data chunk before job is marked as pending.

Numbers of jobs for throughput calculation for auxiliary copy fallen behind alert (hours required to copy) Definition: Specifies the quantity of jobs to calculate the throughput for Auxiliary Copy fallen behind alert

Default Value: 5

Range: 3 to 100

Usage: The average throughput time is calculated based on the last 5 auxiliary copy jobs run.

Skip AuxCopy Reservation request when backup jobs in waiting state exceeds Definition: Specifies the threshold for the number of backup jobs that can be in Waiting state when Auxiliary Copy jobs are running. When the threshold is exceeded, the resource reservation requests of the running Auxiliary Copy jobs are skipped until the number of backup jobs fall below the specified threshold limit.

Default Value: 0 (disabled)

Range:  0 to 9999

Usage:  In a large environment, in which many backup jobs are set to Waiting state, use the setting to skip the Auxiliary Copy jobs to reserve resource.

Skip AuxCopy Reservation request when backup jobs in waiting state exceeds check interval in mins Definition: Specifies the time interval, in minutes, after which the number of Waiting backup jobs are checked and requests for the Auxiliary Copy resource reservation are either sent or ignored.

Default Value: 5 minutes

Range: 1 to 60 minutes

Usage:  Use to manage the time interval in which to check the number of Waiting backups, and make or skip Auxiliary Copy resource reservations based on whether it exceeds the threshold set in Skip AuxCopy Reservation request when backup jobs in waiting state exceeds parameter.

Skip job on read errors during Auxiliary Copy Definition: Specifies whether the system will skip the chunks with read errors during an Auxiliary Copy operations.

A value of 0 indicates that the Auxiliary Copy job will fail with the error "Auxiliary Copy job Failed to copy or verify chunk".

A value of 1 indicates that the Auxiliary Copy job will skip the chunk and continue the operation.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: Read errors during Auxiliary Copy operation can slow or fail the operation keeping valid data that may exist further along on the media from being copied in a timely manner. Read errors can be caused by dust in the tape drive, track alignment, or unreadable data. This parameter allows the operation to skip the read error and copy all valid data before going back to attempt additional reads. Only after all subsequent read attempts fail the Auxiliary Copy job will fail.

Skip unavailable media Definition: Specifies whether the auxiliary copy or offline content indexing job skips unavailable media or goes into a wait state.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Usage: Source media required for Auxiliary Copy or Content Indexing operation may be occupied or not in state that would allow automatic access (exported). Default is to wait for this media which is the prudent this to do, but may cause long waits. Allowing the processes to skip unavailable media should be used for troubleshooting.

Source signature cache buffer size (in KB) Definition: Specifies the signature buffer size on the source MediaAgent for auxiliary copy deduplication.

Default Value: 4096

Range: 1024 to 7168

Usage: Signature cache space holds transaction logs waiting to update the database. Increasing this value may improve performance if the processing of signatures is not the Auxiliary Copy data movements bottleneck.

Storage Policy Copy Summary Populate Interval Definition: Specifies the time interval at which the storage policy will be checked for the following information:
  • jobs to be copied
  • jobs have not been copied since 'n' number of days

    (n is set to 30, 60 and 90 days)

Default Value: 24 hours

Range: 1 to  9999

Usage: For an Auxiliary Copy, this parameter checks the “data to be copied” and “data has not been copied” information to populate the values in the Storage Policy Copy summary.

Time (in minutes) after which job will be preempted on continuous resource reservation failures Definition: Specifies the time interval, after which job will be prevented if there are any continuous resource reservation failure.

Default Value: 30 minutes

Range: 5 to 360 minutes

Usage: If any job (such as Auxiliary Copy, Content Indexing, Data Verification, Media Refresh & DDB Reconstruction jobs) is facing resource reservation issues constantly for specific amount of time, where it is unable to secure any resources at all to run, the job will be put into pending state. Once the job goes pending, it will be retried by the Job manager based on the job type’s restart interval (see Job Management in Control Panel).

Time-out (in minutes) for aliveness check Definition: Specifies the time-out interval for Auxiliary Copy process aliveness check.

Default Value: 5

Range: 1 to 9999

Usage: Aliveness checks verify that running jobs are in a consistent state with the necessary communication links available to all necessary components.

Silo Archive Configuration

Parameter Description
Hours after being marked as Full for archiving Silo volumes to tape Definition: Specifies the number of hours the Silo volumes that are marked Full must be retained in the disk media, before moving it to tape storage. A value of zero implies all full disk volumes will be marked for migration as part of Silo Archival Job, as long as the volume is not in use.

Default Value: 8 hours

Range: 0 to 72

Usage: Volumes are marked full by default every 8 hours per the Interval (hours) between marking large disk volumes full  parameter. If you increase that value, this value needs to be increased to same.

Interval (in minutes) to free the Silo cache. Definition: Specifies the interval at which the Silo cache will be refreshed. Note that when the value is set to zero, Silo cache refresh will be disabled.

Default Value: 1440 minutes

Range: 0 to 10000 minutes

Usage: Interval at which space management is performed on the disk library for removing Volumes copied to Silo storage. Threshold settings are set in the Disk Library Properties dialog box and Space Management is enabled in the Storage Policy Copy dialog box. Disabling the cache effectively stops removal of volume folders.

Vault Tracker Configuration

Parameter Description
Container cleanup interval days Definition: Specifies the number days for which the container will be kept after it becomes empty before it is deleted.

Default Value: 90

Range: 30 to 365

Usage: System defined containers are removed when empty. User predefined containers are retained for the number of days specified here.

Days to keep Vault Tracker records Definition: Specifies the number of days the Vault Tracker history will be retained.

Default Value: 90

Range: 10 to 120

Usage: Retaining Vault Tracker history for longer or shorter periods may be required for compliance, auditing, or other reasons.

For VT export policy, consider manually retained jobs also as extended retained jobs Definition: Converts the manually retained jobs to extended retained jobs for exporting media.

Default Value: 0

Range: 0 (disabled) 1 (enabled)

Usage: By default the value is set to 0 which indicates that the manually retained jobs will not be eligible for extended retention. Setting the parameter value to 1 will convert the manually retained jobs to extended retention jobs.

Hours to keep Vault Tracker actions alive Definition: Specifies the number of hours to keep the Vault Tracker actions alive.

Default Value: 72

Range: 2 to 9999

Usage: Allows time for manual/user response to extract exported media from library.

Include Media Repository shelves in destination library list when moving exported media Definition: Specifies that media repository shelves can be included in the list of destination library and exported media can be moved to these shelves.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: Enables you to move the exported media to a media repository shelf to track and manage media that you want to store in an outside storage locations.

Interval (Minutes) between Vault Tracker alerts Definition: Specifies the minimum interval that is used between Vault Tracker related alerts in minutes

Default Value: 15

Range: 1 to 60

Usage: Jobs awaiting user action with alerts enabled will receive new alerts according to this time interval.

Time in hours to show the Vault Tracker history in the actions pane Definition: Specifies the time in hours for which the Vault Tracker history will be displayed in the actions pane in the CommCell Console.

Default Value: 0, which displays the history for 15 minutes

Range: 0 to 72

Usage: The default settings assumes that morning's Vault Tracker action history will be displayed during the day and deleted before the next nights Vault Tracker actions occurs.

Vault Tracker Policy option to import tapes based on number of empty slots in library Definition: Specifies to import tapes based on the empty slots.

Default Value: 0

By default the value is set to 0 which indicates that the check for empty slots is disabled. Set value as 1 to perform a check for empty slots in the library during policy action.

Range: 0 (disabled) or 1 (enabled)

Usage: This options is for Vault Tracker Policy which is using Due back for reuse option, when the Vault Tracker policy is run, it checks the number of empty slots in the library and if there are not enough slots for the media that are to be imported then the action will be failed.

Vault Tracker due back policy: Treat Library selection as original library and value Definition: Specifies whether to treat Vault Tracker library selection as original library.

Default Value: 0

Range:  0 (No) or 1 (Yes)

Usage: Treating a library selection as an original library enables returned media to be used as scratch media for that library instead of just appearing in the CommCell Console as a media from a different library and therefore unusable for writing in that library.

Vault Tracker export retry interval in minutes Definition: Specifies the time in minutes after which the Vault Tracker retries an export operation.

Default Value: 10

Range: 10 to 30

Usage: Gives the user time to get to the library to extract exported media and make the mail slot/CAP available for the next export.

Vault Tracker: Action history retention days Definition: Specifies the number of days Vault Tracker movement action history is retained in days.

Default Value: 90

Range: 1 to 9999

Usage: Useful for audit tracking/reports on removal media movement.

Vault Tracker: Allow media to reach export location even though media are in library Definition: Specifies that media will reach export location, even though media are in the library.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: Enables use of Automatic acknowledgement of data movement regardless of when the movement actually occurs. In this case, the media is expected to be eventually moved, but the reported location will change with the Vault Tracker job/schedule – not the actual movement.

Resource Manager Configuration

Parameter Description
Allow backup reservation to use spare based on barcode order only Definition: Specifies that the media will be selected based on barcode sequence.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

By default, the media available in the scratch pool is selected based on the Spare Media Selection Criteria, which is defined in the Spare Group Properties (General) dialog box. However, when this parameter is set to 1, media is selected based on the barcode sequence order. If the media barcode is a combination of numbers and strings, then the resource manager will select the media based on ascending string order.

For example, if this parameter is set to 1, then from a random barcode sequence order as mentioned below.

456002WW

456001WW

123002WW

BCD000WW

ABC003WW

The media will be selected in the following order:

123002WW

456001WW

456002WW

ABC003WW

BCD003WW

Allow backup jobs to run to deduplication storage policy copy when DDB being reconstructed Definition: Specifies the jobs to run to the deduplicated storage policy without deduplicating the data.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

This is useful when all partitions of deduplication database is offline or invalid and the deduplication database reconstruction is taking more time than expected, the backup jobs can be continued to the same deduplicated storage policy without deduplicating the data.

The value 1 represent Yes and value 0 represents No. By default the value is set to 0.

Allow Content Indexing jobs to do load-balance among Lan and Lan-Free Media Agents for processing and pushing data Definition: if this option is enabled, then the process of reading the data being pushed to the Search Engine will be shared between all available Media Agents.

 You can enable this option if the following criteria are met:

  • the setup contains a multi-node Search Engine
  • the library is shared between the appropriate MediaAgents
  • the data contains multistream backups
  • the mount path is accessible by all applicable MediaAgents (either defined in the Mount Path Properties or by UNC paths)

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: This is useful for increasing the performance of content indexing jobs.

The value 1 represent Yes and value 0 represents No. By default the value is set to 0.

Allow load-balance on multiple data paths within one backup job You can create reservations on multiple data paths at the same time if there is not enough Resources from any single data path. Use the following steps to reserve resource allocation using Media Management's Resource Manager for multiple data paths:
  1. From the CommCell toolbar, click Control Panel.
  2. Click Media Management.
  3. Click the Resource Manager Configuration tab.
  4. Select the Allow load-balance on multiple data paths within one backup job row. Double click the value box and set the Value as 1.
Allow Media used by Silo Archive job to contain data from different SIDB Stores Definition: Specifies whether a single media used by a Silo archive job can contain data from different deduplication database.

Default Value: 0

Range: 0 (No) or 1 (Yes)

Usage: Each deduplication database covers a period of time and the associated data. When a new DDB is started, the default action for Silo is to start new media. This parameter allows a tape/media to be shared between DDBs. If aging/recycling of Silo media is a concern, then leave this parameter in its default state (0/No). If conserving media is a concern, then enable (1/Yes) this parameter.

Allow restore jobs to use alternative MediaAgent and Drive Pool to access required media Definition: Specifies the subclient to use alternative MediaAgent which has access to media that has backed up data.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: This is useful when the existing MediaAgent of a subclient is unable to access backed up data during restore operation, by enabling this parameter the alternative MediaAgent will be used to access the media for restore.

Data Threshold (in GB) to decide how to distribute data among streams for backup Definition: Specifies the maximum amount of data that can be distributed among streams.

Default Value: 500 GB

Range: 0 to 5000

Usage: This parameter is used when stream randomization is enabled to balance the stream loading. A lower value will more evenly distribute the streams. A higher value may load one stream more than the other, but improved the throughput. A value of 0 disabled the use of stream randomization.

While backing up to multi-stream storage policy, by default, the first few streams in the storage policy accumulates a large percentage of data which gets protected. This results in non-optimal usage of number of streams during Auxiliary copy job, where the streams with large data will keep transferring data, while other streams will not have any data to transfer. Therefore, all streams will not be used during Auxiliary copy job, even if there are resources available to use. This will reduce the overall throughput of the auxiliary copy job. With this option, the maximum amount of data can be distributed among streams.

Disk volume physical size high watermark in GB Definition: Specifies the maximum size of the disk volumes, reaching which, a new volume will be created. The default value is set to 25 GB. You can set the value between 0 to 1,000.

If the value is set to '0' the high watermark check is disabled.

Default Value: 25 GB

Range: 0 to 1000 GB

Usage: Used to keep magnetic volume sizes (and number of chunks/files per volume) to a manageable level. There is little advantage to larger volumes. However, smaller volumes (25 GB) might be more prudent if using Silo storage where volumes are restored from tape to the magnetic library in support of file restore operations.

Force to use the same MediaAgent for create index and backup phases during NAS backup reservation Definition: When this option is enabled, during NAS backup, the backup phase is forced to run on the same MediaAgent where the create Index phase was run.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Honor use alternate data path configuration for picking index MediaAgent Definition: Specifies that the default data path will be selected for backup copy jobs if the Use Alternate Data Path option is selected.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

Usage: By default, for backup copy operations, the data path selection is random for agents like NAS when data path configuration is configured with Use Alternate Data Path option on the Storage Policy Copy Properties. With this parameter enabled, the default data path will be given highest preference for the backup copy operation.

Interval (in minutes) to calculate valid data size for streams Definition: Specifies the interval at which the valid data is checked to calculate the data size for streams.

If the value is set to '0' the data size calculation is disabled.

Default Value: 60 minutes

Range: 0 to 1440

Usage: Used when stream randomization is enabled to balance the stream loading. A lower value will check the stream and rebalance more often. A higher value may allow streams to expire, but improves throughput. A value of 0 disables the use of stream randomization.

Load-Balance among available Search Engines for Offline Content Indexing job Definition: Specifies the multi stream backup data to be distributed amount multiple nodes of a cloud.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: In a multi-node setup, when this parameter is enabled, the backup job will be distributed among different nodes for load balancing.

Maximum allowed number of drive reservations per NAS Filer Definition: Specifies the number of tape drives that can be in use on a particular NAS file server. This is useful since some file servers have a limit to the number of concurrent backup or restore jobs that can be run. The number entered will limit the number of tape drives that can be in use at a given time. For example, if five backup jobs were started for a particular NAS file server, but the number specified with this option was set to four, then the fifth job will be held in a waiting state until one of the jobs completes.

Default Value: 0

Range: 0 to 100

Usage: This is useful since some file servers have a limit to the number of concurrent backup or restore jobs that can be run. The number entered will limit the number of tape drives that can be in use at a given time. For example, if five backup jobs were started for a particular NAS file server, but the number specified with this option was set to four, then the fifth job will be held in a waiting state until one of the jobs completes.

Maximum number of parallel data transfer operations for deduplication database Definition: Specifies the number of streams used by backups, Auxiliary Copy operation, and so on, to access the deduplication database.

Default Value: 50

Range: 50 to 400

Usage: The number of streams to DDB should not exceed the maximum range as it may degrade the performance.

Note that, this parameter has precedence over the device streams specified on the Storage Policy properties. For example, if the Storage Policy is set to 100 device streams and this parameter is set to 50, then only 50 device streams will be used to access the DDB.

Prefer using LAN-Free Search Engine for Offline Content Indexing job Definition: Specifies whether LAN-free setup (that is, MediaAgent installed on the same computer as Search Engine) will be used for content indexing the data.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

By default, the value is set to 0, which means the search engine node on which the data will be content indexed is decided by the number of documents on a node.

Usage: For example, if node 1 has 10 Kb more documents that were content indexed successfully than node 2, then the data will be content indexed on node 2.

If the value is set to 1, then the data is content indexed on search engine node with LAN-free setup, that is, using the MediaAgent installed on the same computer as Search Engine.

Reserved free disk space (in MB) for Search Engine Definition: Specifies the low watermark of free disk space of Search Engine environment to decide whether a job can continue using current installation.

Default Value: 1000 MB

Range: 100 to 50000 MB

Return full detail job pending reasons for reservation failure Definition: Specifies the detail reason for resource allocation failure.

Default Value: 0

Range: 0 (disabled) or 1 (enabled)

By default the option is set to 0 to displays only top three reasons of the failure. If the value is set to 1, all reasons for each data path will be displayed.

Usage: In a storage policy copy that has many data paths, if there are any resource allocation failure for the data path, the reason behind this failure is displayed in the Job Controller for each data path.

Skip calculation for number of tape media in the library during reservation Definition: Omits calculating the number of tape media in the tape library when resources are allocated for a job.

Default Value: 1

Range: 0 (disabled) or 1 (enabled)

Usage: By default, the tape media calculation is omitted so that performance is optimized during resource allocation. To calculate the number of tape media, set the value to 0.

Timeout Interval (in minutes) for cached resources when using reservation backup caching feature Definition: Specifies the time-out interval for cached resources.

Default Value: 5 minutes

Range: 1 to 2880 minutes

Usage: This parameter is an interval for how long the resources should be on hold for resource caching feature.

This option is useful for the client backup jobs of iDataAgents (such as Oracle, Oracle RAC, DB2, DB2 DPF, and so on) that use the backup caching feature. If this option is enabled, resources will be on hold even if the stream has finished transferring data.

For example, if client backup job is using 4 job streams and only 2 device streams are available to transfer the data, 2 job streams will be allocated to use 2 device streams and the other 2 streams will be in waiting state. If the 2 streams have finished transferring data, these streams will be on hold till the amount of interval specified in this option. Once the timeout interval is reached, the other 2 stream will be allocated to the available 2 streams.

Chunk Size

Use the following parameters to establish the chunk size that must be used to write data for each Agent.

Parameter Description
Agent Type Lists the available Agents for which the chunk size can be established.
Chunk Size (MB) The data chunk size that will be used to write the appropriate agent's data on the media. (Applies only to tape media; for disk media the system by default uses 2 GB as the chunk size.) If necessary, click the integer in the column to change the chunk size. The system automatically resolves the chunk sizes to multiples of 8.

SCSI Error Translator

Use the following parameters to translate SCSI error messages returned from a library.

The  SCSI error message is a five digit hexadecimal code, such as 0x09 83h 02h. If the 0x0 and h are dropped the error message consists of the following three parts:

  • The first part (which is 9 in this example) is the sense key (SC) which is a hexadecimal number in the following range: A to F or 0 to 9.
  • The second part (which is 83 in this example) is the Additional Sense Code (ASC) and the third part (which is 02 in this example) is the Additional Sense Code Qualifier (ASCQ). Together, this provides detailed information about the error.

To translate the error code returned by the library, enter the SC, ASC and ASCQ and then click OK. The error message is translated and displayed in the SENSE CODE or ASC & ASCQ box.

Sense Codes

  • SC

    Specifies the sense code.

  • ASC

    Specifies the additional Sense Code (ASC)

  • ASCQ

    Specifies the additional Sense Code Qualifier (ASCQ)

Look Up

Click to display the description of the error code.

Error Description

  • SENSE CODE

    Displays the error message.

  • ASC & ASCQ

    Displays the error message.

Win Error Translator

Use the following parameters to translate Windows error messages returned by the operating system.

To translate the error code , enter the error code in the Error Code box and then click Look Up. The error message is displayed in the Error Description box.

Error Code

Specifies the error code.

Look Up

Click to display the description of the error code.

Error Description

Displays the description for the error.

Barcode Patterns

Use this dialog box to add or modify barcode patterns that can be used to identify media in the CommCell.

Add / Edit /Remove Pattern

Displays a list of barcode patterns that can be used to identify media.

Add

Click to add a new barcode pattern that must be used to identify media.

Edit

Click to edit the selected barcode pattern.

Remove

Click to remove the selected barcode.