Veritas NetBackup™ Appliance Troubleshooting Guide

Last Published:
Product(s): Appliances (3.3.0.1, 3.2, 3.1.2, 3.1.1, 3.1)
Platform: NetBackup Appliance OS

Error messages displayed on the NetBackup Appliance Shell Menu

Table: Common error messages in the NetBackup Appliance Shell Menu lists some of the common error messages that you may come across while working from the NetBackup Appliance Shell Menu:

Table: Common error messages in the NetBackup Appliance Shell Menu

Error messages

Explanation / Recommended action

Master server denied access to this appliance

Verify that you added the appliance host name to the master server's known server list. You can use the NetBackup Administration Console to add the appliance to the master server"s known server list.

See the NetBackup Administrator's Guide for instructions.

Unable to connect to master server

Make sure that the NetBackup services are up and running on the master server. Also verify that there are no firewalls blocking accesses to the master server services.

See the NetBackup Administrator's Guide for more information on how to allow access through firewalls.

Failed to get NetBackup version

Make sure that the NetBackup services are up and running on the appliance. If you encounter this issue, restart the NetBackup services.

Master server version is lower than the media server version

If the master server is a standard non-appliance master server, upgrade the NetBackup software on the master server to a version that is equal to or higher than the current media server version.

Upgrade the master server if it is an appliance with the appliance version that contains NetBackup release equal to or higher than the NetBackup release on the media server.

Failed to access disk storage

This problem can arise due to multiple issues. For example, if the disks are offline or the disk volume is disabled. In these scenarios:

  • Collect DataCollect log

  • Check /log/app_vxul/409-9-*.log for the actual disk group and volume-related errors.

Failed to resize volumes

First, attempt to change value of the required partition size or the percentage. Second, enter a value that is in a different format than what was originally used. For example, enter an absolute size and restart the appliance host.

Check /var/log/sf.log for volume (VxVM) error messages.

Failed license check for AdvancedDisk storage

Make sure that a valid license for the NetBackup Flexible Disk Option is installed on the media server.

Failed license check for Deduplication storage

Make sure that a valid license for NetBackup Deduplication Option is installed on the media server

Failed to create Deduplication storage unit

Check if the storage unit or the corresponding disk volume already exists on the media server. If they do exist, verify if the storage unit or the corresponding disk volume is currently used. If the storage is redundant only then use the NetBackup Administration Console or the nbdecommission utility to delete them.

These tools are available on the NetBackup master server. Check the NetBackup Appliance VxUL (unified) logs with the Support > Logs > VxLogView Module ALL command for more precise error information.

Table: Manage > Software view lists error messages that are specific to the Manage > Software view commands.

Table: Manage > Software view

Error message

Explanation

Recommended action

Failed to read the update configuration for <RPM name>.

There are some errors in rpm patch.

Please contact Veritas Support for help.

The NetBackup appliance version is already at <version number>.

The current appliance version is the same as the version in the patch. The appliance has stopped installing the patch.

Please check if this patch has been installed, if yes then identify the correct patch to install on the appliance.

Cannot install the software update. The software update version is <version number> and the appliance version is <version number>.

The current version installed on the appliance is higher than the version of the patch you are trying to install.

Please identify and try to install the correct patch on the appliance.

The installation failed because the patch does not exist or you did not run the List downloaded command to check for the downloaded patch.

The installation has failed as the patch you are trying to download does not exist or is not up-to-date.

Please identify and try to install the correct patch on the appliance. Run the List downloaded command to check for the downloaded patch and install the correct patch.

An upgrade process is already running on this appliance.

Unable to get the upgrade lock, which means another upgrade is running on the appliance.

Please check if there is another instance of the upgrade process running on the appliance.

Unknown error. Please contact Veritas Technical Support!

The source of the error cannot be found.

Please contact Veritas Technical Support.

Software update, <rpm> is already installed on compute node, <node name>.

The rpm (installer package) is already installed on the appliance.

Please check if the rpm you are trying to install has already been installed on the appliance.

Unable to verify that software update, <rpm>, is installed

Unable to check weather the rpm (installer package) you are trying to install is already present on the appliance.

Please check if there are some system errors.

Failed to get NetBackup version on Master <master server name>.

Failed to get the version info on the master server.

