Search <book_title>...

NetBackup™ Deduplication Guide

Last Published: 2022-09-07

Product(s): NetBackup (10.1)

Introducing the NetBackup media server deduplication option
1. About the NetBackup deduplication options
Quick start
1. About client-side deduplication
2. About the media server deduplication (MSDP) node cloud tier
  1. Configuring the MSDP node cloud tier
3. About Auto Image Replication (A.I.R.)
Planning your deployment
1. Planning your MSDP deployment
2. NetBackup naming conventions
3. About MSDP deduplication nodes
4. About the NetBackup deduplication destinations
5. About MSDP storage capacity
6. About MSDP storage and connectivity requirements
  1. Fibre Channel and iSCSI comparison for MSDP
7. About NetBackup media server deduplication
8. About NetBackup Client Direct deduplication
  1. About MSDP client deduplication requirements and limitations
9. About MSDP remote office client deduplication
  1. About MSDP remote client data security
  2. About remote client backup scheduling
10. About the NetBackup Deduplication Engine credentials
11. About the network interface for MSDP
12. About MSDP port usage
13. About MSDP optimized synthetic backups
14. About MSDP and SAN Client
15. About MSDP optimized duplication and replication
16. About MSDP performance
  1. How file size may affect the MSDP deduplication rate
17. About MSDP stream handlers
  1. Oracle stream handler
  2. Microsoft SQL Server stream handler
18. MSDP deployment best practices
Provisioning the storage
1. About provisioning the storage for MSDP
2. Do not modify MSDP storage directories and files
3. About volume management for NetBackup MSDP
Licensing deduplication
1. About the MSDP license
2. Licensing NetBackup MSDP
Configuring deduplication
1. Configuring MSDP server-side deduplication
2. Configuring MSDP client-side deduplication
3. About the MSDP Deduplication Multi-Threaded Agent
4. Configuring the Deduplication Multi-Threaded Agent behavior
  1. MSDP mtstrm.conf file parameters
5. Configuring deduplication plug-in interaction with the Multi-Threaded Agent
6. About MSDP fingerprinting
7. About the MSDP fingerprint cache
8. Configuring the MSDP fingerprint cache behavior
  1. MSDP fingerprint cache behavior options
9. About seeding the MSDP fingerprint cache for remote client deduplication
10. Configuring MSDP fingerprint cache seeding on the client
11. Configuring MSDP fingerprint cache seeding on the storage server
  1. NetBackup seedutil options
12. About sampling and predictive cache
13. Enabling 400 TB support for MSDP
14. About MSDP Encryption using NetBackup KMS service
  1. Upgrading KMS for MSDP
  2. Enabled KMS encryption for Local LSU
15. About MSDP Encryption using external KMS server
16. Configuring a storage server for a Media Server Deduplication Pool
  1. MSDP storage path properties
  2. MSDP network interface properties
17. About disk pools for NetBackup deduplication
18. Configuring a disk pool for deduplication
  1. Media Server Deduplication Pool properties
19. Creating the data directories for 400 TB MSDP support
20. Adding volumes to a 400 TB Media Server Deduplication Pool
21. Configuring a Media Server Deduplication Pool storage unit
  1. Media Server Deduplication Pool storage unit properties
  2. MSDP storage unit recommendations
22. Configuring client attributes for MSDP client-side deduplication
23. Disabling MSDP client-side deduplication for a client
24. About MSDP compression
25. About MSDP encryption
26. MSDP compression and encryption settings matrix
27. Configuring encryption for MSDP backups
28. Configuring encryption for MSDP optimized duplication and replication
29. About the rolling data conversion mechanism for MSDP
30. Modes of rolling data conversion
31. MSDP encryption behavior and compatibilities
32. Configuring optimized synthetic backups for MSDP
33. About a separate network path for MSDP duplication and replication
34. Configuring a separate network path for MSDP duplication and replication
35. About MSDP optimized duplication within the same domain
  1. About the media servers for MSDP optimized duplication within the same domain
    1. About MSDP push duplication within the same domain
    2. About MSDP pull duplication within the same domain
36. Configuring MSDP optimized duplication within the same NetBackup domain
  1. Configuring NetBackup optimized duplication or replication behavior
    1. Setting NetBackup configuration options by using the command line
