V11 SP8

Overview - OnePass for Windows File System

Note: If you are transitioning from the NetApp File Archiver Agent, see Transitioning From Traditional Archiver to OnePass .

The OnePass feature for Windows File Systems is a comprehensive solution incorporating the 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 with OnePass for Windows File System iDataAgent:

Key Features

OnePass for Windows

Windows File System iDataAgent

Classic Archiver for Windows

Data Backup


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

How OnePass Works with Windows Data Deduplication

If your backup content consists of a volume where the Windows data deduplication feature is enabled, you will see the following behavior:

  • The file is backed up every time a change is made to the file and the file is deduped later. However, synthetic full backups consolidate the data.
  • Deduped files are backed up but not archived (stubbed).
  • Files that are not deduplicated are archived.
  • Files that are already archived using OnePass are not affected by the windows data deduplication feature.
  • You must use the recursive scan method for backups. If you have selected the Check archive bit check box, the deduplicated files are backed up again even though there was no change in the file. Clearing the Check archive bit option prevents the same version of the file from being backed up again.

Key Features

OnePass for Windows 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 following stub recovery parameters:

  • Maximum Number of Stubs in a Recall Job
  • Time between recalls
  • 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.

What Is Archived

  • Local Volumes
  • Local Files and Folders
  • Mount points to volumes
  • Windows 8/ Windows 2012 on ReFS volumes
  • Non-deduplicated data that resides on a Windows deduped volume
  • Compressed Files
  • Microsoft Non-Content Indexed and Content Indexed files
  • Data that resides on Cluster Shared Volume File System for Windows 2012 and Windows 2012 R2 computers.

    Recursive Scan method is used to back up and archive the data on the Cluster Shared Volume File System.

What Is Not Archived

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

  • Install folder
  • Job Results folder
  • Index cache folder
  • Log files folder
  • Windows system32 folder
  • Unix data residing on a Windows NFS share
  • Files with attributes of encrypted or sparse
  • Files with attributes of hidden and system
  • Files that are deduped by Microsoft
  • Files with certain extended attributes such as Offline, Encryption, and Sparse files.

Files Excluded from Archiving (Stubbing)

  • *.dll
  • *.bat
  • *.exe
  • *.cur
  • *.ico
  • *.lnk

Supported Protocols

  • Server Message Block (SMB) 1.0 protocol
  • SMB 2.x protocol
  • SMB 3.xx protocol



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.


Stubs are placeholders of the original data after it has been migrated 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  data can be recovered in any of the following three methods:
  • Recovery of archived files per file paths provided using the CommCell Console.
  • Browse and Recovery of archived files using the CommCell Console.
  • Recall of archived files from stubs using third-party applications like: Windows Terminal or Console window.

Stub Recovery

If the subclient is configured to create stubs, you can perform a recall operation from a Windows 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.