Backup Troubleshooting

Backup Failures

Backup fails

Check if services are running on the access node and the IBM i Agent client.

Run the following command on the IBM i Agent client to verify that the jobs are running.
```
DSPJOB JOB(CVD) OPTION(*STSA)
```
Run the following command on the access node.
```
commvault list
```

Backup hangs indefinitely

For information about firewall settings between the IBM i Agent client and the proxy, see Firewall.

Troubleshoot Performance Issues

If you are experiencing performance issues during backup, you can troubleshoot them by enabling logging of performance details in the log files on the access node and the IBM i Agent client. These performance counters contain information that help in resolving the performance related issues during backups.

IBM i Agent Client Performance Counters

The performance counters printed in the IBM i Agent client log files include:

FileRead	Disk read speed for IFS file system files.
QanePipe Read	Disk read speed for QSYS objects.
Data Send	Network transfer speed.
QaneCall	Time spent in Qane call. Qane call is a system call that performs library read/write.
Thread Wait	Time spent on waiting a Qane thread completion.

Access Node Performance Counters

The performance counters printed in the access node log files include:

FileRead	Average time spent in system call to read the file.
CheckFileHole	Average time spent to verify if buffer read from the disk is a hole.
Close File	Average time spent in system call to close the file.
AllocBuffer	Average time spent waiting for the network buffer.
WriteBuffer	Average time spent in sending the network buffer to the network.
Disk Read	Average speed of reading from the disk.
Write	Average speed of writing to the network.

Display performance details of a backup job

Use the following steps to display the performance details for a specific backup job:

From the CommCell Console, navigate to Client Computers.
Right-click the <Proxy Client>, and then click Properties.
On the Client Computer Properties for <Proxy Client> dialog box, Click Advanced.
On the Advanced Client Properties dialog box, click the Additional Settings tab.
Click Add.
On the Add Additional Settings on Unix Client dialog box, perform the following:
- In the Name box, type <LogFileName>_PERF. The Category and Type details are automatically populated.
  
  Alternatively, you can click Lookup and search for the additional setting using the Find box.
- In the Value box, type true.
- Click OK.
Click OK to close the Advanced Client Properties dialog box.
Click OK to close the Client Computer Properties for <Proxy Client> dialog box.

Display performance details for each file in a backup job

In addition to viewing the performance details for a backup job on the access node, you can also view the performance details of each file in the backup job. Note that the file names are not printed in the log.

Note: Use this additional setting with the <LogFileName>_PERF additional setting.

Use the following steps to display performance details for each file in a backup job:

From the CommCell Console, navigate to Client Computers.
Right-click the <Proxy Client>, and then click Properties.
On the ClientComputerPropertiesfor <Proxy Client> dialog box, Click Advanced.
On the AdvancedClientProperties dialog box, click the Additional Settings tab.
Click Add.
On the Add Additional Settings on Unix Client dialog box, perform the following:
- In the Name box, type <LogFileName>_PERF_FILE. The Category and Type details are automatically populated.
- In the Value box, type true.
- Click OK.
Click OK to close the Advanced Client Properties dialog box.
Click OK to close the Client Computer Propertiesfor <Proxy Client> dialog box.

Backup Troubleshooting - IBM i Agent