Please check if there are some network problems, or the master server was turn off un-expectedly.

Version of NetBackup on Master <master server name> is <version number>, should be <version number>

The version number on the master does not match the requirements from the patch.

Please ensure that the NBU version is installed on the master server, or it's not the proper patch to install.

Invalid Appliance mode.

The appliance mode in bp.conf file is not correct.

Please check the appliance mode in bp.conf and contact Veritas Support.

Please provide a valid EEB name.

This error message is only for the rollback of EEB. The EEB name is not valid.

Please check that the EEB name you have used.

Patch <rpm name> signature check failed.

Signature error found in the rpm (installer package) .

Please check if the md5 number of the rpm (installer package) is correct. It's commended to re-download the rpm.

NetBackup jobs are currently in progress. Stop all NetBackup jobs and then try the upgrade again.

The upgrade requires stopping all NetBackup jobs.

Please stop the NetBackup jobs, before upgrading the appliance software.

Unable to gather backup job summary information. This may indicate that some processes are not running and that you should restart your appliance.

The upgrade process checks to see if there are any active NetBackup jobs. The upgrade process only proceeds if it is determined no active jobs are detected. If the backup job summary cannot be complied it means that some of the process are not running.

Please check if the NetBackup services are running correctly.

The software upgrade process failed. The appliance is rolling back to a pre-upgrade state using the Pre-upgrade checkpoint!

The software upgrade process has failed and the appliance will automatically roll back to pre-upgrade state.

Please wait till the rollback is complete.

Failed to create the pre-upgrade checkpoint, please resolve this issue first!

The pre-upgrade checkpoint cannot be created due to an unexpected error.

Please contact Veritas support to take a look at the checkpoint log.

Self-Test failed, please resolve this issue first!

The self-test has failed due to an unexpected error.

Please run the Support > Test software command to see the detailed error message.

Table: Manage > Appliance Restore view lists error messages that are specific to the Manage > Appliance Restore view commands.

Table: Manage > Appliance Restore view

Error message

Explanation

Recommended action

Appliance Checkpoint creation failed. Retry again once errors are resolved.

This can be caused by insufficient disk space.

Look for additional information listed above the error message. Retry the operation. Cleanup is done in case of such a failure, which could free up the space.

Rollback validation failed. Unable to continue with rollback to Appliance Checkpoint. Please correct the errors above and try again.

Secured network communication has issues.

Look for additional information listed above the error message. Try to correct the error and retry the operation.

Rollback to Appliance Checkpoint <checkpoint_name> failed. Please proceed with the suggested system reboot. Some rollback to Appliance Checkpoint errors can be resolved by rebooting the appliance(s).

System resources could be busy.

Restart the appliance and retry the rollback operation.

Factory reset validation failed. Unable to continue. Please fix the errors above and try again.

Secured network communication has issues.

Look for additional information listed above the error message. Try to correct and retry the operation.

Reset of the appliance to a Factory State failed. Please proceed with the suggested system reboot. Some reset failures can be resolved by rebooting the appliance(s).

System resources could be busy.

Restart the appliance and retry factory reset.

Table: Main_Menu > Network view lists error messages that are specific to the Main_Menu > Network view commands.

Table: Main_Menu > Network view

Error message

Explanation

Recommended action

Failed to create VLAN <vlan_id>. Ether device {interface} does not exist.

This error occurs when you enter an enter invalid interface.

Provide a valid numeric identifier for the <vlan_id>.

Failed to create VLAN <vlan_id>. Interface <eth> is configured with IP address 10.10.10.10. Cannot create a VLAN device over a configured interface. Unconfigure the IP before adding a VLAN device.

This error occurs when you try to tag a VLAN over an interface that is configured with an IP address .

Enter an IP address that is not configured to another interface. Alternatively, you may also unconfigure the existing IP address for the given interface and then tag VLAN.

Failed to create VLAN <vlan_id>. Interface <eth> is not cabled.

This error occurs when you try to tag a VLAN over an unplugged interface.

Ensure that the interface that is selected for tagging VLAN is plugged.

Failed to create VLAN <vlan_id>. Interface <eth> is slave to bond <bond>. Cannot create a VLAN over a bonded interface.

This error is displayed if you try to tag a VLAN over a bonded interface.

