LIFECYCLE_PARAMETERS file for optional SLP-managed job configuration on Windows

Article:HOWTO68315  |  Created: 2012-02-06  |  Updated: 2013-08-01  |  Article URL http://www.symantec.com/docs/HOWTO68315
Article Type
How To


Environment

Subject


LIFECYCLE_PARAMETERS file for optional SLP-managed job configuration on Windows

The NetBackup administrator can customize how the NetBackup Storage Lifecycle Manager (nbstserv) runs duplication and import jobs.

Both the Duplication Manager service and the Import Manager service run within nbstserv. Table: Role of the nbstserv services describes the role of each service.

Table: Role of the nbstserv services

nbstserv service

Purpose of service

Location of LIFECYCLE_PARAMETER file

Duplication Manager

Manages all operations within a storage lifecycle policy except the Import operation.

In the Auto Image Replication process, the Duplication Manager duplicates images and creates batches of the images to be imported to the target domain.

Configure Duplication Manager parameters in the source domain to tune jobs for Auto Image Replication.

Note:

The Duplication Manager parameters affect all SLP duplications, even those that are not duplicated to a target master server. Exercise caution when tuning for one case or the other.

Import Manager

In the Auto Image Replication process, the Import Manager monitors a worklist in EMM for images to be imported and initiates bpimport jobs for those images.

If the NetBackup environment is configured for Auto Image Replication jobs, configure Import Manager parameters in the target domain.

See About NetBackup Auto Image Replication on Windows.

The nbstserv default values work well for most environments. To change the values, the administrator must create a file named LIFECYCLE_PARAMETERS and save it in the following location:

install_path\NetBackup\db\config

One or all of the parameters in Table: Lifecycle parameters can appear in the LIFECYCLE_PARAMETERS file in any order. If the file does not exist, NetBackup uses the defaults as indicated.

Note:

In previous NetBackup versions, the syntax for the parameters did not require an equal (=) symbol. In upgraded environments, NetBackup automatically corrects the syntax to add the equal symbol.

Table: Lifecycle parameters

Parameter

Description

AUTO_CREATE_IMPORT_SLP

Affects:

Import Manager and Import operations only

Indicates to the Import Manager how NetBackup should handle notifications from storage about images for which there is no matching Import SLP.

The entry is Boolean, where a non-zero value directs NetBackup to create an SLP definition that uses the name that was provided in the import notification to the storage device.

Syntax: AUTO_CREATE_IMPORT_SLP = 0 | 1

0 = Select 0 to indicate that NetBackup should not automatically create an Import SLP if a notification is received for an Import SLP which does not exist.

1 = Select 1 to automatically create an Import SLP if a notification is received for an Import SLP which does not exist.

The SLP that is automatically created has the following characteristics:

  • The SLP is always a data classification of None.

  • The SLP always uses the default import priority.

  • The SLP always specifies any storage unit which includes the device from which the event was received.

Default: 1; storage lifecycle policies are created automatically.

To remove the parameter from the LIFECYCLE_PARAMETERS file has the same effect as 1.

See About the storage lifecycle policies required for Auto Image Replication on Windows.

CLEANUP_SESSION_INTERVAL_HOURS

Affects:

Duplication Manager and all operations except for Import operations

Concerns the deletion of SLP versions where a more recent version exists.

Controls how often nbstserv looks for the versions that have been deleted.

Syntax: CLEANUP_SESSION_INTERVAL_HOURS = nn_hours

Default: 24 (24 hours).

See Deleting old storage lifecycle policy versions on Windows.

DUPLICATION_GROUP_CRITERIA

Affects:

Duplication Manager and Duplication operations only

Indicates how batches are created. The entry applies to the use of tape and disk.

Syntax: DUPLICATION_GROUP_CRITERIA = 0 | 1

0 = Select 0 to indicate that batches be created based on the SLP.

1 = Select 1 to indicate that batches be created based on the Priority for secondary operations setting from the SLP. This setting allows multiple SLPs of the same priority to be together in one job.

Default: 1; use the Priority for secondary operations setting as defined in the SLP.

DUPLICATION_SESSION_INTERVAL_MINUTES

Affects:

Duplication Manager and all operations except for Import operations

Indicates how frequently the Duplication Manager starts a duplication session. During a duplication session, NetBackup looks for completed backups on the storage units of Backup operations and decides whether or not it is time to start a new duplication job.

