Search <book_title>...

Veritas NetBackup™ Administrator's Guide, Volume I

Last Published: 2019-07-01

Product(s): NetBackup (8.2)

Setting up debug logging

Use the Setup Debug Logging Wizard to enable selected NetBackup debug logging that Technical Support uses to troubleshoot NetBackup problems. The Logging Assistant automatically creates the necessary log folders and sets the verbosity of the pertinent logs to their highest level.

Note:

Ensure that each of the selected hosts contains enough available space for the selected debug logs.

To set up debug logging

In the NetBackup Administration Console, select Logging Assistant in the left pane.
In the right pane, select the Logging Assistant record for which you want to set up debug logging. Select Actions > Setup Debug Logging.
Click Next on the Welcome panel.
On the Job Selection panel, select one of the following:
- Enable the Analyze job to identify relevant hosts and debug logging parameter, and then enter the Job ID. If you do not know the Job ID, go to the Activity Monitor to find the Job ID of the failed job. The Logging Assistant identifies the hosts and the pertinent debug logs related to the job.
  Based on the Job ID that you enter, the Logging Assistant identifies and selects debug logs for hosts and processes that enable the most effective troubleshooting of this problem. The wizard panels that follow this panel show the processes that the Logging Assistant has selected.
- For the following scenarios, skip this panel that sets up the logs based on a Job ID, and click Next:
  - The problem does not involve a particular NetBackup job.
  - You already know the hosts and debug logs that you want to enable.
  - You want to enable the logs that you previously set up for this record. Those log selections appear automatically in the panels that follow.
  The following Host Selection panel appears:
Do one or more of the following:
- Click Setup debug logging on Master Server to set up debug logging on the master server. The Master Server text window displays the master server.
- Click Setup debug logging on Media Server(s) to set up debug logging on the media servers. If the master server is also a media server, you may still want to select it again as a media server. Use the right arrow option (>>) to move a highlighted media server from the Available Media Servers window across to the Selected Media Servers window.
- Click Setup debug logging on Client(s). Enter Client names. to set up debug logging on clients. In the text window under this parameter, enter the names of clients for which you want to set up debug logging. Separate the client names by commas. Do not use any spaces between the client names.
Click Next to display the panel.
Click Next to continue. Logging Assistant validates the specified hosts to establish connectivity and validates the NetBackup versions that are installed on the hosts.
If you selected Setup debug logging on Master Server, the Setup Debug Logging on Master Server panel appears.
This panel contains a list of problem categories on the master server and the process names associated with each category of problem. Click the problem category or categories that apply to the failed job.
For example, for problems with synthetic backups on the failed job, select Backup - Synthetic. The debug logs for bpcd, bpdm, and bptm are enabled.
Click If required, specify additional components to set up debug logging to enter components to enable debug logging. For example, for if you have Java interface problems, but only want the debug logs for jnbSA, instead of all four of the processes lists, enter jnbSA in the text window. Enter multiple components separated by commas with no spaces between entries.
Technical Support publishes a list of valid components that you can specify in this text box.
http://www.veritas.com/docs/TECH204256
Click Next to continue.
Perform the same actions for the media server (if selected in step 5) and the clients (if selected in step 5).
Click Next to continue.
The Setup Debug Logging Summary panel confirms all the items you selected in the previous panels of the Setup Debug Logging Wizard. Review the information. The summary shows on which hosts of your NetBackup system that you chose to enable logs: master server, media servers, and clients or a combination of these items. It also shows the host names and the logs that are enabled on each.
Click Next to enable the debug logging. All pertinent logs are set to their highest (most verbose) level.
The Setup Debug Logging Results panel displays the hosts and components that have been successfully enabled and unsuccessfully enabled.
Click Finish to return to the Logging Assistant Records panel of the NetBackup Administration Console.