NetBackup™ Troubleshooting Guide
- Introduction
- Troubleshooting procedures
- About troubleshooting procedures
- Troubleshooting NetBackup problems
- Troubleshooting installation problems
- Troubleshooting configuration problems
- Device configuration problem resolution
- Testing the primary server and clients
- Testing the media server and clients
- Resolving network communication problems with UNIX clients
- Resolving network communication problems with Windows clients
- Troubleshooting vnetd proxy connections
- vnetd proxy connection requirements
- Where to begin to troubleshoot vnetd proxy connections
- Verify that the vnetd process and proxies are active
- Verify that the host connections are proxied
- Test the vnetd proxy connections
- Examine the log files of the connecting and accepting processes
- Viewing the vnetd proxy log files
- Troubleshooting security certificate revocation
- Troubleshooting cloud provider's revoked SSL certificate issues
- Troubleshooting cloud provider's CRL download issues
- How a host's CRL affects certificate revocation troubleshooting
- NetBackup job fails because of revoked certificate or unavailability of CRLs
- NetBackup job fails because of apparent network error
- NetBackup job fails because of unavailable resource
- Primary server security certificate is revoked
- Determining a NetBackup host's certificate state
- Troubleshooting issues with external CA-signed certificate revocation
- About troubleshooting networks and host names
- Verifying host name and service entries in NetBackup
- Example of host name and service entries on UNIX primary server and client
- Example of host name and service entries on UNIX primary server and media server
- Example of host name and service entries on UNIX PC clients
- Example of host name and service entries on UNIX server that connects to multiple networks
- About the bpclntcmd utility
- Using the Host properties to access configuration settings
- Resolving full disk problems
- Frozen media troubleshooting considerations
- Troubleshooting problems with the NetBackup web services
- Troubleshooting problems with the NetBackup web server certificate
- Resolving PBX problems
- Troubleshooting problems with validation of the remote host
- Troubleshooting Auto Image Replication
- Troubleshooting network interface card performance
- About SERVER entries in the bp.conf file
- About unavailable storage unit problems
- Resolving a NetBackup Administration operations failure on Windows
- Resolving garbled text displayed in NetBackup Administration Console on a UNIX computer
- Troubleshooting error messages in the NetBackup web UI and the NetBackup Administration Console
- Extra disk space required for logs and temporary files for the NetBackup Administration Console
- Unable to logon to the NetBackup Administration Console after external CA configuration
- Troubleshooting file-based external certificate issues
- Troubleshooting issues with external certificate configuration
- Troubleshooting Windows certificate store issues
- Troubleshooting backup failures
- Troubleshooting backup failure issues with NAT clients or NAT servers
- Troubleshooting issues with the NetBackup Messaging Broker (or nbmqbroker) service
- Troubleshooting issues with email notifications for Windows systems
- Troubleshooting issues with KMS configuration
- Troubleshooting issues with initiating the NetBackup CA migration because of large key size
- Troubleshooting issues with the non-privileged user (service user) account
- Troubleshooting issues with group name format in the auth.conf file
- Troubleshooting the VxUpdate add package process
- Troubleshooting issues with FIPS mode
- Troubleshooting issues with malware scanning
- Troubleshooting issues with NetBackup jobs that are enabled for data-in-transit encryption
- Troubleshooting issues with Unstructured Data Instant Access
- Troubleshooting issues with multifactor authentication
- Troubleshooting issues with multi-person authorization
- Troubleshooting connections to the NetBackup Scale-Out Relational Database
- Troubleshooting issues with private key encryption
- Troubleshooting issues with the security configuration risk feature
- Troubleshooting issues with the risk engine-based anomaly detection options
- Using NetBackup utilities
- About NetBackup troubleshooting utilities
- About the analysis utilities for NetBackup debug logs
- About the Logging Assistant
- About network troubleshooting utilities
- About the NetBackup support utility (nbsu)
- About the NetBackup consistency check utility (NBCC)
- About the NetBackup consistency check repair (NBCCR) utility
- About the nbcplogs utility
- About the robotic test utilities
- About the NetBackup Smart Diagnosis (nbsmartdiag) utility
- About log collection by job ID
- Disaster recovery
- About disaster recovery
- Recommended backup practices
- Requirements and notes for disaster recovery
- Disaster recovery packages
- About disaster recovery settings
- About disk recovery procedures for UNIX and Linux
- About clustered NetBackup server recovery for UNIX and Linux
- About disk recovery procedures for Windows
- About clustered NetBackup server recovery for Windows
- Generating a certificate on a clustered primary server after disaster recovery installation
- About the DR_PKG_MARKER_FILE environment variable
- Restoring the disaster recovery package on Windows
- Restoring the disaster recovery package on Linux
- Options to recover the NetBackup catalog
- Prerequisites for recovering the NetBackup catalog or NetBackup catalog image files
- About NetBackup catalog recovery on Windows computers
- About NetBackup catalog recovery from disk devices
- About NetBackup catalog recovery and symbolic links
- NetBackup disaster recovery email example
- About recovering the entire NetBackup catalog
- About recovering the NetBackup catalog image files
- About recovering the NetBackup databases
- Recovering the NetBackup catalog when NetBackup Access Control is configured
- Recovering the NetBackup catalog from a nonprimary copy of a catalog backup
- Recovering the NetBackup catalog without the disaster recovery file
- Recovering a NetBackup user-directed online catalog backup from the command line
- Restoring files from a NetBackup online catalog backup
- Unfreezing the NetBackup online catalog recovery media
- Steps to carry out when you see exit status 5988 during catalog recovery
Troubleshooting issues with the security configuration risk feature
Security configuration risk depends on the status of the security settings in your NetBackup domain. A higher configuration risk score indicates weaker security configurations. To minimize the risk, enable all the security settings.
For more information on the security configuration risk feature, refer to the NetBackup Security and Encryption Guide.
Table:
Sr. No. | Issue | Possible reason | Resolution |
|---|---|---|---|
1. | Internal server error in: GET API /security/status | Error in extracting the cluster name or client name for the given host through NetBackup Service Layer (NBSL). Check the logs to confirm the following: "Cannot retrieve hostName from system property" | Check if the NBSL service is up and running. Ensure that the Client name (virtual name in case of cluster) is properly set for the given primary server. |
Exception in searching for the given host by its host name in database. Check the logs to confirm the following: "Exception occurred: hostname not found." | Ensure that the NetBackup database services are up and running. Increase verbosity, and retry the operations. Contact Cohesity technical support. | ||
Failure in reading base state template from database. Check the logs to confirm the following: "Caught exception while reading security template json." | Ensure that the correct JSON file is present in the database in EMM_MAIN schema: emm_hostconffileversiondata No key should have a null value. | ||
Error in extracting number of hosts configured with service user from the database. Check the logs. | Ensure that the NetBackup database services are up and running. Increase verbosity, and retry the operations. Contact Cohesity technical support. | ||
API failed to extract malware configuration details for the host. Check the logs to confirm the following: "Exception raised from getting malware settings" | Increase verbosity, and retry the operations. Contact Cohesity technical support. | ||
API failed to extract number of hosts from the database. Check the logs to confirm the following: "Cannot retrieve number of hosts from database." | Ensure the NetBackup database services are up and running. Increase verbosity, and retry the operations. Contact Cohesity technical support. | ||
API failed to extract supported operations for MPA. Check the logs to confirm the following: "Error in fetching list of MPA supported operations." | Ensure the NetBackup database services are up and running. Increase verbosity, and retry the operations. Contact Cohesity technical support. | ||
8. | Internal server error in POST API /security/configuration-baseline | Validation of the request DTO failed. Check the logs to confirm the following: "Request DTO validation failed." | Validate input JSON to the API. Refer to the following to check the possible states of settings:
|
9. | Notifications for security configuration risk are not generated. | Security baseline may be changed within 10 seconds of the change in configuration settings. | Avoid changing security baseline within 10 seconds of changing the security settings state. Retry the operations. Contact Veritas technical support if the issue still persists. Collect web service logs and NetBackup audit logs. |
10. | Exception with message: "The dashboard security status request or the data that is sent is not valid." | Possible reasons:
| Set the security baseline again. |
NetBackup database service is not running. | Ensure that the NetBackup database services are up and running. | ||
Anomaly management service is not running. | Ensure that Anomaly management service is up and running. | ||
nbstserv is not running. | Ensure that nbstserv is up and running. | ||
NetBackup Service Layer service is not running. The file should have service_user permissions. | Ensure that the NetBackup Service Layer (NBSL) is up and running. | ||
Validation of the request DTO failed. The payload provided was having one of the unsupported attributes (from API version 13.0) or invalid value. | Validate input JSON to the POST security/configuration-baseline API for request API Version 12.0. The following payload JSON is supported: { "data": { "type": "securityTemplateRequest", "attributes": { "securitySettingsTemplate": { "allowInsecureBackLevelHost": 0, "certificateAutoDeployLevel": 0, "mfaEnforced": false, "dteGlobalMode": "PREFERRED_OFF", "hostPercentageWithDteEnabled": 0, "backupAnomalyDetection": 0, "mpa": "ENABLED", "malwareDetection": "CONFIGURED", "hostPercentageWithServiceUser": 0 } } } } | ||
Validation of the request DTO failed. The payload was containing attribute with invalid value. | Validate input JSON to the POST security/configuration-baseline API for request API Version 13.0. The following JSON is supported: { "data": { "type": "securityTemplateRequest", "attributes": { "securitySettingsTemplate": { "allowInsecureBackLevelHost": 0, "certificateAutoDeployLevel": 0, "mfaEnforced": false, "dteGlobalMode": "PREFERRED_OFF", "hostPercentageWithDteEnabled": 0, "backupAnomalyDetection": 0, "mpa": "ENABLED", "malwareDetection": "CONFIGURED", "hostPercentageWithServiceUser": 0, "backupStoragePercentageWithEncryptionEnabled": 0, "isImmutableBackupStorageConfigured": true, "serverPercentageWithLatestNbuVersion": 0, "clientPercentageWithLatestNbuVersion": 0, "isCliAccessToOsAdmins": 0, "isWebUiAccessToOsAdmins": 0, "redirectedRestore": true } } } } | ||
11. | Some settings do not have baseline value after upgrade | Some of the new security settings that are added in the NetBackup 11.0 do not have baseline set unless you set it explicitly. | Set the baseline values for all the security settings. |