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
  3. NetBackup™ Deduplication Guide
  5. Using the NetBackup Deduplication Shell
  7. Tuning the MSDP configuration from the deduplication shell
NetBackup™ Deduplication Guide

Tuning the MSDP configuration from the deduplication shell

The default MSDP configuration should work for most installations. However, if you need to make adjustments, use the following commands to set or view the parameters.

Parameter

Description

Commands

AllocationUnitSize

The allocation unit size for the data on the server

To set the parameter: setting set-MSDP-param allocation-unit-size value=<number of MiB>

To view the parameter: setting get-MSDP-param allocation-unit-size

DataCheckDays

The number of days to check the data for consistency

To set the parameter: setting set-MSDP-param data-check-days value=<number of days>

To view the parameter: setting get-MSDP-param data-check-days

LogRetention

The length of time to keep logs

To set the parameter: setting set-MSDP-param log-retention value=<number of days>

To view the parameter: setting get-MSDP-param log-retention

MaxCacheSize

The maximum size of the NetBackup Deduplication Engine (spoold) fingerprint cache

To set the parameter: setting set-MSDP-param max-cache-size value=<number of GB>

To view the parameter: setting get-MSDP-param max-cache-size

MaxRetryCount

The maximum number of times to retry a failed transmission

To set the parameter: setting set-MSDP-param max-retry-count value=<number of retry times>

To view the parameter: setting get-MSDP-param max-retry-count

SpadLogging

The log level for the NetBackup Deduplication Manager (spad)

To set the parameter: setting set-MSDP-param spad-logging log_level=<value>

See Setting the MSDP log level from the deduplication shell.

To view the parameter: setting get-MSDP-param spad-logging

SpooldLogging

The log level for the NetBackup Deduplication Engine (spoold)

To set the parameter: setting set-MSDP-param spoold-logging log_level=<value>

See Setting the MSDP log level from the deduplication shell.

To view the parameter: setting get-MSDP-param spoold-logging

WriteThreadNum

The number of threads for writing data to the data container in parallel

To set the parameter: setting set-MSDP-param write-thread-num value=<number of threads>

To view the parameter: setting get-MSDP-param write-thread-num

CloudDataCacheSize

The default data cache size when the cloud LSU is added. Decrease this value if sufficient free space is not available.

To set the parameter:

setting set-MSDP-param cloud-data-cache-size value=<number>

To view the parameter:

setting get-MSDP-param cloud-data-cache-size

CloudMapCacheSize

The default map cache size when the cloud LSU is added. Decrease this value if sufficient free space is not available.

To set the parameter:

setting set-MSDP-param cloud-map-cache-size value=<number>

To view the parameter:

setting get-MSDP-param cloud-map-cache-size

CloudMetaCacheSize

The default meta cache size when the cloud LSU is added. Decrease this value if sufficient free space is not available.

To set the parameter:

setting set-MSDP-param cloud-meta-cache-size value=<number>

To view the parameter:

setting get-MSDP-param cloud-meta-cache-size

CloudUploadCacheSize

The default upload cache size when the cloud LSU is added. The minimum value is 12 GiB.

To set the parameter:

setting set-MSDP-param cloud-upload-cache-size value=<number>

To view the parameter:

setting get-MSDP-param cloud-upload-cache-size

EnableLocalPredictiveSamplingCache

The parameter to enable or disable the local predictive sampling cache. Both spoold and spad have this parameter, and it should be synced between them.

To set the parameter:

setting set-MSDP-param enable-local-predictive-sampling-cache value=<true/false>

To view the parameter:

setting get-MSDP-param enable-local-predictive-sampling-cache

MaxPredictiveCacheSize

The maximum size of the spoold predictive cache.

To set the parameter:

setting set-MSDP-param max-predictive-cache-size value=<number of bytes/%>

To view the parameter:

setting get-MSDP-param max-predictive-cache-size

MaxSamplingCacheSize

The maximum size of the spoold sampling cache.

To set the parameter:

setting set-MSDP-param max-sampling-cache-size value=<number of bytes/%>

To view the parameter:

setting get-MSDP-param max-sampling-cache-size

UsableMemoryLimit

The maximum usable memory size in spoold.

To set the parameter:

setting set-MSDP-param usable-memory-limit value=<number of bytes/%>

To view the parameter:

setting get-MSDP-param usable-memory-limit

MaxCacheSize(Cluster)

The maximum size of the spoold fingerprint cache for all nodes in a cluster.

To set the parameter:

setting set-MSDP-param max-cache-size-cluster value=<number>

To view the parameter:

setting get-MSDP-param max-cache-size-cluster

MaxPredictiveCacheSize(Cluster)

The maximum size of the spoold predictive cache for all nodes in a cluster.

To set the parameter:

setting set-MSDP-param max-predictive-cache-size-cluster value=<number of bytes>

To view the parameter:

setting get-MSDP-param max-predictive-cache-size-cluster

MaxSamplingCacheSize(Cluster)

The maximum size of the spoold sampling cache for all nodes in a cluster.

To set the parameter:

setting set-MSDP-param max-sampling-cache-size-cluster value=<number of bytes>

To view the parameter:

setting get-MSDP-param max-sampling-cache-size-cluster

UsableMemoryLimit(Cluster)

The maximum usable memory size in spoold for all nodes in a cluster.

To set the parameter:

setting set-MSDP-param usable-memory-limit-cluster value=<number>

To view the parameter:

setting get-MSDP-param usable-memory-limit-cluster

EnableLocalPredictiveSamplingCache(Cluster)

The parameter to enable or disable the local predictive sampling cache for all nodes in cluster. Both spoold and spad have this parameter, and it should be synced between them.

To set the parameter:

setting set-MSDP-param enable-local-predictive-sampling-cache-cluster value=<true/false>

To view the parameter:

setting get-MSDP-param enable-local-predictive-sampling-cache-cluster

VpfsCloudFPIndexRemovalThreshold (cluster)

The threshold to remove the cloud fingerprint index file for all nodes in the cluster. When the number of deleted data containers in a fingerprint index file is greater than the threshold, the fingerprint index file is removed.

To set the parameter:

setting set-MSDP-param vpfs-cloud-fpindex-removal-threshold value=<%>

To view the parameter:

setting get-MSDP-param vpfs-cloud-fpindex-removal-threshold

VpfsPCacheReloadThreshold (cluster)

The threshold for spoold to reload fingerprint from fingerprint index file based on the fingerprint in pcache that is replaced. This applies to all nodes in the cluster.

To set the parameter:

setting set-MSDP-param vpfs-pcache-reload-threshold-cluster value=<%>

To view the parameter:

setting get-MSDP-param vpfs-pcache-reload-threshold-cluster

Feedback

Was this page helpful?
Previous

Encrypting backups from the deduplication shell

Next

Setting the MSDP log level from the deduplication shell

Feedback

Was this page helpful?