V11 Service Pack 11

OnePass for Hitachi NAS (BlueArc) and Isilon Overview

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

OnePass is a comprehensive solution that performs the backup and archiving processes in a single operation. It enables you to move data to secondary storage, and use it to function as both backup and archive copies.

Stubs that point to the data that was moved as part of the backup process are retained on the primary storage. Archived data is available for quick and easy retrieval.

The proxy computer that initiates recall operations uses a Common Internet File System (CIFS) connection to access the data residing on the file server. For more information on backup and archive operations for CIFS shares, see Data Protection for NFS Shares, CIFS Shares, and UNC Paths.

This integrated agent can selectively age-off items based on data and stubs being deleted on the primary storage. This allows you to reclaim space in your secondary storage.

Key Features

Simplified Data Management

A single backup job will not only back up the data but will also archive it to a less-expensive secondary storage medium based on 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 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 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 is useful for the OnePass clients where you perform frequent incremental backups.

Secondary Storage Space Reclamation

Archived data is pruned, and secondary storage space is reclaimed, based on the stub retention setting and the storage policy cycle-based retention criteria.

Comparison Chart

Below is a basic chart comparing the OnePass with the BlueArc Archiver and NAS agent:

Key Features

BlueArc Archiver/Generic File Archiver for NAS

NAS iDataAgent

OnePass for Hitachi NAS (BlueArc)  and Isilon

Data Backup


Space saving on File Server


Secondary Storage Space Reclamation using Synthetic Full Backups


Stub Recall


Stub Retention


Data Restore

What Is Archived

OnePass archives the files on the file server.

The subclient filter does not filter the MediaAgent disk library mount paths from the subclient content. Therefore, you must specify the volumes that contain disk library mount paths for subclient filter. Otherwise, the entire disk library will be archived.

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
  • Alias mount points to drive letter volumes*
  • Unix data residing on a Windows NFS share
  • Files with attributes of encrypted or sparse
  • Files with attributes of hidden and system

Files Excluded from Archiving (Stubbing)

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

Supported Protocol

Server Message Block (SMB) 1.0 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.


Follow the steps given below to transition from using the traditional File Archiver Agent to OnePass for Hitachi NAS (BlueArc) file server.

  1. Upgrade the File Archiver Agent. For instructions, see Upgrading Clients.
  2. Skip this step if you already have the File System Agent installed.

    Install the Windows File System Agent. You can use the installation methods listed in Installing Commvault on Clients.

  3. Disable archiving on the Archiver Agent or on specific subclient.
    • You can disable the activity at the subclient level using the following steps:
      1. From the CommCell Console, navigate to Client Computers | <Client> | File Archiver | <ArchiveSet>.
      2. Right-click the default subclient and then click Properties.

      3. Click the Activity Control tab and clear the Enable Archive check box.
      4. Click OK. This will freeze/ stop the all the activities on the Archiver agent.

    • You can disable the activity on the Archiver Agent by following the steps given below:
      1. From the CommCell Console, navigate to Client Computers | <Client> | File Archiver.
      2. Right-click the File Archiver Agent and point to Properties.
      3. Click Activity Control tab and make sure Enable Archiving option is not selected.

        Once the archiving has been disabled, do not delete the archive set / agent. This will allow for the recovery of archived data. Do not delete the Storage Policy associated with the Archiver subclient as the Stub Recall and Browse and Restore operations will be still using the data from this Storage Policy.

  4. From the CommCell Console navigate to Client Computers.

    Right-click Client Computers, point to New Client | File System and click NAS.

  5. In the NDMP Server Hostname box enter the fully qualified Hitachi NAS (BlueArc) file server name.

    In the NDMP Login and NDMP Password boxes enter the Hitachi NAS (BlueArc) file server NDMP login credentials.

    Click the Detect button.

    Once the Supported Features list is populated Click OK.

    A NAS client is created.

  6. Right-click the NAS client, point to All Tasks and click Add Network Share Backup.

  7. Right-click the newly added File System iDataAgent and point to Properties.

    In the General tab, verify that Enable for Archiving is selected.

    The default subclient has the root directory as the subclient content. Therefore, an archive job run on the default subclient will result in backing up and archiving the entire file server.

    It is recommended to run the first backup and archive of selective data files by creating a user defined subclient with specific content.

  8. Create OnePass subclients:

    Depending on the requirement, you can either create a subclient for each of the Archiver subclients or combine related Archiver subclients and create a consolidated OnePass subclient. All the existing user-defined filters should be added to the OnePass subclients separately.

    • Right-click the <BackupSet> and select All Tasks.
    • Click New Subclient.
    • Enter Subclient Name.
    • Make sure that you select the upgraded client as the Proxy Client.
    • Click the Content tab.

      Browse to the folder that has the data to be backed up and click Add.

      Click Close.

    • Click the Storage Device tab.

      In the Storage Policy box, select the storage policy.

      Click OK.

  9. Run backup:

    The first backup job will be a full backup and backs up all the data and stubs.

    Only the new and recalled data will be backed up and archived.

    For the existing stubs (stubs created from the Archiver agent), only the stubs are backed up and not the corresponding data. If data has to be backed up, you need to recall the stubs and re-run backup. 

    • Right click the <Subclient> and click Backup.
    • Select Incremental as backup type and Immediate to run the job immediately.
    • Click OK.

  10. Dissociate the Data Protection schedules from the traditional Archiver Agents and associate them with the OnePass as follows:
    • From the CommCell Browser, navigate to Policies | Schedule Policies, right-click the <SchedulePolicy> and click Edit.
    • Select the Associations tab and click Edit.
    • Clear the selection with Traditional Archiver Agent and select the OnePass.
    • Click OK.

  11. The transition from File Archiver to OnePass for Hitachi NAS (BlueArc) file server is now complete.

    Note that recalls for the existing stubs will still be processed by the Archiver agent. Browse and Restore from the ArchiveSet will still be applicable.

Last modified: 7/3/2018 9:10:18 PM