Chat now with support
Chat with Support

NetVault 13.0 - Administration Guide

Introduction Getting started Configuring clients Managing catalog search Configuring storage devices
About storage devices SAN considerations Quest DR Series systems Quest QoreStor NetVault SmartDisk EMC Data Domain Systems Snapshot Array Manager Virtual Tape Libraries Virtual standalone drives Shared Virtual Tape Libraries Physical tape devices Storage tiers
Backing up data Managing policies Restoring data Managing NetVault dashboard Managing jobs Monitoring logs Managing storage devices
Monitoring device activity Managing disk-based storage devices in list view Managing disk-based storage devices in tree view Managing the Snapshot Array Manager Managing tape libraries in list view Managing tape libraries in tree view Managing tape drives in list view Managing tape drives in tree view Adding shared devices
Managing storage media Managing user and group accounts Monitoring events and configuring notifications Reporting in NetVault Working with client clusters Configuring default settings for NetVault
About configuring default settings Configuring encryption settings Configuring plug-in options Configuring default settings for post-scripts Configuring default settings for Verify Plug-in Configuring Deployment Manager Settings Configuring Job Manager settings Configuring Logging Daemon settings Configuring Media Manager settings Configuring Network Manager settings Configuring Process Manager settings Configuring RAS device settings Configuring Schedule Manager settings Configuring Web Service settings Configuring Auditor Daemon settings Configuring firewall settings Configuring general settings Configuring security settings Synchronizing NetVault Time Configuring default settings for global notification methods Configuring the reporting utility Configuring NetVault WebUI default settings Configuring NetVault to use a specific VSS provider Configuring default settings using Txtconfig
Diagnostic tracing Managing diagnostic data Using the deviceconfig utility NetVault processes Environment variables Network ports used by NetVault Troubleshooting
Common errors
NetVault Service fails to start on Windows NetVault Service fails to start after the machine is restarted NetVault Service starts, but stops immediately on Linux Login fails after any change in the server IP address Unexpected behavior of NetVault WebUI WebUI does not run in Compatibility View in Internet Explorer NetVault installer fails during push installation VSS-based backup fails Modifying TCP/IP socket buffer size on Windows Restores using Data Copy savesets fail on clients running NetVault 10.0.1 Restore fails on Itanium platforms if the index is larger than 2GB After upgrade, Data Copy and Consolidated backup job on Linux fails After upgrade, console error is displayed on WebUI pages Deployment task hangs on target Linux machine during push installation. Unable to add package store with hostname. Deployment task fails due to network configuration issues. Domain user is unable to login NetVault Server if the workstation attribute is set. Domain user is unable to login NetVault Server on Debian 9. Adding the target machine as a client fails, after successful push installation. Unable to install, uninstall or navigate catalog search page after manually uninstalling NetVault Client Host. Unable to install, uninstall catalog search on client after NetVault Server migration with the same or different server name External Azure AD user cannot add an external Azure AD user to NetVault Server Failed to verify target Windows machine from a Linux-based NetVault Server NetVault is unable to send reports as an email attachment in PDF format on RHEL 5.x platform Restore fails on NetVault Database backup When using RDA for backups, only four streams are used at once Unable to create large VTL on Linux Browsing a folder with a large number of files times out
Safe Mode in NetVault

Removing a package store

If a package store is no longer required, you can delete it from the Manage Stores page.

 
* 
NOTE: A package store can only be removed if it has not been used in a deployment task.
To remove a package store:
1
In the Navigation pane, click Guided Configuration, and then on the NetVault Configuration Wizard page, click Install Software/Add Clients.
2
On the Machines to Be Added as Clients page, click Install Software.
3
Click Manage Stores, and in the package store list, select the applicable package store.
4
Click Remove, and in the confirmation dialog box, click OK.

Performing push installations

You can deploy the NetVault Client and plug-ins to multiple machines by creating a deployment task from the WebUI to push the packages to the specified machines. You can use this method for both new and upgrade installations. After the packages are successfully installed on the machines, the new clients are automatically added to the NetVault Server.