37. About MSDP replication to a different domain
38. Configuring MSDP replication to a different NetBackup domain
  1. About NetBackup Auto Image Replication
  2. About trusted primary servers for Auto Image Replication
  3. About the certificate to be used for adding a trusted master server
  4. Adding a trusted master server using a NetBackup CA-signed (host ID-based) certificate
  5. Adding a trusted primary server using external CA-signed certificate
  6. Removing a trusted primary server
  7. Enabling NetBackup clustered primary server inter-node authentication
  8. Configuring NetBackup CA and NetBackup host ID-based certificate for secure communication between the source and the target MSDP storage servers
  9. Configuring external CA for secure communication between the source MSDP storage server and the target MSDP storage server
  10. Configuring a target for MSDP replication to a remote domain
    1. Target options for MSDP replication
    2. Configuring a NetBackup Deduplication Engine user with limited permissions for Auto Image Replication
39. About configuring MSDP optimized duplication and replication bandwidth
40. About performance tuning of optimized duplication and replication for MSDP cloud
41. About storage lifecycle policies
42. About the storage lifecycle policies required for Auto Image Replication
43. Creating a storage lifecycle policy
  1. Storage Lifecycle Policy dialog box settings
44. About MSDP backup policy configuration
45. Creating a backup policy
46. Resilient Network properties
  1. Resilient connection resource usage
47. Specifying resilient connections
48. Adding an MSDP load balancing server
49. About variable-length deduplication on NetBackup clients
50. About the MSDP pd.conf configuration file
51. Editing the MSDP pd.conf file
  1. MSDP pd.conf file parameters
52. About the MSDP contentrouter.cfg file
53. About saving the MSDP storage server configuration
54. Saving the MSDP storage server configuration
55. Editing an MSDP storage server configuration file
56. Setting the MSDP storage server configuration
57. About the MSDP host configuration file
58. Deleting an MSDP host configuration file
59. Resetting the MSDP registry
60. About protecting the MSDP catalog
  1. About the MSDP shadow catalog
  2. About storing MSDP catalog shadow copy duplicates on data volumes
  3. About the MSDP catalog backup policy
61. Changing the MSDP shadow catalog path
62. Changing the MSDP shadow catalog schedule
63. Changing the number of MSDP catalog shadow copies
64. Configuring an MSDP catalog backup
  1. MSDP drcontrol options
65. Updating an MSDP catalog backup policy
66. About MSDP FIPS compliance
67. Configuring the NetBackup client-side deduplication to support multiple interfaces of MSDP
68. About MSDP multi-domain support
69. About MSDP application user support
70. About MSDP mutli-domain VLAN Support
71. About NetBackup WORM storage support for immutable and indelible data
  1. About the NetBackup command line options to configure immutable and indelible data
MSDP cloud support
1. About MSDP cloud support
  1. Operating system requirement for configuration
  2. Limitations
2. Create a Media Server Deduplication Pool (MSDP) storage server in the NetBackup web UI
3. Creating a cloud storage unit
4. Updating cloud credentials for a cloud LSU
5. Updating encryption configurations for a cloud LSU
6. Deleting a cloud LSU
7. Backup data to cloud by using cloud LSU
8. Duplicate data cloud by using cloud LSU
9. Configuring AIR to use cloud LSU
10. About backward compatibility support
11. About the configuration items in cloud.json, contentrouter.cfg, and spa.cfg
12. Cloud space reclamation
  1. Configuring the container aging
  2. Configuring the cloud compaction
13. About the tool updates for cloud support
14. About the disaster recovery for cloud LSU
  1. Common disaster recovery steps
  2. Disaster recovery for cloud LSU in Flex Scale
15. About Image Sharing using MSDP cloud
  1. Things to consider before you use image sharing to convert VM image to VHD in Azure
  2. Converting the VM image to VHD in Azure
16. About restore from a backup in Microsoft Azure Archive
17. About MSDP cloud immutable (WORM) storage support
18. About instant access for object storage in cloud
S3 Interface for MSDP
1. About S3 interface for MSDP
2. Prerequisites
3. Configuring S3 interface for MSDP
  1. Changing the certificate in S3 server
