Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. Veritas NetBackup™ Deduplication Guide
  3. Configuring deduplication
  4. Configuring an MSDP catalog backup
  5. MSDP drcontrol options
Veritas NetBackup™ Deduplication Guide

MSDP drcontrol options

The drcontrol utility resides in the following directories, depending on host type:

  • UNIX: /usr/openv/pdde/pdcr/bin

  • Windows: install_path\Veritas\pdde

The drcontrol utility creates a log file.

See NetBackup MSDP log files.

Table: MSDP drcontrol options for catalog backup and recovery describes the options for creating and updating an MSDP catalog backup policy.

Table: MSDP drcontrol options for catalog backup and recovery

Option

Description

--auto_recover_DR

Recover the MSDP catalog from the most recent backup image. This option automatically recovers the catalog and performs all of the actions necessary to return MSDP to full functionality.

This option requires the --policy policy_name option.

To recover the catalog from a backup other than the most recent, contact your Veritas Support representative.

--client host_name

The client to back up (that is, the host name of the MSDP storage server).

Default: the value that bpgetconfig CLIENT_NAME returns.

--cleanup

Remove all of the old MSDP catalog directories during the catalog recovery process. Those directories are renamed during the recovery.

--delete_old_files_for_cloud_catalyst

Deletes the existing deduplication catalog files before restoring them from the last backup in the recover_last_image step. Used for a cloud media server after the file system has been recovered in the recover_last_cloud_catalyst_image step.

--disk_pool

In a NetBackup CloudCatalyst recovery scenario, you must specify the disk pool name that is configured for the cloud storage server. This option is required for auto_recover_DR when the disk pool name cannot be determined from the host name. For example, for a cloud storage server that is configured for CloudCatalyst.

--hardware machine_type

The hardware type or the computer type for the host.

Spaces are not allowed. If the string contains special characters, enclose it in double quotation marks (").

Default: Unknown.

--initialize_DR

Performs the following actions to prepare for MSDP catalog recovery:

  • Verifies that the most recent catalog backup is valid.

  • Stops the deduplication services.

  • Moves the existing catalog files so that they are empty for the recovery.

--list_files

List the files in the most recent MSDP catalog backup.

This option requires the --policy policy_name option.

--log_file pathname

The pathname for the log file that the drcontrol utility creates. By default, the utility writes log files to /storage_path/log/drcontrol/.

--NB_install_dir install_directory

Windows only. Required option if NetBackup was installed in a location other than the default (C:\Program Files\Veritas).

If the string contains spaces or special characters, enclose it in double quotation marks ("). Do not use a trailing backslash in the install_directory string.

--new_policy

Create a new policy to protect the deduplication catalog on this host. If a policy with the given name exists already, the command fails.

Note:

To ensure that NetBackup activates the policy, you must specify the --residence residence option.

--OS operating_system

The operating system for the host.

Spaces are not allowed. If the string contains special characters, enclose it in double quotation marks (").

Default: UNIX/Linux or MS-Windows.

--policy policy_name

The name for the backup policy.

Required with --auto_recover_DR and --update_policy; optional with --new_policy.

Default: Dedupe_Catalog_shorthostname

--print_space_required

Display an estimate of the percentage of file system space that is required to recover the MSDP catalog.

--recover_last_cloud_catalyst_image

Use bprestore to restore the cloud media server-related contents of the last deduplication catalog backup. This operation requires that disaster recovery be initialized.

--recover_last_image

Restore the MSDP catalog from the last set of backup images (that is, the last full plus all subsequent incrementals). The drcontrol utility calls the NetBackup bprestore command for the restore operation.

--refresh_shadow_catalog

Deletes all existing shadow catalog copies and creates a new catalog shadow copy.

--residence residence

The name of the storage unit on which to store the MSDP catalog backups.

Do not use the Media Server Deduplication Pool as the destination for the catalog backups. Recovery of the MSDP catalog from its Media Server Deduplication Pool is impossible.

Veritas recommends that you use a storage unit that is attached to a NetBackup host other than the MSDP storage server.

--update_policy

Update a policy, as follows:

  • If the client name (of this media server) is not in the policy's client list, add the client name to the policy's client list.

  • If you specify the --OS or --hardware options, replace the values currently in the policy with the new values.

  • Update the backup selection based on the locations of the MSDP storage directories and configuration files. Therefore, if you modify any of the following, you must use this option to update the catalog backup policy:

    • Any of the following values in the spa.cfg file (section:variable pairs):

      • StorageDatabase:CatalogShadowPath

      • StorageDatabase:Path

      • Paths:Var

    • The spa.cfg or contentrouter.cfg locations in the pdregistry.cfg file.

This option fails if there is no policy with the given policy name. It also fails if the existing policy type is incompatible with the operating system of the host on which you run the command.

This option requires the --policy policy_name option.

--verbose

Echo all drcontrol log statements to stdout.

More Information

Configuring an MSDP catalog backup

Feedback

Was this page helpful?
Previous

Configuring an MSDP catalog backup

Next

Updating an MSDP catalog backup policy

Feedback

Was this page helpful?