Troubleshooting Backup - Macintosh File System iDataAgent

Backup Restore  
The following section provides information on some of the troubleshooting scenarios related to backup:

Backup Failures

Backup fails The subclient content might have remote scripts with one or more blank lines at the top.

Ensure that you delete the blank lines at the top of any remote scripts.
Backup hangs indefinitely

Ensure that there are no stale NFS mounts on the server included in the backup.

If there are stale NFS mounts on the server, backups hang indefinitely. This can be avoided by either adding the mounted directory to the exclusion filter of the subclient or ensuring that the NFS mount points are available for backups.
Error while loading shared libraries On Linux clients, the below error appears when we run any process or service:

<process name>: error while loading shared libraries: <lib>.so: cannot enable executable stack as shared object requires: Permission denied

For example,

#./ifind -getmnt -all
./ifind: error while loading shared libraries: libCvOnTap.so: cannot enable executable stack as shared object requires: Permission denied

As a workaround, do the following steps:

  1. Check if ASL (Atomic Secured Linux) is configured on client.

    #uname –r
    2.6.32.59-17.art.i686.PAE

    .art indicates that ASL is configured on the client.
     
  2. Check for the presence of the below logs in /var/log/messages file.

    May 24 22:01:08 rhel6 kernel: Aborting core
    May 24 22:01:08 rhel6 kernel: PAX: execution attempt in: <anonymous mapping>, bfc46000-bfc5b000 bffeb000
    May 24 22:01:08 rhel6 kernel: PAX: terminating task: /usr/libexec/paxtest/mprotstack(mprotstack):13201, uid/euid: 0/0, PC: bfc5acf4, SP: bfc5acdc
    May 24 22:01:08 rhel6 kernel: PAX: bytes at PC: c3 1a a3 ae 2b ac 9f ae f4 0f 9f ae 00 00 00 00 f4 0f 9f ae
     
  3. Run the following command.

    chpax –ps ../iDataAgent/<process/service>

    E.g.:
    #chpax –ps /opt/calypso/iDataAgent/ifind

Priority of Calypso processes

By default, Calypso processes runs at default priority on the client computers. If there are available CPU cycles, then Calypso processes will use the available CPU for backup and restore operations. If the CPU is being used by other application or system processes, Calypso processes will not preempt them. In such cases, if you want to give higher priority to other application or system processes, which are running at the default priority, you can modify the priority of Calypso process using the following steps:
  1. From the CommCell Console, navigate to Client Computers.
  2. Right-click the <Client>, and then click Properties.
  3. Click the Registry Key Settings tab.
  4. Click Add.
  5. In the Name field, type dNICEVALUE.
  6. In the Location list, type Base.
  7. In the Type list, select Value.
  8. In the Value field, type <NICE value>.
  9. Click OK.
  Restart the services on the client after setting this key.

Excluding the Scan Phase of Non-Local Mount points

During default backups, the scan phase determines the size of all mount points even though they are not backed up by default. However, if some of the non-local mount points become unavailable, the scan phase stops processing. Use the following steps to skip the scan phase of all non-local mount points.
  1. From the CommCell Console, navigate to Client Computers.
  2. Right-click the <Client>, and then click Properties.
  3. Click the Registry Key Settings tab.
  4. Click Add.
  5. In the Name field, type sSkipNonLocalMountDetails.
  6. In the Location list, type FileSystemAgent.
  7. In the Type list, select Value.
  8. Click OK.

Completed with One or More Errors

By default the backup jobs from Macintosh File System iDataAgent complete without any error messages.

In the Scan phase files that cannot be accessed will be populated in scan_failures.cvf, in the following scenarios:

To view the "Completed w/ one or more errors" message in the Job History in the Scan phase, follow the steps given below:

  1. From the CommCell Console, navigate to Client Computers.
  2. Right-click the <Client> and click Properties.
  3. Click the Registry Key Settings tab.
  4. Click Add.
  5. In the Name field, type sReportScanCompleteWithError.
  6. In the Location field, type FileSystemAgent.
  7. In the Type list, select VALUE.
  8. In the Value field, type 'y' or 'Y' to enable the error message display or 'n' or 'N' to disable the error message display.
  9. Click OK.

During backups the jobs will be marked partial success and reported into Failures.cvf, in the following scenarios:

To view the "Completed w/ one or more errors" message in the Job History after a backup, follow the steps given below:

  1. From the CommCell Console, navigate to Client Computers.
  2. Right-click the <Client> and click Properties.
  3. Click the Registry Key Settings tab.
  4. Click Add.
  5. In the Name field, type sReportBackupCompleteWithError.
  6. In the Location field, type FileSystemAgent.
  7. In the Type list, select VALUE.
  8. In the Value field, type 'y' or 'Y' to enable the error message display or 'n' or 'N' to disable the error message display.
  9. Click OK.

Troubleshooting Performance Issues

If you are experiencing performance issues during backup, you can troubleshoot them by enabling logging of performance details in the log files. These performance counters contain information that help in resolving the performance related issues during backups.

The performance counters printed in the 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.

Displaying 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 <Client>, and then click Properties.
  3. Click the Registry Key Settings tab.
  4. Click Add.
  5. In the Name field, type clBackupChild_PERF.
  6. In the Location list, select or type EventManager.
  7. In the Type list, select Value.
  8. In the Value field, type Y.
  9. Click OK.

Displaying Performance Details for each File in a Backup Job

In addition to viewing the performance details for a backup job, you can also view the performance details of each file in the backup job. This enables you to identity the specific file causing the performance issues.

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 <Client>, and then click Properties.
  3. Click the Registry Key Settings tab.
  4. Click Add.
  5. In the Name field, type clBackupChild_PERF_FILE.
  6. In the Location list, select or type EventManager.
  7. In the Type list, select Value.
  8. In the Value field, type Y.
  9. Click OK.
      This key should be used in conjunction with the clBackupChild_PERF registry key.

Back to Top