vRanger 7.8 - Integration Guide for NetVault SmartDisk

Restarting NetVault SmartDisk Services

To stop and start the NetVault SmartDisk Services automatically, complete the following steps:

1	Open a command prompt.

2

Type:

…\foundation\bin\smartdisk.bat restart

NetVault SmartDisk stops and restarts the NetVault SmartDisk Services.

Services stopped ok.

.

Services started ok.

Viewing NetVault SmartDisk Log files

1	Open a command prompt.

2

Type:

…\foundation\bin\smartdisk.bat logs

NetVault SmartDisk displays the NetVault SmartDisk Logs and all relevant information. When you run logs without any options, it displays all NetVault SmartDisk log entries.

3	To display specific information, use one of the following options:

 

Logs option	Description
‑‑file <pathToFile>	Displays the contents of the specified file.
‑‑help	Displays a list of the available options and an explanation of how to use them.
‑‑last-hours <x>	Displays the records for the specified number of hours.
‑‑time-interval <yyyy-mm-dd-hhmmss yyyy-mm-dd-hhmmss>	Displays the records for the specified time frame.

You can also view logs by using the Windows® Event Viewer.

Configuring NetVault SmartDisk by using the command line

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

•	Enabling deduplication.

•	Enabling deduplication compression.

•	Configuring the deduplication window.

•	Configuring Garbage Collection.

•	Extending NetVault SmartDisk Storage Pools by adding additional volumes.

Using the config command options

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

•	All times are displayed in the local time for the machine where the NetVault SmartDisk Instance is installed.

•	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:

 

Table 2. Available options

Config option	Description
‑‑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.
‑‑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%. 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 amount of time it takes to complete the deduplication and compression process.
‑‑add|‑‑delete ‑‑dedupe-window <[Sun|Mon|Tue|Wed|Thu|Fri|Sat-]HH:MM-HH:MM>|<Never|Anytime>	Sets the NetVault SmartDisk Deduplication Window by specifying the times that deduplication can be performed. By default, the default 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 non-deduplicated 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 13:00 through 19:00 on Mondays through Thursdays. 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.
‑‑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>]	Modifies the port that the NetVault SmartDisk Device uses to communicate with vRanger. For more information, see Modifying the data port.
‑‑delete ‑‑webdav <port> [‑‑credentials]	Used with ‑‑add, modifies the port that the NetVault SmartDisk Device uses to communicate with vRanger. 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 data port.
--write-md5 <Always|Never| BasedOnHttpHeader>	Indicates when to calculate MD5 checksum for data streams written to NetVault SmartDisk.