Syntax: DUPLICATION_SESSION_INTERVAL_MINUTES = 5

Default: 5 (five minutes). Minimum: one minute.

IMAGE_EXTENDED_RETRY_PERIOD_IN_HOURS

Affects:

Duplication Manager and all operations except for Import operations

All copies must be completed in an SLP. If necessary, NetBackup initially tries three times to duplicate an image for an operation. The limit prevents NetBackup from retrying too frequently. If, after three tries, the operation is still unsuccessful, this parameter indicates how long NetBackup waits before the operation is added to the next duplication job. (The DUPLICATION_SESSION_INTERVAL_MINUTES parameter determines the frequency.)

The NetBackup administrator may need more than two hours (the default) to solve the problem. Alternatively, the administrator can temporarily de-activate an SLP using nbstlutil.

Syntax: IMAGE_EXTENDED_RETRY_PERIOD_IN_HOURS = 2

Default: 2 (two hours). Minimum: one hour.

IMPORT_EXTENDED_RETRY_SESSION_TIMER

Affects:

Import Manager and Import operations only

After four failed attempts, the Import Manager retries at the extended retry interval indefinitely or until the number of days specified by the REPLICA_METADATA_CLEANUP_TIMER parameter has elapsed.

Syntax: IMPORT_EXTENDED_RETRY_SESSION_TIMER = 360

Default: 360 (360 minutes; six hours).

IMPORT_SESSION_TIMER

Affects:

Import Manager and Import operations only

Indicates to the Import Manager how many minutes to wait between import sessions.

During an import session, the Import Manager performs the following tasks:

  • Cleans up image import status and increments the retry count of failed imports. The Import Manager retries in the current session.

    After four failed attempts to import an image, NetBackup enters an extended retry state. (See the IMPORT_EXTENDED_RETRY_SESSION_TIMER parameter description in this table.)

  • Deletes old, unimported import records. (By default, the records are not deleted and the Import Manager retries indefinitely. For the Import Manager to delete old import records, configure the REPLICA_METADATA_CLEANUP_TIMER parameter.)

  • Creates the batches of images for the import and starts the import jobs.

Syntax: IMPORT_SESSION_TIMER = 5

Default: 5 (five minutes).

MIN_GB_SIZE_PER_DUPLICATION_JOB

Affects:

Duplication Manager and Duplication operations only

Indicates the size that the batch of images should reach before one duplication job is run for the entire batch.

The SLP does not request a duplication job until either:

  • The aggregate size of the images in a batch reaches the minimum size as indicated by MIN_GB_SIZE_PER_DUPLICATION_JOB

  • The MAX_MINUTES_TIL_FORCE_SMALL_DUPLICATION_JOB time passes. This parameter determines the maximum time between batch requests.

Syntax: MIN_GB_SIZE_PER_DUPLICATION_JOB = GB_value

Default: 8 (8 gigabytes).

MAX_GB_SIZE_PER_DUPLICATION_JOB

Affects:

Duplication Manager and Duplication operations only

Determines how large the batch of images is allowed to grow. When the size reaches the size as indicated by this parameter, no additional images are added to the batch.

Syntax: MAX_GB_SIZE_PER_DUPLICATION_JOB = GB_value

Default: 25 (25 gigabytes).

MAX_IMAGES_PER_SNAPSHOT_REPLICATION_JOB

Affects:

Duplication Manager and Replication operations in a Replication Director configuration

Sets the maximum number of snapshot images that can be included in a snapshot replication job.

The value is used to tune the size of replication jobs to avoid overloading the replication infrastructure of the OpenStorage partner.

This parameter can be used in a Replication Director configuration to control how many snapshot jobs are sent to the disk array. To be effective, MAX_IMAGES_PER_SNAPSHOT_REPLICATION_JOB must be used with the Limit I/O streams disk pool option that limits the number of NetBackup jobs that can run concurrently to each volume in the disk pool.

Syntax: MAX_IMAGES_PER_SNAPSHOT_REPLICATION_JOB = nnn where nnn is the number of images to allow.

Default: 50 (50 images).

MAX_MINUTES_TIL_FORCE_SMALL_DUPLICATION_JOB

Affects:

Duplication Manager and Duplication operations only

Indicates how old any image in the group can become before the batch is submitted as a duplication job. It applies to both disk and tape.

