Chat now with support
Chat with Support

NetVault SmartDisk 11.4.5 - Administration Guide

Introducing NetVault SmartDisk Integrating NetVault SmartDisk with your backup product Using the command-line interface (CLI) Configuring NetVault SmartDisk Monitoring performance Troubleshooting

NetVault SmartDisk Configuration: an overview

You can use the NetVault SmartDisk CLI config command to perform tasks such as:

Using the config command options

Before using the NetVault SmartDisk CLI config command, note the following:

With the --volume and --pool options, the <path> and <label> strings are case-sensitive because they identify a specific NetVault SmartDisk Storage Pool or Volume.
If a configuration-related command fails and displays a message similar to “Failed to apply configuration,” Quest recommends that you use the config command with the --show option to display the current configuration. After displaying the configuration, double-check the case of the specified NetVault SmartDisk Storage Pool or Volume to ensure that the strings reflect the case-sensitivity.
The NetVault SmartDisk Services must be running before you can use the config command and most of the options. To view the options that are available, you can use the --help option while NetVault SmartDisk Services are offline.

The NetVault SmartDisk CLI config command supports the following options:

‑‑help

Displays a list of the config command options and their syntax.

‑‑show

Displays the current values for the NetVault SmartDisk configuration.

‑‑dedupe-enable <TRUE|FALSE>

Enables or disables NetVault SmartDisk Deduplication. Deduplication is disabled for all backup jobs even if deduplication is enabled for the backup job and the NetVault SmartDisk Instance is licensed for the NetVault SmartDisk Deduplication Option.

‑‑dedupe-compression <TRUE|FALSE>

Enables or disables compression of NetVault SmartDisk-unique Chunks. Disabled by default, compressing unique Chunks can reduce their storage footprint up to 50 percent. Compression is performed on the unique Chunks that result from the deduplication process. Compressing the initial Full Backup for a data set might take longer than not compressing the unique data because most of the data is considered unique. Subsequent Full Backups have fewer unique Chunks and do not experience an increase in the time it takes to complete the deduplication and compression process.

‑‑gc-enable <TRUE|FALSE>

Enables or disables NetVault SmartDisk Garbage Collection. Garbage Collection is enabled unless you disable it by using this option. Disabling Garbage Collection overrides the existing Garbage Collection Window configuration. When it is disabled, it does not run even if it is required and the Deduplication Engine is available. This setting remains in effect — persists — following a NetVault SmartDisk restart.

‑‑add|‑‑delete ‑‑dedupe-window <[Sun|Mon|Tue|Wed|Thu|Fri|Sat-]HH:MM-HH:MM>|<Never|Anytime>

Sets the deduplication window by specifying the times that deduplication can be performed. By default, the deduplication window is set to Anytime.

Available parameters include:

Days of Week: Specifies the days of the week on which the deduplication process runs. You can schedule it to run on multiple days, such as Monday, Wednesday, and Friday.
HH:MM-HH:MM: Using a 24-hour clock, specifies the times of day at which the deduplication process runs.
Never: Disables the deduplication window. Backups enabled for deduplication remain in the Staging Store in a nondeduplicated state until the deduplication window is enabled.
Anytime: Enables the deduplication process to be run at any time. Deduplication for a backup data stream begins after the initial 400 GB has been written to the Staging Store, which can provide nearly inline deduplication performance.

‑‑add|‑‑delete ‑‑gc‑window <[Sun|Mon|Tue|Wed|Thu|Fri|Sat-]HH:MM-HH:MM>|<Never|Anytime>

Sets the Garbage Collection window by specifying the times that NetVault SmartDisk Garbage Collection has priority over deduplication. By default, the Garbage Collection window is set to 18:00 through 06:00 for every night.

Available parameters include:

Days of Week: Specifies the days of the week on which the Garbage Collection process runs. You can schedule it to run on multiple days, such as Monday, Wednesday, and Friday.
HH:MM-HH:MM: Using a 24-hour clock, specifies the times of day at which the Garbage Collection process runs.
Never: Disables the Garbage Collection window.
Anytime: Enables the Garbage Collection process to be run at any time.