Ensure that the interfaces that is selected for VLAN tagging is not already a part of a bond.

Interface {interface} does not exist.

This error occurs if you enter an invalid interface name for creating bond using the LinkAggregation command.

Enter a valid interface name for creating a bond.

None of the given interfaces <interface(s)> are cabled. Make sure at least one interface is cabled.

This error is displayed if any of the interfaces that participate in creating bond are unplugged.

Ensure that at least one of the interfaces that participates in bond creation is plugged.

Cannot enable bonding for a single interface. To enable bonding, provide details for more than one interface.

This error is displayed if you provide a information for a single interface for creating a bond.

To create a bond, provide interface details for more than one interface.

Interfaces <interface(s)> are not of same type and speed.

This error occurs when you try to create a bond with interfaces that have different port speeds.

Ensure that the interface that are selected for creating a bond have same port speed.

Interface <interface> is part of a bond.

This error occurs when you provide details of an interface that is already a part of another bond.

Ensure that the interfaces that is selected for the operation is not already a part of a bond.

Cannot enable bonding for duplicate interface(s), <eth> To enable bonding, provide details for different interface(s)

This error is displayed if you enter duplicate interface names while creating a bond. For example, <eth3>, <eth4>, <eth4>

Do not enter duplicate interfaces names while creating a bond.

Interface <bond> is a bonded interface. Cannot use bonded interfaces in bond.

This error is displayed if you try to create a bond over using an interface that is already a part of another bond.

Ensure that the interfaces that is selected for creating a bond is not a part of an existing bond.

Cannot use interface <eth> in a bond. Interface is in use by VLAN <vlan_id>.

This error occurs when you try to create a bond using an interface over which a VLAN is tagged.

Enter details for an interface that does not have any VLAN(s) tagged over it.

More than one interfaces (eth4:10.10.10.10 eth5:10.10.10.11 ) are configured. Use Main->Network->Unconfigure to remove one.

This error occurs when you try to create a bond with interfaces for which have IP addresses are configured.

To create a bond between interfaces, IP address should not be configured for more than one interface.

Table:  Main_ Menu > Network > WANOptimization view lists error message that are specific to the Main_menu > Network > WANOptimization view commands.

Table: Main_ Menu > Network > WANOptimization view

Error code and error message

Explanation

Recommended action

<V-409-925-11> Invalid result returned.

Cannot get the WAN optimization status because of an unexpected error or because a service may be down.

Restart the web service by starting the NetBackup Appliance Shell Menu. Then run the following command:

Support > InfraServices > Start WebServer

If the issue continues, contact technical support.

< V-409-925-12> Network interface optimization cannot be enabled for network port {{port}}.

The individual network interfaces are part of a network interface port bond. The individual network interfaces that comprise a bond cannot be enabled.

To enable WAN optimization for an individual network interface that is part of a bond, you must first delete the bond. After deleting the bond, you can then enable WAN optimization for the selected network interface.

Note:

Deleting the bond automatically disables WAN optimization for all network interfaces that comprise the bond.

< V-409-925-13> Network interface optimization cannot be disabled for network port {{port}}.

The individual network interfaces are part of a network interface port bond. Individual network interfaces that comprise a bond cannot be disabled

To delete WAN optimization for an individual network interface that is part of a bond, you must delete the bond. Deleting the bond automatically disables WAN optimization for all network interfaces that comprised the bond.

< V-409-925-14> Cannot disable WAN Optimization for network port {{port}}.

The specified network interface does not exist.

Remove the name of the network port that you want to disable from the parameters that you are entering on the command line.

< V-409-925-15> Cannot enable WAN Optimization for network port {{port}}.

The specified network interface does not exist.

Remove the name of the network port that you want to enable from the parameters that you are entering on the command line.

Table: Main_menu > Settings view lists error messages that are specific to the Main_menu > Settings view commands.

Table: Main_menu > Settings view

Error code and error message

Explanation

Recommended action

V-409-810-0001: Unable to detect the Deduplication service because the appliance role is not set. You must configure the appliance role using the Main_Menu > Appliance commands before you can enable this feature.

The appliance cannot be configured as a target host for Optimized Duplication and Auto Image Replication over Fibre Channel (FC) before the appliance role is set.

