NetVault 12.1 - Administration Guide


	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.

•

To add NetVault Backup plug-in packages, click Add NetVault plug-in package.

In the Select Packages for Deployment dialog box, select the check boxes corresponding to the “.npk” binary files that you want to use, and click OK.

Click Next.

On the Machines to Have NetVault Software Installed page, click Choose Machines, and select a method for adding the deployment targets.

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:

— or —

•

Password: Specify the password for the user account.

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

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.

•

If the remote machine is Linux-based, then only a Domain Account 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 password for it:

Start a command prompt with administrative privileges.

To enable the built-in Administrator account, type the following command:

net user administrator /active:yes

Press Enter.

To open the Local Security Policy editor, run secpol.msc.

Navigate to Security Settings > Local Policies > Security Options.

Ensure that the User Account Control: Use Admin Approval Mode setting is disabled for the built-in Administrator account.

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:

— or —

•

Password: Specify the password for the user account.

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

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.

Configure the applicable parameters.


	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.

Option

Description

Installation Settings

On the Installation Settings tab, provide the following details:

•

Machine Name: Provide a NetVault Backup name for the machine.

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

If you leave the field blank, NetVault Backup 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 Backup 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 Backup uses the host names.

•

Machine Password: Provide a password for the NetVault Backup 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 Backup 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 about these settings, see Firewall settings.

To save the client details, click OK.

If you are performing an upgrade installation on any client, select the Allow existing NetVault client installations to be upgraded check box.

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.

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

•

User account that is local to the remote machine:

targetuserpassword

Specify the password for the user account.

nvlanguage

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

nvmachname

Specify a NetVault Backup name for the machine.

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 Backup machine.

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

\ and spaces.

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

nvinstallfolder

Specify the installation folder for NetVault Backup 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 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 Backup 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 Backup 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 Backup 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 Backup 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 Backup 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:

In the Navigation pane, click Deployment Task Status.

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 Backup web application supports multiple-column sorting for the tables. For more information, see Sorting records in NetVault Backup 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 Backup WebUI.

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

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:

•