‑‑dedupe-active-limit <Unlimited|limit>

Specifies the maximum number of segments that can be deduplicated simultaneously.

‑‑network-capacity <MBps>

Specifies the capacity, in megabytes per second (MBps), of the network between the NetVault SmartDisk Device and the backup clients. The NetVault SmartDisk Random Access Store (RAS) Controller uses this figure when it calculates the NetVault SmartDisk Device availability score. The availability score is calculated by comparing the current throughput and comparing it to maximum capacity. The RAS Controller reports the availability score to your backup software.

‑‑stream-limit <limit>

Specifies the number of data streams that can be processed simultaneously.

‑‑add|‑‑update ‑‑volume <path> [Parameters]

Extends NetVault SmartDisk Storage Pools by adding or updating existing volumes in the NetVault SmartDisk Storage Pools. For more information, see Extending NetVault SmartDisk Storage Pools.

‑‑add|‑‑update ‑‑webdav <port> [‑‑block-size <bytes>] [‑‑credentials] [‑‑preferred-address <address>]

‑‑add|‑‑update ‑‑ndmp [‑‑port <port>] [‑‑block-size <bytes>] [‑‑credentials] [‑‑preferred-address <addresses>]

Modifies the port that the NetVault SmartDisk Device uses to communicate with the backup clients or NDMP Devices. For more information, see Modifying the data port.

‑‑delete ‑‑webdav <port> [‑‑credentials]

‑‑delete ‑‑ndmp ‑‑port <port>

Used with ‑‑add, modifies the port that the NetVault SmartDisk Device uses to communicate with the backup clients or NDMP Devices. For more information, see Modifying the data port.

‑‑update ‑‑remote-port <port>

Modifies the port that the NetVault SmartDisk Device uses to communicate with the backup software. For more information, see Modifying the messaging port.

--write-md5 <Always|Never|
BasedOnHttpHeader>

Indicates when to calculate MD5 checksum for data streams written to NetVault SmartDisk.

Configuring Garbage Collection

NetVault SmartDisk must balance its time between deduplicating new backup streams and performing Garbage Collecting of unreferenced Chunks from retired backups. If you are using deduplication and Garbage Collection, Quest recommends that you use following guidelines to establish your settings:

Verify that the overall limit, which is independent from volumes, is adhered to. Use the ‑‑dedupe-active-limit option to specify the maximum number of segments that can be simultaneously deduplicated to match the number of processor cores, up to a practical maximum of 16. For more information, see the description for ‑‑dedupe-active-limit under Using the config command options.

Quest recommends that you use the default setting of Anytime for the deduplication window, and that you adjust the Garbage Collection windows to match your backup windows. Starting with v1.6, the default Garbage Collection window for new installations is from 18:00 through 06:00 every night. As indicated previously, you might consider setting Garbage Collection to start 30 minutes before backups start.

To review the current settings, use the following command:

For example, if your backup window is 00:00-04:00, consider setting your Garbage Collection window to 23:30-04:00. First delete the current setting, and then add the new setting:

On average, Garbage Collection needs one-third of each day, or week, which leaves the remaining two-thirds for deduplication. The Garbage Collection window indicates when Garbage Collection has priority over deduplication — it does not mean that Garbage Collection runs only during this time. Garbage Collection might also run outside the Garbage Collection window.

Deduplication processes are only started within the deduplication window, which is why Quest recommends that you leave this setting at Anytime. Individual deduplication processes run until they are finished, while Garbage Collection can be interrupted automatically to start deduplications. By using the per-volume --dedupe-cap, NetVault SmartDisk automatically schedules deduplications to start when it is not busy receiving backups. Garbage Collection is started only when it is required, and when it has priority. After retirements, Manifests have been marked for deletion, Garbage Collection is required. Starting with v1.6, NetVault SmartDisk also recognizes that Garbage Collection counting work is required after any deduplications have completed — new Manifests have been added.

