Search <book_title>...

Veritas NetBackup™ Virtual Appliance Documentation

Last Published: 2017-07-25

Product(s): Appliances (3.0)

Troubleshooting NetBackup Virtual Appliance initial deployment issues

Before you can begin troubleshooting a NetBackup Virtual Appliance initial deployment failure, you need to determine when the problem occurred. A failure can occur during either of the following processes:

The OVF deployment wizard operations in the vSphere Web Client
If an error occurs in the OVF deployment wizard, the only way to fix it is to restart the deployment. Before you do so, make sure that you verify the information that you entered in the deployment wizard. You can also reference the VMware documentation for help with specific error messages.
The NetBackup Virtual Appliance automatic configuration
If an error occurs during the automatic configuration process, the OVF deployment wizard behaves as if the deployment was successful. However, if you log on to the NetBackup Virtual Appliance Shell Menu and run the Main > Appliance > Status command, the appliance appears to be in a factory state and is not configured as a master appliance.
The following are a few common reasons for the automatic configuration to fail:
- Typos in the deployment wizard
- Incorrect IP addresses
- Incorrect host name or DNS information
You can check the boot log for additional details to help determine the exact error that occurred. Use the following steps to view the boot log:
- Log on to the NetBackup Virtual Appliance Shell Menu and enter the Main > Support > Logs > Browse command.
- At the LOGROOT/> prompt, enter cd OS and then less boot.log.
The most straightforward method to resolve configuration errors is to redeploy the appliance, making sure that you enter the correct information in the deployment wizard.
However, if you have encountered multiple failures or want to try to resolve the issue from the NetBackup Virtual Appliance Shell Menu, use the following procedure to manually complete the configuration process.

To manually configure the appliance networking from the NetBackup Virtual Appliance Shell Menu

Open an SSH session to the appliance to log on to the NetBackup Virtual Appliance Shell Menu.
The logon is admin, and the default password is P@ssw0rd.
If you cannot open an SSH session to the appliance, you can attempt to log on from the vSphere Web Client. Navigate to the deployed appliance and select the Console tab to access the shell menu.
If you still cannot log on, return to the OVF deployment wizard and redeploy the appliance.
Navigate to the Main > Network view and enter the following command to configure the IP address of a single network that you want your appliance to connect to:
Configure IPAddress Netmask GatewayIPAddress eth1
Where IPAddress is the new IP address, Netmask is the netmask that corresponds to the IP address, and GatewayIPAddress is the IP address of the default gateway for the interface.
The IPAddress and the GatewayIPAddress can be an IPv4 or IPv6 address. Only global-scope and unique-local IPv6 addresses are allowed.
Remember that you should not use both IPv4 and IPv6 address in the same command. For example, you cannot use Configure 9ffe::9 255.255.255.0 1.1.1.1.. You should use Configure 9ffe::46 64 9ffe::49 eth1
From the Main > Network view, use the following command to set the appliance DNS domain name:
DNS Domain Name
Where Name is the new domain name for the appliance.
From the Main > Network view, use the following command to add the DNS name server to your appliance configuration:
DNS Add NameServer IPAddress
Where IPAddress is the IP address of the DNS server.
The address can be either IPv4 or IPv6. Only global-scope and unique-local IPv6 addresses are allowed.
From the Main > Network view, use the following command to set the host name for your appliance:
Hostname Set Name
Where Name is a short host name or a fully qualified domain name (FQDN) for the appliance. As a best practice, Veritas recommends that you use FQDN.
Caution:
The host name can only be set during initial deployment. After the initial deployment has completed successfully, the only way to change the host name is to redeploy the appliance.
Note:
If you plan to configure Active Directory (AD) authentication on this appliance, the host name must be 15 characters or less. Otherwise, AD configuration can fail.
Use the following command to set the role of the appliance:
Main > Appliance > Master
Use the following command to verify that the networking and the role configuration were successful:
Main > Appliance > Status
The command output should contain a message similar to the following:
```
Appliance Version is 3.0.

Appliance is configured as master appliance.
```
If everything completed successfully, return to the initial deployment procedure and complete the remaining steps for the appliance configuration. See “To complete the initial configuration of a NetBackup Virtual Appliance”.

If none of these steps resolved your issue, you can find additional troubleshooting information for specific appliance issues from the NetBackup Virtual Appliance page on the Veritas Support website. Use the search bar at the top of the page to look for articles relating to specific issues.

If you still need assistance, contact Veritas Support.

More Information

About contacting Technical Support

About troubleshooting the NetBackup Virtual Appliance