4. Identity and Access Management (IAM) for S3 interface for MSDP
5. S3 APIs for S3 interface for MSDP
6. Disaster recovery in S3 interface for MSDP
7. Limitations in S3 interface for MSDP
8. Logging and troubleshooting
9. Best practices
Monitoring deduplication activity
1. Monitoring the MSDP deduplication and compression rates
2. Viewing MSDP job details
  1. MSDP job details
3. About MSDP storage capacity and usage reporting
4. About MSDP container files
5. Viewing storage usage within MSDP container files
6. Viewing MSDP disk reports
7. About monitoring MSDP processes
8. Reporting on Auto Image Replication jobs
Managing deduplication
1. Managing MSDP servers
2. Managing NetBackup Deduplication Engine credentials
3. Managing Media Server Deduplication Pools
4. Deleting backup images
5. About MSDP queue processing
6. Processing the MSDP transaction queue manually
7. About MSDP data integrity checking
8. Configuring MSDP data integrity checking behavior
  1. MSDP data integrity checking configuration parameters
9. About managing MSDP storage read performance
10. About MSDP storage rebasing
  1. MSDP server-side rebasing parameters
11. About the MSDP data removal process
12. Resizing the MSDP storage partition
13. How MSDP restores work
14. Configuring MSDP restores directly to a client
15. About restoring files at a remote site
16. About restoring from a backup at a target master domain
17. Specifying the restore server
Recovering MSDP
1. About recovering the MSDP catalog
2. Restoring the MSDP catalog from a shadow copy
3. Recovering from an MSDP storage server disk failure
4. Recovering from an MSDP storage server failure
5. Recovering the MSDP storage server after NetBackup catalog recovery
Replacing MSDP hosts
1. Replacing the MSDP storage server host computer
Uninstalling MSDP
1. About uninstalling MSDP
2. Deactivating MSDP
Deduplication architecture
1. MSDP server components
2. Media server deduplication backup process
3. MSDP client components
4. MSDP client - side deduplication backup process
Configuring and using universal shares
1. About universal shares
2. Configuring and using an MSDP build-your-own (BYO) server for universal shares
3. MSDP build-your-own (BYO) server prerequisites and hardware requirements to configure universal shares
4. Configuring universal share user authentication
5. Mounting a universal share created from the NetBackup web UI
6. Creating a protection point for a universal share
7. About universal share self-service recovery
8. Performing a universal share self-service recovery
9. Using the ingest mode
  1. Using the ingest mode to take a snapshot over NFS or SMB
  2. Using the ingest mode to run a policy using NFS or SMB
10. About universal shares with object store
11. Enabling a universal share with object store
  1. Enabling instant access with object storage
12. Disaster recovery for a universal share
13. Changing the number of vpfsd instances
14. Upgrading to NetBackup 10.1
Configuring isolated recovery environment (IRE)
1. Configuring an isolated recovery environment on a NetBackup BYO media server
2. Managing an isolated recovery environment on a NetBackup BYO media server
3. Configuring AIR for replicating backup images from production environment to IRE BYO environment
Using the NetBackup Deduplication Shell
1. About the NetBackup Deduplication Shell
2. Managing users from the deduplication shell
3. Managing VLAN interfaces from the deduplication shell
4. Managing the retention policy on a WORM storage server
5. Managing images with a retention lock on a WORM storage server
6. Auditing WORM retention changes
7. Managing certificates from the deduplication shell
8. Managing FIPS mode from the deduplication shell
9. Encrypting backups from the deduplication shell
10. Tuning the MSDP configuration from the deduplication shell
11. Setting the MSDP log level from the deduplication shell
12. Managing NetBackup services from the deduplication shell
13. Monitoring and troubleshooting NetBackup services from the deduplication shell
  1. About the support command
Troubleshooting
1. About unified logging
  1. About using the vxlogview command to view unified logs
  2. Examples of using vxlogview to view unified logs
2. About legacy logging
  1. Creating NetBackup log file directories for MSDP
3. NetBackup MSDP log files
4. Troubleshooting MSDP installation issues
  1. MSDP installation on SUSE Linux fails