After all deduplications have completed, NetVault SmartDisk waits for five minutes — the default Inactivity Timeout of 300 seconds — before starting Garbage Collection. This delay prevents Garbage Collection from starting and getting interrupted almost immediately, which would clutter the logs. However, it also means that NetVault SmartDisk is not performing work during that time, unless it is receiving backups. Therefore, it is important to the overall deduplication throughput that the Garbage Collection window is not longer than it must be.

Extending NetVault SmartDisk Storage Pools

You can extend NetVault SmartDisk physical capacity by adding or updating the volumes specified for the NetVault SmartDisk Storage Pools. To extend the NetVault SmartDisk physical capacity, use the config ‑‑add|‑‑update ‑‑volume <path> command. You can also use the following additional parameters:

‑‑volume <path>

Specifies the path for the file-system path of the volume to be used as a NetVault SmartDisk Storage Pool. You can specify local drives or Universal Naming Convention (UNC) paths for Common Internet File System (CIFS), Network File System (NFS), and Storage Area Network (SAN). If the volume is on a mounted file system, verify that the specified path is a valid subdirectory on the mounted file system, and not the mounted directory itself. This path ensures that data is not written to the local directory if the mounted location is unavailable.

[‑‑volume-size <%>]

Specifies the percentage of the volume that NetVault SmartDisk can use; the remainder cannot be used by NetVault SmartDisk.

The value of ((100 - X) / 100) * (total volume size) is added to the Last Resort Threshold (LRT). In addition, a small amount of storage is reserved to complete Garbage Collection. These three components of reserved storage determine the total storage set aside that cannot be directly used by NetVault SmartDisk.

For example, if volume-size is set to 30 and the volume’s size is 100 GB, 70 GB is set aside — in addition to the LRT and Garbage Collection reserve space — and NetVault SmartDisk cannot use it.

[‑‑dedupe-cap <Unlimited|cap>]

Specifies the maximum number of backup segments for the specific volume that can be deduplicated simultaneously. Defaults to 4.

[‑‑pool <label>]

Specifies the Label assigned to the Storage Pool. Defaults to a system-generated numeric label. To add the volume to an existing Storage Pool, specify an existing Storage Pool label. To create a Storage Pool, specify a new name.

[‑‑reservation-size <bytes>]

Specifies the number of bytes reserved by the processes streaming data into NetVault SmartDisk. A smaller size results in NetVault SmartDisk having to reserve space more frequently; a larger size renders more disk space temporarily unavailable. If the Space.Available — reported through the show option — is less than the reservation-size, the volume is considered FULL.

[‑‑favour <Staging|Storage|"Chunk Index"|"Disk Index"|All|None>]…

Specifies which Storage Pool Roles the volume is available to perform. To specify multiple roles, list the ‑‑favour parameter multiple times. For example:

Use with ‑‑deny to dedicate a volume to one or more roles.

[‑‑deny <Staging|Storage|"Chunk Index"|"Disk Index"|All|None>]…

Specifies which Storage Pool Roles the volume is not available to perform. To specify multiple roles, list the ‑‑deny parameter multiple times.

For example:

Use with ‑‑favour to dedicate a volume to one or more roles.

[‑‑balancing <Space|Activity|None>]

Instructs NetVault SmartDisk to use the volume with either the most space available or the least activity occurring. If used with ‑‑favour and ‑‑deny, ‑‑balancing is applied last.

NOTE: The --balancing parameter provides guidance to NetVault SmartDisk; the NetVault SmartDisk Disk Manager and Deduplicator make the final decision about how to allocate space.

[‑‑account <UNC-path-account>]

Required for Windows platform when specifying UNC paths. Specifies the user account with read and write permissions to the UNC path.

[‑‑password <UNC-path-password>]

Required for Windows platform when specifying UNC paths. Specifies the password for the user account with read and write permissions to the UNC path. This password is case-sensitive.

Related Documents