The MAX_MINUTES_TIL_FORCE_SMALL_DUPLICATION_JOB entry works differently in this release than it did in previous releases.

A very small batch is not submitted to nbstserv until one source job in the batch has finished at least 30 minutes ago.

Note:

The timer does not come into effect if the total size of all the images in the batch exceeds the parameter value. Or, if all of the source media that the duplication job requires is full.

This parameter helps to ensure a balance between the following conditions:

  • Submitting many small duplication jobs too soon or too frequently.

    On the one hand, nbstserv doesn't want to submit a small job if there's additional work available to make the job bigger and more efficient.

  • Waiting too long before submitting a small job.

    On the other hand, nbstserv should not wait too long to submit a small job.

Syntax: MAX_MINUTES_TIL_FORCE_SMALL_DUPLICATION_JOB = 30

Default: 30 (30 minutes).

REPLICA_METADATA_CLEANUP_TIMER

Affects:

Import Manager and Import operations only

Indicates the number of days after which the Import Manager stops trying to import the image. After the number of days indicated, the record is deleted.

How frequently the Import Manager tries to import the images depends on the setting of the extended retry timer and session timer. The first four attempts occur at the regular session interval and the remaining attempts occur at the extended retry interval.

Syntax: REPLICA_METADATA_CLEANUP_TIMER = 0 | n

Default: 0 (off).

TAPE_RESOURCE_MULTIPLIER

Affects:

Duplication Manager and Duplication operations only

Indicates a value which serves as the multiplier for the number of concurrently active duplication jobs that can access a single storage unit. This parameter applies to tape media.

Storage unit configuration includes limiting the number of jobs that can access the resource at one time. (The Maximum concurrent write drives value.) This value specifies the optimal number of jobs that the Resource Broker can consider running on that resource.

See Maximum concurrent write drives storage unit setting on Windows.

This parameter helps administrators ensure a balance in the following situation:

  • To overload the Resource Broker with jobs it can't run is not prudent.

  • Make sure that there's enough queued work so that the devices won't become idle. The TAPE_RESOURCE_MULTIPLIER entry lets administrators tune the amount of work that the Resource Broker can evaluate for a particular storage unit.

For example, a particular storage unit contains three write drives. If the TAPE_RESOURCE_MULTIPLIER parameter is set to two, then the limit on concurrently active jobs is six. Other duplication jobs requiring the storage unit remain queued.

Syntax: TAPE_RESOURCE_MULTIPLIER = n

Default: 2 (multiplier of two).

THRESHOLD_JOB_COUNT

Affects:

Duplication Manager and all operations except for Import operations

Controls when Duplication Manager submits jobs. Use this parameter to indicate a minimum number of jobs which acts as a threshold. Once the threshold is reached, Duplication Manager submits more jobs rather than wait until all images are processed.

The THRESHOLD_JOB_COUNT lets the Duplication Manager submit jobs more quickly. However, the jobs that are submitted may not be as efficient as they would be if all images had been processed.

Syntax: THRESHOLD_JOB_COUNT = nn

Default: 0 (no threshold exists and all jobs are processed before Duplication Manager submits more jobs.

VERSION_CLEANUP_DELAY_HOURS

Affects:

Duplication Manager and all operations except for Import operations

Concerns the deletion of SLP versions where a more recent version exists.

Controls how much time must pass since an inactive version was the active version. If the version has been inactive for at least as long as the VERSION_CLEANUP_DELAY_HOURS value, NetBackup considers it for deletion.

Syntax: VERSION_CLEANUP_DELAY_HOURS = nn_hours

Default: 336 (336 hours; 14 days).

See Deleting old storage lifecycle policy versions on Windows.

The following is an example of the contents and syntax for a LIFECYCLE_PARAMETERS file using the default values:

DUPLICATION_SESSION_INTERVAL_MINUTES = 5
    IMAGE_EXTENDED_RETRY_PERIOD_IN_HOURS = 2
    MIN_GB_SIZE_PER_DUPLICATION_JOB = 8
    MAX_GB_SIZE_PER_DUPLICATION_JOB = 25
    MAX_MINUTES_TIL_FORCE_SMALL_DUPLICATION_JOB = 30

See Lifecycle operation administration using the nbstlutil command on Windows


Legacy ID



v42387048_v71296339


Article URL http://www.symantec.com/docs/HOWTO68315


Terms of use for this information are found in Legal Notices