5. Troubleshooting MSDP configuration issues
6. Troubleshooting MSDP operational issues
7. Viewing MSDP disk errors and events
8. MSDP event codes and messages
9. Unable to obtain the administrator password to use an AWS EC2 instance that has a Windows OS
10. Trouble shooting multi-domain issues
11. Troubleshooting the cloud compaction error messages
Appendix A. Migrating to MSDP storage
1. Migrating from another storage type to MSDP
Appendix B. Migrating from Cloud Catalyst to MSDP direct cloud tiering
1. About migration from Cloud Catalyst to MSDP direct cloud tiering
2. About Cloud Catalyst migration strategies
3. About direct migration from Cloud Catalyst to MSDP direct cloud tiering
4. About postmigration configuration and cleanup
5. About the Cloud Catalyst migration -dryrun option
6. About Cloud Catalyst migration cacontrol options
7. Reverting back to Cloud Catalyst from a successful migration
8. Reverting back to Cloud Catalyst from a failed migration
Appendix C. Encryption Crawler
1. About the Encryption Crawler
2. About the two modes of the Encryption Crawler
3. Managing the Encryption Crawler
4. Advanced options
5. Tuning options
6. Encrypting the data
7. Command usage example outputs
Index

About the support command

The support command lets you access and upload the relevant logs and configuration files for troubleshooting.

The following table describes the options and arguments for the support command.

Table: The options and arguments for the support command.

Option and its description	Argument	Description
MSDP-history Access the MSDP history files.	tail	Append the last 10 lines of each file to standard output. This command requires the following parameters: file Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
	collect	Collect files for transferring to the target host. This command requires the following parameters: mmin Find files that are modified n minutes ago. Same as mmin option in find command. For example, 15, +15, -15. pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. mtime* Finds files that are modified *n24 hours ago. Same as mtime** option in find command. For example, 2, +2, -2.
	ls	List information about the FILEs. Use the dir parameter to enter the directory name.
	scp	Securely transfer selected files to the target host. This command requires the following parameters: scp_port Specifies the port to connect to on the remote host. scp_target Specifies the target host and path for transferring files. Use the user@host:/directory path/ format. This is a required parameter.
	cat	Concatenate files and print on the standard output. Use the file parameter to enter the file name.
	grep	Print lines that match patterns. This command requires the following parameters: pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. This is a required parameter. file* Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
process Displays information about the MSDP processes.	MSDP-process	Display the MSDP processes.
	htop	Display the CPU and memory information.
	atop	Display information about the operating system.
	pidstat	Display the PID statistics.
	memory-usage	Displays the free and used memory.
software Displays information about the software.	show-MSDP-version	Display the MSDP version.
software Displays information about the software.	show-OS-version	Display the operating system information.
MSDP-log Access the MSDP log files.	tail	Append the last 10 lines of each file to standard output. This command requires the following parameters: file Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
	collect	Collect files for transferring to the target host. This command requires the following parameters: mmin Find files that are modified n minutes ago. Same as mmin option in find command. For example, 15, +15, -15. pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. mtime* Finds files that are modified *n24 hours ago. Same as mtime** option in find command. For example, 2, +2, -2.
	ls	List information about the files. Use the dir parameter to enter the directory name.
	scp	Securely transfer selected files to the target host. This command requires the following parameters: scp_port Specifies the port to connect to on the remote host. scp_target Specifies the target host and path for transferring files. Use the user@host:/directory path/ format. This is a required parameter.
	cat	Concatenate files and print on the standard output. Use the file parameter to enter the file name.
	grep	Print lines that match patterns. This command requires the following parameters: pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. This is a required parameter. file* Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
hardware Displays information about the hardware.	cpumem	Display the CPU and memory information.
MSDP-config Access the MSDP configuration files.	tail	Append the last 10 lines of each file to standard output. This command requires the following parameters: file Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
	collect	Collect files for transferring to the target host. This command requires the following parameters: mmin Find files that are modified n minutes ago. Same as mmin option in find command. For example, 15, +15, -15. pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. mtime* Finds files that are modified *n24 hours ago. Same as mtime** option in find command. For example, 2, +2, -2.
	ls	List information about the FILEs. Use the dir parameter to enter the directory name.
	scp	Securely transfer selected files to the target host. This command requires the following parameters: scp_port Specifies the port to connect to on the remote host. scp_target Specifies the target host and path for transferring files. Use the user@host:/directory path/ format. This is a required parameter.
	cat	Concatenate files and print on the standard output. Use the file parameter to enter the file name.
	grep	Print lines that match patterns. This command requires the following parameters: pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. This is a required parameter. file* Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