Set the appliance role.

V-409-810-0013: Failed to enable the Deduplication service because of an internal error. Contact Veritas Technical Support.

The appliance cannot be configured as a target host for Optimized Duplication and Auto Image Replication over FC because of an internal error.

Contact Veritas Technical Support.

V-409-810-0014: Failed to perform the operation because of an internal error. Contact Veritas Technical Support.

The appliance cannot perform the operation because of an internal error.

Contact Veritas Technical Support.

V-409-810-0015: Failed to enable the Deduplication service because of an internal error. Contact Veritas Technical Support.

The appliance cannot load the target port configuration because of an internal error.

Contact Veritas Technical Support.

V-409-810-0017: Failed to perform the operation because of an internal error. Contact Veritas Technical Support.

The appliance cannot disable Fibre Transport Deduplication because of an internal error.

Contact Veritas Technical Support.

V-409-810-0018: The current appliance model is not standard. Check your HBA card configuration and then contact Veritas Technical Support.

The appliance cannot enable Fibre Transport Deduplication because the HBA card configuration in the real panel is not a NetBackup Appliance standard hardware configuration. The factory HBA card configuration may have changed for the following reasons:

  • One or more HBA cards have failed.

  • One or more HBA cards have been installed or uninstalled.

To troubleshoot the problem, do the following:

  • Check the hardware health or hardware alerts

  • Check the HBA card in the real panel

  • Contact Veritas Technical Support.

V-409-810-0019: Failed to perform the operation because of an internal error. Contact Veritas Technical Support.

The appliance cannot perform the operation because of an internal error.

Contact Veritas Technical Support.

Table: Main_menu > Support > FibreTransport view lists error messages that are specific to the Main_menu > Support > FibreTransport view commands.

Table: Main_menu > Support > FibreTransport view

Error code and error message

Explanation

Recommended action

V-409-810-0006: Failed to configure the chunk size for optimized duplication and replication because the appliance role is not set. Before you can configure the chunk size for optimized duplication, you must first set the appliance role.

The Fibre Transport (FT) chunk size cannot be configured and used before the appliance role is set.

Set the appliance role.

V-409-810-0007: Failed to set the chunk size for optimized duplication and replication because of an internal error. Contact Veritas Technical Support.

The FT chunk size cannot be configured and used because of an internal error.

Contact Veritas Technical Support.

V-409-810-0016: Failed to perform the operation because of an internal error. Contact Veritas Technical Support.

The appliance cannot perform the operation because of an internal error.

Contact Veritas Technical Support.

Table: Main_menu > Manage > FibreChannel view lists error message that are specific to the Main_menu > Manage > FibreChannel view commands.

Table: Main_menu > Manage > FibreChannel view

Error code and error message

Explanation

Recommended action

V-409-810-0002: Failed to restart the Deduplication service because of an internal error. Contact Technical Support.

The appliance cannot be configured as a target host for Optimized Duplication and Auto Image Replication over FC because of an internal error.

Contact Veritas Technical Support.

V-409-810-0011: Unable to configure the port Slot:Port as an FC Initiator port. The port is reserved for %s and cannot be changed. For more information about reserved HBA ports, refer to the NetBackup Appliance Fibre Channel Guide.

The port is reserved for use as target mode ports for SAN Client FTMS, and cannot be used as a initiator port for Optimized Duplication and Auto Image Replication over FC.

Use another port that can be used as a initiator port for Optimized Duplication and Auto Image Replication over FC.

Refer to the NetBackup Appliance Fibre Channel Guide for the available ports.

V-409-810-0012: Cannot find the port Slot:Port. Invalid HBA port identifier. Check the HBA ports on the appliance and make sure to enter a valid slot number (1-6) and a valid port number (1-2).

The appliance cannot find the port specified by the user. The user must have entered an invalid slot number, port number, or both.

Refer to the NetBackup Appliance Fibre Channel Guide for the available ports.

V-409-810-0014: Failed to perform the operation because of an internal error. Contact Veritas Technical Support.

The appliance cannot perform the operation because of an internal error.

Contact Veritas Technical Support.

V-409-810-0020: Failed to perform the operation because of an internal error. Contact Technical Support.

The appliance cannot perform the operation because of an internal error.

Contact Veritas Technical Support.