You can use the NetVault SmartDisk CLI config command to perform tasks such as:
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:
Displays a list of the config command options and their syntax. | |||||||||
Displays the current values for the NetVault SmartDisk configuration. | |||||||||
‑‑dedupe-enable <TRUE|FALSE> |
|||||||||
‑‑dedupe-compression <TRUE|FALSE> |
|||||||||
‑‑gc-enable <TRUE|FALSE> |
|||||||||
‑‑add|‑‑delete ‑‑dedupe-window <[Sun|Mon|Tue|Wed|Thu|Fri|Sat-]HH:MM-HH:MM>|<Never|Anytime> |
| ||||||||
‑‑add|‑‑delete ‑‑gc‑window <[Sun|Mon|Tue|Wed|Thu|Fri|Sat-]HH:MM-HH:MM>|<Never|Anytime> |
| ||||||||
‑‑dedupe-active-limit <Unlimited|limit> |
Specifies the maximum number of segments that can be deduplicated simultaneously. | ||||||||
‑‑network-capacity <MBps> |
|||||||||
‑‑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| |
Indicates when to calculate MD5 checksum for data streams written to NetVault SmartDisk. |
• |
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. |
• |
The default Chunk-page size for Garbage Collection is 256 MB. Before v1.6, the default was 64 MB. The larger Chunk page size supports faster Garbage Collection counting, due to less Chunk-page metadata input and output. The default settings of the Garbage Collection window and Chunk-page size are not changed during upgrades. Generally, Quest recommends that you leave the Chunk-page size at its current setting. |
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:
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.
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> |
|
[‑‑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>] |
|
[‑‑pool <label>] |
|
[‑‑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. 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>] |
|
[‑‑password <UNC-path-password>] |
© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center