NetVault SmartDisk 11.4.5 - Administration Guide


	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.

Initiate a terminal session, or open a command prompt.

As the root user or using sudo on Linux, UNIX, or Mac OS X, or as an administrator on Windows, type:

…/foundation/bin/smartdisk 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] [--authlifetime

= <ValueInSeconds>]

config --add|--update --ndmp [--port <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. You can use ‑‑authlifetime to specify a lifetime value for nonce reuse, which allows credentials to be reused across multiple connections — NetVault SmartDisk implements a new nonce for every connection if the value is 0 or is blank.

If you are modifying port information for a non-NDMP device, complete any of the following:

•

To add a port, type:

…/foundation/bin/smartdisk 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 config --delete ‑‑webdav 37453

If you are modifying port information for an NDMP Device, complete any of the following:

•

To add new ports, type:

…/foundation/bin/smartdisk config --add ‑‑ndmp ‑‑port <port#>


	NOTE: Before using the --add option, delete the existing NDMP ports.

Replace <port#> with the port that you want to use. The --port <port#> segment can contain any of the following:

•

A single port number:

…/foundation/bin/smartdisk config --add --ndmp ‑‑port 37454

•

A list of port numbers:

…/foundation/bin/smartdisk config --add --ndmp ‑‑port "37454, 37455"

•

A range of port numbers:

…/foundation/bin/smartdisk config --add --ndmp ‑‑port "37460-37469"

•

A combination of the preceding options:

…/foundation/bin/smartdisk config --add --ndmp ‑‑port "37454,

37455, 37460-37469"


	NOTE: To specify more than one port, enclose the port numbers in quotation marks.

•

To remove the original port for an NDMP Device, type:

…/foundation/bin/smartdisk config --delete ‑‑ndmp

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

…/foundation/bin/smartdisk config --show

NetVault SmartDisk displays results similar to the following example for a non-NDMP device:

[Interface:Data]

Block Size = <blockSize>

Credentials = <Name:MaskedPassword>

Port = <NewPort#, NewPort#>

Authorization Lifetime = <ValueInSeconds>]

Type = WebDAV

NetVault SmartDisk displays results similar to the following example for an NDMP Device:

[Interface:Data]

Port = <NewPort#>

Preferred Contract Address =

Block Size = <blockSize>

Type = NDMP

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. If you intend to use the NetVault Backup Use optimised replication between devices that support this feature option, available for NetVault Backup Data Copy and Duplicate operations, WebDAV authentication fails if the configured credentials are different on the source and destination NetVault SmartDisk Servers. Successful replication requires that either authentication is disabled on both instances, is enabled only on the source, or uses identical credentials on the source and destination NetVault SmartDisk Instances.

Initiate a terminal session, or open a command prompt.

As the root user or using sudo on Linux, UNIX, or Mac OS X, or as an administrator on Windows, type:

…/foundation/bin/smartdisk 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]

[--authlifetime = <ValueInSeconds>]

To define the credentials, type:

…/foundation/bin/smartdisk config --update

--webdav <port#> --credentials

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

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

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

NetVault SmartDisk displays results similar to the following example:

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

Username: NetVault SmartDiskuser

Password:

Confirm Password:

Configuration applied

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

If you are using NetVault Backup, authentication is not required to add NetVault SmartDisk, but it is required for performing backups and restores that use NetVault SmartDisk as the target. For more information about configuring credentials in NetVault Backup, see the Quest NetVault Backup Administrator’s Guide.

Disabling WebDAV authentication

Verify that no backup or restore jobs are currently active.

Initiate a terminal session, or open a command prompt.

As the root user or using sudo on Linux, UNIX, or Mac OS X, or as an administrator on Windows, type:

…/foundation/bin/smartdisk config --delete ‑‑webdav <port> ‑‑credentials

When the prompt is displayed that asks for the current WebDAV credentials, enter the applicable name and password.

To verify that the port has been defined correctly, type:

…/foundation/bin/smartdisk config --show

NetVault SmartDisk displays results similar to the following example:

[Interface:Data]

Block Size = 32768, B

Port = 37453

Authorization Lifetime = 0

Type = WebDAV

Changing a user name or password (Windows only)

To change the name or case-sensitive password, or both, of the nonprivileged user on Windows platforms, complete the following steps:


	IMPORTANT: Changing the nonprivileged user affects the number of people who have read- and write-access to the Windows Application log. For more information, see the Authentication requirements topic in the Quest NetVault SmartDisk Installation/Upgrade Guide. The password is case-sensitive.