vRanger 7.7.1 - Integration Guide for NetVault SmartDisk

Modifying the data port

Configuring NetVault SmartDisk ports for communication with your software

By default, NetVault SmartDisk uses port 37453 to communicate with vRanger instances that are streaming data to the NetVault SmartDisk Device. It also uses port 37451 for Inter Process Communication (IPC) on the loopback interface, but not for remote connections.

 

NOTE: If you intend to use different ports, Quest recommends that you make the applicable change to the port setting on the NetVault SmartDisk Instance before you add the NetVault SmartDisk repository to vRanger. You can update the port that communicates with your software at any time.

Modifying the data port

Modifying the data port

If you want to use a different port to communicate with the vRanger instances, complete the following steps.

 

NOTE: Throughout this documentation, the path to where you installed NetVault SmartDisk is represented by an ellipsis (…). Replace the ellipsis with the applicable information.

 

IMPORTANT: You cannot add a port that exists. If you try to add an existing port, you see a “Failed to apply configuration” message. Before attempting to add a port, use the config --show command option to view existing information.

1	Open a command prompt, and type:

…\foundation\bin\smartdisk.bat config

NetVault SmartDisk displays the list of options and parameters that you can use, including the sections for configuring the ports:

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

You can use ‑‑block-size to define the block size used to read and write blocks when streaming data to the Staging Store. You can use ‑‑preferred-address to define the primary IP address that clients should use when communicating with the NetVault SmartDisk Device. You can use ‑‑credentials to enable authentication and define the authorized user and password.

2	If you are modifying port information, complete any of the following:

▪	To add a port, type:

…\foundation\bin\smartdisk.bat config ‑‑add ‑‑webdav <port#>

Replace <port#> with the port that you want to use.

▪	To remove the original port, the following uses the default, type:

…\foundation\bin\smartdisk.bat config ‑‑delete ‑‑webdav 37453

3	To verify that the new port has been added and the original has been removed, type:

…\foundation\bin\smartdisk.bat config --show

NetVault SmartDisk displays results similar to the following example:

[Interface:Data]

Block Size = <blockSize>

Credentials = <Name:MaskedPassword>

Port = <NewPort#, NewPort#>

Type = WebDAV

Enabling or updating authentication for WebDAV access

Enabling or updating authentication for WebDAV access

If you want to enable authentication for WebDAV access of NetVault SmartDisk for the data port, complete the following steps to specify the credentials. NetVault SmartDisk uses digest-access authentication, specifically RFC 2069. You can also use this same procedure to update existing credentials.

 

NOTE: For the user name in the WebDAV credentials, NetVault SmartDisk currently supports the use of any ASCII characters except the quotation mark ("), comma (,), and colon (:). The are no restrictions for the corresponding password.

1	Open a command prompt, and type:

…\foundation\bin\smartdisk.bat config

NetVault SmartDisk displays the list of options and parameters that you can use, including the section for configuring authentication:

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

2	To define the credentials, type:

…\foundation\bin\smartdisk.bat config ‑‑update ‑‑webdav <port#> ‑‑credentials

Replace <port#> with the port that you are using.

3	When the Username prompt appears, enter the user name that should be used for access, and press Enter.

4	When the Password prompt appears, enter the password associated with the specified user name, press Enter, enter the password again when the Confirm Password prompt appears, and press Enter again.

NetVault SmartDisk displays results similar to the following example:

./smartdisk.bat config ‑‑update ‑‑webdav 37453 ‑‑credentials

Username: NetVaultSmartDiskuser

Password:

Confirm Password:

Configuration applied

5	In your backup software, configure the same credentials for backups and restores to the NetVault SmartDisk Instance.

Verifying that the client ports are open

Verifying that the client ports are open

Quest recommends that you verify that the ports are open between the vRanger machine and the NetVault SmartDisk server.

To verify that the ports are open, you can use a web browser or another method of your choice. If the port is open, the command returns the status information for the NetVault SmartDisk server. If the port is not open, you receive a connection error from your browser.

In the following examples, replace <port#> with the applicable port number, and replace <hostName> with the IP address of the machine on which NetVault SmartDisk is installed.

To use a web browser:

1	On the system on which NetVault SmartDisk is installed, type:

http://<localhost>:<port#>/proc/dedupe/stats.stnz

2	On the system on which the backup server or client software is installed, type:

http://<hostName>:<port#>/proc/dedupe/stats.stnz