To perform push installations:
1
In the Navigation pane, click Guided Configuration, and then on the NetVault Configuration Wizard page, click Install Software/Add Clients.
2
On the Machines to Be Added as Clients page, click Install Software.
3
To select a software package, next to Software, click the add icon (+).
4
In the Select Packages for Deployment window, select the installation packages that you want to use:
•
For NetVault Client packages, expand Select core packages, and then select the appropriate package.
 
* 
NOTE: Be sure to select the package that corresponds to the operating system installed on the target machines. You can deploy to only one type of operating system at a time; for example, to all Windows target machines or to all Linux target machines.
•
For NetVault plug-in packages, expand Select plug-in packages, and then select the appropriate “.npk” binary file that you want to use.
Click Apply.
5
On the Machines to Be Added as Clients page, next to Machines, click the add (+) drop-down list, and select a method for adding the deployment targets.
6
In the Add Machines window, on the Machine Details tab, enter the following details based on your method selection.
 
Method
Description

By FQDN or IP

To manually add the deployment targets, select this method.

On the Machine Details tab, provide the following details:

•
FQDN/IP Address: Specify the FQDN or IP address of the client.
•
User Name: Specify a user account that can be used to log in to the machine.
The user name must be specified in the following format:
<AD domain>\<user name>
— or —
<NETBIOS name>\<user name>
— or —
<Local user name>
•
Password: Specify the password for the user account.

Optionally, if you want NetVault to remember the password for this user name, select Save Credential.

NOTE: Saved credentials are visible only to the user who saved them. They are not available to any other users.

 

Click Next.

NOTE: When configuring the User Name option, note the following:
•
If the remote machine is a member of an Active Directory Domain, use a Domain Account that is in the local Administrators group of the machine.
•
If the remote Windows machine is in a workgroup, use the built-in Administrator account (<NETBIOS name>\<user name>).
•
If the remote machine is Linux-based, a Domain Account or local user with sudo privileges can perform a push installation.

If the built-in Administrator is disabled, you can use the following steps to enable the account and set a credentials for it:

1
Start a command prompt with administrative privileges.
2
To enable the built-in Administrator account, type the following command:
net user administrator /active:yes
Press Enter.
3
To open the Local Security Policy editor, run secpol.msc.
4
Navigate to Security Settings > Local Policies > Security Options.
5
Ensure that the User Account Control: Use Admin Approval Mode setting is disabled for the built-in Administrator account.
6
Set a password for the built-in Administrator account, and restart the machine.

If the remote Windows machine is in a workgroup, you can also use a local account with administrative privileges. However, to use a local administrator account, disable the User Account Control: Run all administrators in Admin Approval Mode setting. For security reasons, disabling this setting is not recommended; using the built-in Administrator account is the recommended approach.

From Active Directory

To select machines from an Active Directory Domain, select this method.

On the AD Details tab, provide the following details:

•
AD Server Address: Type the host name or IP address of the Active Directory Server.
•
User Name: Specify a Domain Account that is in the local Administrators group of all target Windows machines.
When pushing to Linux machines, the Domain account must have the sudo privilege in place on all Linux-based target machines.
The user name must be specified in the following format:
<AD domain>\<user name>
— or —
<NETBIOS name>\<user name>
•
Password: Specify the password for the user account.

Optionally, if you want NetVault to remember the password for this user name, select Save Credential.

NOTE: Saved credentials are visible only to the user who saved them. They are not available to any other users.

Click Connect.

In the list of Active Directory Objects, select the target machines, and then click Next.

From a file

To import the target list from a file, select this method.

In the Add machines from file dialog box, click Select a file. After selecting the file in the browse window, click OK to upload the file.

For more information about the file format, see File format for specifying deployment targets.

7
For each of the following tabs, to configure the applicable parameters, enter the details listed under Description.
 
* 
NOTE: The Installation Settings, Client Settings, and Firewall Settings are only effective when a machine is being added as a client for the first time. If a machine is already added to the server, these settings are not used for that machine.
 
Tab
Description

Installation Settings

On the Installation Settings tab, provide the following details:

