Loading...

Backup Troubleshooting - IBM i File System Agent

Backup Failures

Backup fails

Check if services are running on the proxy client and the IBM i File System Agent client.

  • Run the following command on the IBM i File System Agent client to verify that the jobs are running.

    DSPJOB JOB(CVD) OPTION(*STSA)

  • Run the following command on the proxy client.

    commvault list

Backup hangs indefinitely

For information about firewall settings between the IBM i File System 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 proxy client and the  IBM i File System Agent client. These performance counters contain information that help in resolving the performance related issues during backups.

IBM i File System Agent Client Performance Counters

The performance counters printed in the IBM i File System 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.

Proxy Client Performance Counters

The performance counters printed in the proxy client 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:

  1. From the CommCell Console, navigate to Client Computers.
  2. Right-click the <Proxy Client>, and then click Properties.
  3. On the Client Computer Properties for <Proxy Client> dialog box, Click Advanced.
  4. On the Advanced Client Properties dialog box, click the Additional Settings tab.
  5. Click Add.
  6. 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.
  7. Click OK to close the Advanced Client Properties dialog box.
  8. 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 proxy client, 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:

  1. From the CommCell Console, navigate to Client Computers.
  2. Right-click the <Proxy Client>, and then click Properties.
  3. On the ClientComputerPropertiesfor <Proxy Client> dialog box, Click Advanced.
  4. On the AdvancedClientProperties dialog box, click the Additional Settings tab.
  5. Click Add.
  6. 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.
  7. Click OK to close the Advanced Client Properties dialog box.
  8. Click OK to close the Client Computer Propertiesfor <Proxy Client> dialog box.

Last modified: 6/29/2018 8:51:01 AM