Veritas NetBackup™ Flex Scale Best Practices and Troubleshooting Guide
- Introduction
- Configuration requirements
- Best practices
- NetBackup Flex Scale tuning and sizing
- Troubleshooting NetBackup Flex Scale
- NetBackup Flex Scale logs
- Services management
- Audit logs
- Collecting logs for cluster nodes
- Error messages displayed during the pre-upgrade check
- Troubleshooting NetBackup Flex Scale issues
- If cluster configuration fails (for example because an IP address that was already in use is specified) and you try to reconfigure the cluster, the UI displays an error but the configuration process continues to run
- Validation error while adding VMware credentials to NetBackup
- NetBackup Web UI incorrectly displays some NetBackup Flex Scale processes as failed
- Unable to create BMR Shared Resource Tree (SRT) on NetBackup Flex Scale Appliance
- NetBackup configuration files are not persistent across operations that require restarting the system
- Connection timeout errors during patch installs, upgrades, and rollback operations
- Initial configuration wizard displays a driver node not selected error
- Initial configuration wizard displays a license error after successfully configuring the cluster
Collecting logs for cluster nodes
You can collect logs for an individual node in the cluster or for all the cluster nodes for error analysis and troubleshooting. You can choose to collect logs for all the components to get a comprehensive view of the system, or you can collect logs for specific components that have an issue.
- Use any one of the following options to log in using the user account that you created:
Use a user account with both Appliance Administrator and NetBackup Administrator role, or a user account with only an Appliance administrator role to log in to the NetBackup Flex Scale web interface
https://ManagementServerIPorFQDN/webuiwhere ManagementServerIPorFQDN is the public IP address, the FQDN, or the short host name that you specified for the NetBackup Flex Scale management server and API gateway during the cluster configuration, and then in the left pane click Cluster Management > Cluster settings > Diagnostics.Use a user account with an Appliance Administrator role to log in to the NetBackup Flex Scale infrastructure management console
https://ManagementServerIPorFQDN:14161where ManagementServerIPorFQDN is the public IP address, the FQDN, or the short host name that you specified for the NetBackup Flex Scale management server and API gateway during the cluster configuration, and then in the left pane click Settings > Diagnostics.Note:
If you access the NetBackup Flex Scale infrastructure management console by using the short host name from a node, set the DNS settings (name server, domain name, and search domain) or ensure that the entry for mapping the short host name to an IP address exists in the hosts file of the node.
- Click Generate log package.
On the Generate log package page, on the Basic tab you can select components or on the Advanced tab you can select individual log files to include in the log package.
- To select the components for which you want to collect logs:
On the Basic tab under Log settings, select the components. To select all the components, click All.
Component
Description
Service status
Status of the services running on the cluster nodes
OS
Kernel and user-level debug logs.
Infrastructure
Generic product information, including stack trace for running daemons, policy-based storage provisioning logs, and API gateway logs.
Explorer
Logs and system environment data collected by the
VxExplorerutility.Initial deployment
Initial cluster configuration logs. Installation logs are located in the
/opt/VRTS/install/logs/ directory.NetBackup primary service
Logs for NetBackup server services and components.
This component is displayed only if both NetBackup primary and media servers are deployed in the cluster.
Appliance
Hardware-specific logs.
Includes HPE Active Health System (AHS) logs.
Note:
If High Security mode is enabled in the HPE iLO Remote Console, AHS logs cannot be downloaded locally and are not included in the log package. To download the AHS logs, log in to the iLO Remote Console. Click Information > Active Health System Log. On the Active Health System Log page click Download.
NetBackup media service
NetBackup media server logs from nodes.
Upgrade
Upgrade logs.
NetBackup MSDP
Deduplication engine logs for all nodes.
NBSU
Information collected using the NetBackup Support Utility tool.
Performance logs
Logs for collecting performance data.
Under Package options, specify a name for the log package and optionally the case number if provided by Veritas Support.
Under Nodes, select the nodes for which you want to collect the logs.
Note:
If you switch from Basic to Advanced view (or vice versa), all the options that you specified until that point are lost and you will have to specify them again.
- To select individual log files:
On the Advanced tab under Log settings expand the nodes and select the log files.
Under Package options, specify a name for the log package and optionally the case number if provided by Veritas Support.
- Click Generate.
To view the progress of the operation, click View details on the Diagnostics page. If you had specified the case number, it is prefixed to the package name. The generated log package is displayed under Packaged logs. You can now download the package to your node or upload it to Veritas Support for error analysis.
See Downloading logs.