•
Machine Name: Provide a NetVault name for the machine.
The NetVault machine name can contain a maximum of 63 characters. If the machine name is longer than 63 characters, the NetVault Service may fail to start. The NetVault machine names can include uppercase letters (A–Z), lowercase letters (a–z), numbers (0–9), hyphens (“-”), underscores (“_”), and periods (“.”). For more information about NetVault names, see the Quest NetVault Installation Guide.
If you leave the field blank, NetVault uses the host name.
If multiple clients are selected from an Active Directory Domain, the label changes to Machine Name Prefix. The machine name that you provide is used as the base name, and NetVault adds “_n” to the base name while assigning client names. For example, if the Machine Name is “WinClient,” the clients are assigned the names WinClient_1, WinClient_2, … WinClient_n. If you leave the field blank, NetVault uses the host names.
•
Machine Password: Provide a password for the NetVault machine.
The machine password can contain a maximum of 100 characters. It cannot contain the following characters:
\ and spaces.
•
Installation Folder: Specify the installation path.
•
Installation Language: Select the language for your NetVault installation.

Click Next.

Client Settings

On the Client Settings tab, provide the following details:

•
Client Description: Type a descriptive text for the client.
Client description can help you determine the location of the client or the role of the machine.
•
Client Group: To add the client to one or more client groups, select the corresponding check boxes.
The client groups that are configured to contain all clients are selected by default. You cannot change these selections.

Click Next.

Firewall Settings

If the client resides on a network that is outside the firewall, select the Client is Outside Firewall check box on the Firewall Settings tab, and provide the TCP/IP port specifications. For more information, see About firewall settings.

8
To save the client details, click OK.
9
If you are performing an upgrade installation on any client, select the Allow existing NetVault client installations to be upgraded check box.
10
Before submitting the task, do the following:
•
Click Verify to ensure connectivity to the clients. If any errors are reported, click Edit, and modify the applicable installation parameters.
•
If you want to assign a user-defined task name, type the name in the Task Name box.
11
To submit the task, click Install Software / Add Clients.
You can monitor the progress and status of the task from the Deployment Task Status page. For more information, see Monitoring deployment tasks.
 
* 
NOTE: The installer generates a log file in the system temporary directory. (The TEMP environment variable for system account determines the location of this directory; this path is typically set to %windir%\Temp.)

The log file is named as follows: netvault_{GUID}_install.log, where {GUID} is unique for each installation occurrence (for example, netvault_274bffb2-a3c1-457e-7f5e-221bf60a7689_install.log).

File format for specifying deployment targets

 
* 
NOTE: When creating an input file, ensure the following:
•
Use “.txt” or “.csv” filename extension for the input file.
•
In the first row, specify the field names. Use a semicolon (“;”) to separate the fields.
•
In the following rows, specify the values for the fields. Specify the field values for 1 machine per line. Use a semicolon (“;”) to separate the field values.

You can specify the following fields in the input file.

 
Table 15. Valid fields for input file
Field
Description

target

Specify the FQDN or IP address of the target machine. (The NetVault Server must be able to contact the machine on this address.)

targettype

Specify the machine type. Currently, only the fixed string “machine” is allowed.

targetusername

Specify a user account that can be used to log on to the machine.

Use the following format to specify the user name:

•
Domain Account:
<Domain>\<user_name>
•
User account that is local to the remote machine:
<user_name>

targetuserpassword

Specify the password for the user account.

nvlanguage

Specify the installation language for NetVault. This setting is only used for new client installations.

nvmachname

Specify a NetVault name for the machine.

The NetVault machine name can contain a maximum of 63 characters. If the machine name is longer than 63 characters, the NetVault Service may fail to start. The NetVault machine names can include uppercase letters (A–Z), lowercase letters (a–z), numbers (0–9), hyphens (“-”), underscores (“_”), and periods (“.”). For more information about NetVault names, see the Quest NetVault Installation Guide.

NOTE: Make sure that you assign a unique name to each client. If you specify duplicate names, the existing client details are overwritten during client addition.

nvmachpassword

Specify a password for the NetVault machine.

The password can contain a maximum of 100 characters. It cannot contain the following characters:

\ and spaces.

The NetVault password is used to add and access the clients.

nvinstallfolder

