Overview - OnePass for Macintosh File System

OnePass for Macintosh File System is a comprehensive solution incorporating the traditional backup and archiving processes in a single operation.

The data gets backed up only once as part of the backup operation and the files that meet the archiving rules are stubbed in place. Stubs point to the data that was already moved as part of the backup.

This integrated agent is able to selectively age items based on data and stubs that are deleted on the primary storage. This allows you to reclaim space in your secondary storage. It also provides data statistics and reporting functions.

Additionally, this agent also allows backup data statistics and analyze reporting function without having to revisit the primary storage again.

Comparison Chart

The following chart compares the traditional backup and the archiving agent with OnePass:

Key Features

OnePass for Macintosh File System

Macintosh File System iDataAgent

Data Backup

Data Archiving  
Secondary Storage Space Reclamation using Synthetic Full Backups
Stub Recall  
Stub Retention  
Data Restore

Key Features

OnePass for Macintosh File System offers the following key features:

Simplified Data Management

OnePass enables you to easily manage the backed up data in your environment, by providing pre-defined archiving rules.

Point-in-Time Recovery

In the event of a serious system failure, such as the breakdown of hardware, software, or operating systems, the solution provides a point-in-time recovery of files at any given time.

Recall Throttling

You can configure the stub recovery parameters, such that, you can set the maximum number of stubs in a recall job, time between recalls and time to wait after maximum successive recalls limit is reached.

Item Level Retention

You can now specify the time period for which you want to retain the deleted files in the backup cycle. This enables you to restore the deleted files from the latest backup cycle. This will be useful for the OnePass clients where you perform frequent incremental backups.

Recursive Recall

You can recall more than one stubbed file at a given time. For example, if there are nested folders you can recall all the stubs at the parent folder level.

What Is Archived

  • Hierarchical File System (HFS)
  • Hierarchical File System plus (HFS+)
Note: The file system should be mounted with extended attribute option for OnePass to function. If extended attribute is not enabled in the mount point, files will be backed up but will not be archived.

What Is Not Archived

The following file types/objects are automatically filtered out of archive operations by the system, and will not be archived.

  • Sparse files (Example: File Archiver stub files)
  • Install directory
  • Job Results directory
  • Log files directory
  • /usr system directory
  • /kernel system directory
  • /etc system directory
  • /tmp directory

Files with extensions *.a, *.ksh, *.csh, *.sh, *.lib, and *.so are automatically filtered out of subclient content by default. Similarly, files in the following directories are also skipped from archiving.

  • /usr/**
  • /bin/**
  • /lib/**
  • /boot/**
  • /dev/**
  • /etc/**
  • /var/**
  • /tmp/**
  • /sbin/**
  • /lib64/**
  • /opt/**
  • /sys/**
  • /kernel/**
  • /devices/**
  • /proc/**
  • /selinux/**
  • /stand/**

In addition to the above, there are also platform specific files that are automatically filtered from archiving.

  • Mac OS X - /**/*.dylib, /**/*.scpt, /Applications/**, /Developer/**, /Library/**, /Network/**, /System/**, /Volumes/**, /private/**


Migration Archiving

Migration archiving is a process of periodically moving unused or infrequently used data on a host computer to secondary storage, thereby reducing the size of data on the primary storage.


The stubbing phase starts after the archive phase succeeds. Stubs are placeholders of the original data after it has been moved to the secondary storage. Stubs replace the archived files in the location selected by the user during the archive. However, stubs will only be created if the subclient properties were configured to create them during archive.

Data Recovery

The archived and moved data can be recovered using the following methods:
  • Recovery of archived files per file paths provided using the CommCell Console.
  • Browse and Recovery of archived files using the CommCell Console.

Stub Recovery

If the subclient is configured to create stubs, you can perform a recall operation from any workstation for recovering the stubs. A recall is any action that causes an open and read to be executed on the stub, which automatically initiates a recovery operation.

Persistent Recovery

Multiple stub recoveries are submitted to the Job Controller as one job called a Persistent Recovery job. The job will wait for approximately 5 seconds in order to allow other stub recovery requests being submitted on the same client to be batched into the same job.