diskio Displays information about the disk I/O.	iostat	Displays the information about the disk I/O.
	vmstat	Displays the information on the wait on the disk I/O.
	nmon	Display the information about the monitor system.
	disk-volume	Display information about the disk volume.
syslogs Access the system logs.	tail	Append the last 10 lines of each file to standard output. This command requires the following parameters: file Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
	collect	Collect files for transferring to the target host. This command requires the following parameters: mmin Find files that are modified n minutes ago. Same as mmin option in find command. For example, 15, +15, -15. pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. mtime* Finds files that are modified *n24 hours ago. Same as mtime** option in find command. For example, 2, +2, -2.
	ls	List information about the FILEs. Use the dir parameter to enter the directory name.
	scp	Securely transfer selected files to the target host. This command requires the following parameters: scp_port Specifies the port to connect to on the remote host. scp_target Specifies the target host and path for transferring files. Use the user@host:/directory path/ format. This is a required parameter.
	cat	Concatenate files and print on the standard output. Use the file parameter to enter the file name.
	grep	Print lines that match patterns. This command requires the following parameters: pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. This is a required parameter. file* Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
proc Access process information about the pseudo-filesystem.	tail	Append the last 10 lines of each file to standard output. This command requires the following parameters: file Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.
	ls	List information about the FILEs. Use the dir parameter to enter the directory name.
	cat	Concatenate files and print on the standard output. Use the file parameter to enter the file name.
	grep	Print lines that match patterns. This command requires the following parameters: pattern Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad. This is a required parameter. file* Enter the filename. This is a required parameter. options Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

Here are some examples of the support command usage:

support MSDP-log ls dir=spoold
support MSDP-log ls dir=spad/sof1vm08.tec.com/spoold/spad/072320.log
support MSDP-log cat file=pdde-config.log
support MSDP-log cat file=spad/sof1vm08.tec.com/spoold/spad/072320.log
support MSDP-log tail file=pdde-config.log
support MSDP-log tail file=pdde-config.log options="-f"
support MSDP-log tail file=pdde-config.log options="-n 5"
support MSDP-log tail file=spad/sofia11vm08/spoold/spad/072320.log options="-f -n 5"
support MSDP-log grep file=spad* pattern=sessionStartAgent options="-r"
support MSDP-log grep file=pdde-setup.log pattern="pid  455"
support MSDP-log grep file=pdde-setup.log pattern="Pid" options="-w -i"
support MSDP-log grep file=spoold* pattern="Pid" options="-w -i -r"
support MSDP-log grep file=pdde-setup.log pattern="MSDP-X|PureDisk" options="-w -i -r -E"

To collect logs

Open an SSH session to the server as the msdpadm user, or for NetBackup Flex Scale, as an appliance administrator.
If you plan to collect and transfer a large log file, you may need to increase the amount of time before the SSH connection times out. The default is 10 minutes. Use the following steps to increase the time:
- Run the following command:
  setting ssh set-ssh-timeout ssh_timeout=<number of seconds>
- Run the following command to verify the change:
  setting ssh show-ssh-timeout
- Close the current SSH session and open a new one.

Run the collect command for the desired category to collect files of interest. For example:

support MSDP-log collect pattern=spoold* mmin="+2"
support MSDP-history collect
support MSDP-config collect
support syslogs collect pattern=crash mmin="-2"

Run the scp command from any category to create a tarball of all previously collected files (from all categories) and transfer the tarball to the target host using the scp protocol. For example:
support MSDP-config scp scp_target=user@example.com:/tmp
If applicable, run the following command to set the SSH time-out back to the default:
setting ssh set-ssh-timeout ssh_timeout=600
Verify the change with the setting ssh show-ssh-timeout command.