Specify the installation folder for NetVault installation. This setting is only used for new client installations.

nvclientgroup

Specify the client groups to which you want to add the client. To specify multiple groups, you can use a comma (“,”) as a delimiter.

nvdesc

Type a descriptive text for the client.

outsidefirewall

Set this option to “true” if the client is outside the firewall, and specify the ports for communicating through the firewall. For more information about configuring firewall ports, see About firewall settings.

deviceslistenports

Ports to listen on for device requests.

devicesconnectports

Ports that plug-ins use to connect to remote storage devices.

msgchannellistenports

Ports for receiving messages during data transfers.

msgchannelconnectports

Ports for sending messages during data transfers.

ndmplistenports

Ports to listen on for NetVault devices operating as NDMP movers.

ndmpconnectports

Ports for sending NDMP messages (NDMP control channels).

intermachineconnectports

Ports for establishing initial contact (broadcast channels) while adding a NetVault Client, and later to ascertain its availability.

Sample input file
target;targettype;targetusername;targetuserpassword;nvlanguage;nvmachname;nvmachpassword;nvinstallfolder;nvclientgroup;nvdesc;outsidefirewall;deviceslistenports;devicesconnectports;msgchannellistenports;msgchannelconnectports;ndmplistenports;ndmpconnectports;intermachineconnectports
10.11.12.3;machine;testdomain\administrator;UserPwd;English;Client‑A;nvpassword1;C:\Software; ClientGroup-2,default;NetVault Client-A;true;5000-5300;5000-5300;5000-5300;5000-5300;5000-5300;5000-5300;5000-5300
10.11.12.4;machine;testpc1\administrator;MyPassword;English;Client‑B;nvpassword2;C:\Software;default;NetVault Client-B;true;5000-5300;5000-5300;5000-5300;5000-5300;5000-5300;5000-5300;5000-5300
10.10.25.225;machine;testpc2\administrator;MyPassword;English;Client‑C;nvpassword3;C:\Software;default;NetVault Client-C;false;;;;;;;

Monitoring deployment tasks

You can monitor the status and progress of deployment tasks from the Deployment Task Status page. The page shows the summary of current and completed tasks in the form of bar charts and provides the progress information for individual machines.

To view the deployment task status:
1
In the Navigation pane, click Deployment Task Status.
2
On the Deployment Task Status page, you can view the following information:
•
Task Name: Name assigned to the task.
•
Start Time: Start time.
•
Total: Total number of clients.
•
Success: Number of clients on which package installation completed successfully.
•
Warnings: Number of clients on which package installation completed with warnings.
•
Errors: Number of clients on which package installation failed.
•
Updated: Status update date and time.
•
Status: Overall status of the task.
 
* 
NOTE: NetVault web application supports multiple-column sorting for the tables. For more information, see Sorting records in NetVault WebUI.

To view the page size setting, sorting order in the table, export the records, or edit table settings, click the icons at the lower-right corner of the table. For more information, see Customizing tables in NetVault WebUI.

3
To view the status details for a particular task, select the task in the Task table, and click View Task Target Status.
On the Target Status page, you can view the following information:
•
Task status charts: This area displays bar charts for the current and completed targets:
•
Current Task Targets: The individual bars represent the number of installation or upgrade tasks that running, deferred, or pending states.
•
Completed Task Targets: The individual bars represent the number of installation upgrade tasks that have completed successfully, completed with warnings, or failed.
•
Task details table: The table shows the following information:
•
Task ID: Task identification number
•
Target: Name of the target client
•
Status: Task status
4
To view the task logs, select the task in the Task table, and click View Task Logs.
(If you are on the Deployment Task Status page, select the task in the Task table, and click View Task Logs.)
On the Deployment Task Logs page, you can view the following information:
•
Severity: Severity level
•
Date: Date and time when the log was generated
•
Task ID: Task identification number
•
Target: Name of the client for which the log was generated.
•
Message: Detailed log message or description.
5
To go back to the task status page, click Back.
6
To cancel or retry a deployment task, select the task in the Task table, and click the corresponding button in the Operations pane.
Alternatively, click a link in the Navigation pane to open a different page.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating