Additional Operations - Windows File System iDataAgent

Table of Contents

Audit Trail

Auxiliary Copy

Enabling Laptop Backup for a Desktop Client

Erasing Backup Data

Global Filters

License Administration

Online Help Links

Operating System and Application Upgrades

Operation Window

Schedule Policy

Storage Policy

Subclient Policy

Uninstalling Components

Advanced Topics

Audit Trail

The Audit Trail feature allows you to track the operations of users who have access to the CommCell. This capability is useful if a detrimental operation was performed in the CommCell and the source of that operation needs to be determined.

Audit Trail tracks operations according to four severity levels:

To set Audit Trail retention periods:

  1. From the Tools menu in the CommCell Console, click Control Panel, and then select Audit Trail.
  2. From the Audit Trail dialog box, select the desired retention time (in days) for each severity level.
  3. Click OK.

Auxiliary Copy

An auxiliary copy operation allows you to create secondary copies of data associated with data protection operations, independent of the original copy.

  1. Expand the Policies node, right-click storage policy for which you want to perform an auxiliary copy, click All Tasks, and then click Run Auxiliary Copy.
  2. If you are starting the auxiliary copy operation from the CommServe level, select the storage policy for which you wish to perform the auxiliary copy.
      If you are starting the auxiliary copy operation from the Storage Policy level, the Storage Policy field is already populated with the name of the Storage Policy you selected.
  3. If the source copy is configured with a shared library, select the Source MediaAgent for the auxiliary copy.
  4. Click OK to start the auxiliary copy operation. A progress bar displays the progress of the operation.

Enabling Laptop Backup for a Desktop Client

The Laptop Backup feature provides access to a webconsole which you can use to manage data protection and data recovery operations for a desktop client. Follow the steps given below to use the webconsole:

  1. Ensure that the File System iDataAgent is installed on a client computer.
  2. Open the Command prompt and navigate to the following location:

    Windows: <Software_Installation_Directory>\calypso\Base\

    Linux: /<install_path>/calypso/Base/

  3. Login to the CommServe using the qlogin command and commcell credentials.

    Windows: C:\Company\Software\Base\> qlogin -cs commserve_name -u user_name

    Linux or Macintosh: [root@localhost Base]# ./qlogin -cs commserve_name -u user_name

  4. Run the following execscript operation using qoperation:

    Usage:

    Windows:

    qoperation execscript -sn enableLaptopBackup -si ON -si <client name>

    Linux:

    ./qoperation execscript -sn enableLaptopBackup -si ON -si <client name>

    Where:

    <client>: Specify the client name for which you want to enable laptop backup.

    Example:

    Enable Laptop Backup for desktop client xyz.

    Windows: qoperation execscript -sn enableLaptopBackup -si ON -si xyz

    Linux: ./qoperation execscript -sn enableLaptopBackup -si ON -si xyz

  1. Navigate to following location:

    <Software_Installation_Directory>\calypso\Base\

  2. Run the Laptop2Taskbaricon.exe to launch the Backup Monitor.
  3. Click Web Console and enter CommCell credentials.
  4. Use the web console to manage data recovery and data protection operations for the desktop client. For more information about the operations which you can perform, refer to Restore -Laptop Users and Advanced Options - Laptop Users.

Disabling laptop Backup For a Desktop Client

Follow the steps given below to disable the Laptop Backup feature for a desktop client:

  1. Open the Command prompt and navigate to the following location:

    Windows: <Software_Installation_Directory>\Base\

    Linux or Macintosh: /<install_path>/calypso/Base/

  2. Login to the CommServe using the qlogin command and commcell credentials.

    Windows: C:\Company\Software\Base\> qlogin -cs commserve_name -u user_name

    Linux or Macintosh: [root@localhost Base]# ./qlogin -cs commserve_name -u user_name

  3. Run the following execscript operation using qoperation:

    Usage:

    Windows:

    qoperation execscript -sn enableLaptopBackup -si OFF -si <client name>

    Linux or Macintosh:

    ./qoperation execscript -sn enableLaptopBackup -si OFF -si <client name>

    Where:

    <client>: Specify the client name for which you want to enable laptop backup.

    Example:

    Disable Laptop Backup for desktop client xyz.

    Windows: qoperation execscript -sn enableLaptopBackup -si OFF -si xyz

    Linux or Macintosh: ./qoperation execscript -sn enableLaptopBackup -si OFF -si xyz

Erasing Backup Data

The Erase Data feature allows you to permanently erase any data that can be backed up. Using Erase Data, you can erase data such as file system, system state, and office communications server (OCS) data.

Configuring Erase Data

To erase data, you need to first assign a Filter Storage Policy for Erasing Data. Follow the steps given below to assign a Filter Storage Policy:

  1. From the CommCell Browser, right-click the storage policy that you want to use as a filter storage policy, then click Properties.
  2. From the General tab of the Storage Policy Properties dialog box, select the Allow Erase Data check box.
  3. Click OK.
  4. From the CommCell Browser, right-click the <Agent> and then click Properties.
  5. From the Storage Device tab of the agent Properties dialog box, select a filter storage policy from the Filter Storage Policy list.
  6. Click OK.

Running an Erase Data Job

After the configuration has been completed, you can now browse and erase data.

  1. From the CommCell Browser, right-click the <Agent>, select All Tasks and then click Erase Data By Browsing.
  2. You are warned that the data will be permanently removed. Click Yes to continue.
  3. From the Erase Data by Browsing dialog box, click Browse.
  4. In the Browse Options dialog box, select a browse time range and any advanced browse options, and click OK.
  5. From the browse selection window, select the data objects that you want to erase, and click OK.
  6. In the Job Initiation tab, select Immediate to run the job immediately.

    You can track the progress of the job from the Job Controller or Event Viewer.

Global Filters

Global Filters are exclusions that filter data from backups across all Agents in a CommCell that support the feature. Global Filters serve as a template for files, folders, and entities that should always be excluded from all (or most) backups in a CommCell, such as temporary data a computer does not retain or data that is recoverable by means other than a restore. This saves space on media and enhances backup performance.

By default, filters configured for a particular subclient override any Global Filters configured for the CommCell. You can, however, configure subclients to include global filters along with any filters already configured for the subclient.

Configure Global Filters

  1. From the CommCell Browser, right-click the CommServe, click Control Panel, and then click Global Filters.
  2. Select Use Global Filters on All Subclients.
  3. Click Browse to locate the files or folders to be excluded from backups and click OK.
  4. Click OK to save your changes.

Enable/Disable Global Filters for a Subclient

  1. From the CommCell Browser, right-click the subclient for which you want to enable Global Filters and click Properties.
  2. Click the Filters tab.
  3. Select one of the following values from the Include Global Filters list:
  4. Click OK.

License Administration

Required Licenses

Following licenses are required to perform data protection and recovery operations using this agent:

Operations

Licenses

Backup and Recovery of the Windows File System data iDataAgent for Windows Server Class File System

iDataAgent for Windows Desktop Class File System

1-Touch Backup and Recovery 1-Touch Server for MS Windows
Archive and Recovery of the Windows File System data Data Archiver for Files - MS Windows
Desktop Browse Web Search Server

Converting Evaluation Licenses to Permanent Licenses

If you installed the software using an Evaluation License, you can upgrade to a Permanent License as follows:

  1. From the CommCell Browser, right-click the CommServe icon, click Control Panel, and then click License Administration.
  2. Select the Update License tab and then click Convert.
  3. Check the box that corresponds to the evaluation license you would like to upgrade and then click Convert.

The license information is updated in the License Administration window.

Using Capacity-Based Licensing

License Usage by Capacity is a licensing mechanism that allows you to obtain licenses based on the amount of data you back up. It provides the following features:

Both Core and Enterprise license types are available. Refer to License Usage by Capacity for comprehensive information on utilizing this method.

Releasing a License

If you no longer require a license on a computer, such as cases where the computer is being retired, you can release the license and use it later for another computer. Backup data from the retired computer can still be restored after the license is released provided the data is not aged.

  1. From the CommCell Browser, right-click the name of the client from which you want to release a license, click All Tasks, and then click Release License for Client.
  2. Click OK to continue releasing the license
  3. Click Yes to confirm you want to release the license or No to abort.

Online Help Links

Use the following links to view the online help for the corresponding tabs in the CommCell Console:

Operations

Entity

Online Help Links

Sub Links

Configuration

Agent Windows File System Properties (General)

Windows File System Properties (Version)

Windows File System Properties (Index)

Windows File System Properties (Security)

Windows File System Properties (Activity Control)

 
  Subclient Windows File System Subclient Properties (General)

Windows File System Subclient Properties (Content)

Windows File System Subclient Properties (Filters)

Windows File System Subclient Properties (Pre/Post Process)

Windows File System Subclient Properties (Encryption)

Windows File System Subclient Properties (Storage Device)

Windows File System Subclient Properties (SnapProtect Operations)

Windows File System Subclient Properties (Activity Control)

Windows File System Subclient Properties (Open Files Failure Actions)

Windows File System Subclient Properties (SRM Options)

 

 

 

BackupSet Windows File System BackupSet (General)

Windows File System BackupSet (Security)

 

Backup

Backup Options Windows File System Backup Options Advanced Backup Options

Save As Script

Command Line XML Options

  Advanced Backup Options Windows File System Advanced Backup Options (Data)

Windows File System Advanced Backup Options (Startup)

Windows File System Advanced Backup Options (Job Retry)

Windows File System Advanced Backup Options (Media)

Windows File System Advanced Backup Options (Data Path)

Windows File System Advanced Backup Options (VaultTracking)

Windows File System Advanced Backup Options (Alert)
 

Restore

Restore Options Windows File System Restore Options Save As Script

 

  Advanced Restore Options Windows File System Advanced Restore Options (General)

Windows File System Advanced Restore Options (Startup)

Windows File System Advanced Restore Options (Pre/Post)

Windows File System Advanced Restore Options (Copy Precedence)

Windows File System Advanced Restore Options (Data Path)

Windows File System Advanced Restore Options (Paths/Filters)

Windows File System Advanced Restore Options (Encryption)

Windows File System Advanced Restore Options (Job Retry)

Windows File System Advanced Restore Options (Map)

Windows File System Advanced Restore Options (Browse Options)

Windows File System Advanced Restore Options (Alert)

 
Operation Window Operation Window Windows File System Operation Window  

Operating System and Application Upgrades

Operating system upgrades are only supported when upgrading from one version of an OS to a different version of the same OS (e.g., Win2003 to Win2008). The two methods of upgrading are:

For Full OS Replacement, the client computer must be configured to have the CommServe, MediaAgent, and/or Client software re-installed to the same location, the same Fully Qualified Domain Name or short domain name, the same partitions, disk drive format (FAT, NTFS, et. al.), and IP configuration as previously.

  If it is necessary to remove Agent software to facilitate an operating system or application upgrade, do not delete the icon for the Agent from the CommCell Console, or all associated backed up data will be lost.

Use the following strategy to upgrade the operating system software:

 

Operation Window

By default, all operations in the CommCell can run for 24 hours. To prevent certain operations from running during certain periods of the day, you can define operation rules so that these operations are disabled during those times.

When operation rules are configured, operations that are started within the time window specified will go to a queued (as opposed to pending) state. Once the time window specified in the operation rule has elapsed, these queued or running operations will resume automatically.

  1. In the CommCell Browser, right-click the appropriate entity, click All Tasks, and then click Operation Window.
  2. Click Add.
  3. From the Operation Window dialog box:
  4. Click OK.

Schedule Policy

An agent specific data protection schedule policy can be used as a scheduling template for data protection operations for Backup iDataAgents in a CommCell.

This type of data protection policy is useful when there are many clients or subclients within the CommCell that require same schedules for specific data protection operations. Additionally this policy provides the ability to granularly define advanced data protection options specific to the Backup iDataAgents.

Use the steps given below to create a data protection schedule policy:

  1. From the CommCell Browser, navigate to Policies.
  2. Right-click Schedule Policies and click Add.
  3. Type a name for the schedule policy in the Name field.
  4. From the Agent Type list, expand Files | Protected Files and select the specific agent.
  5. Type an appropriate description in the Description field.
  6. Click the Add button.
  7. Type a name in the Schedule Name box.
  8. Select the appropriate scheduling options.
  9. Type the Start Time to start the schedule.
  10. Click the Backup Options tab and click Incremental.
  11. Optionally, click the Advanced button to define advanced backup options for the agents.
  12. Click Ok.
  1. Click the Associations tab.
  2. Click and select the Client Computers that you wish to associate with the schedule policy.

    Note that you can associate the schedule policy from the client, backup set and subclient level as well.

  3. Click Ok.

 

 

Storage Policy

A Storage policy defines the data lifecycle management rules for protected data. Storage policies map data from its original location to a physical storage media and determine its retention period.

  1. Expand the Policies node, right-click Storage Policies, and select New Storage Policy.
  2. Click Next.
  3. Select Data Protection and Archiving to create a regular storage policy or CommServe Disaster Recovery Backup to backup the CommServe database and click Next.
  4. Click Next.
  5. Enter the name of storage policy and click Next.
  6. Enter the name of the primary copy and click Next.
  7. From the drop down box, select the default library for the primary copy and click Next.
  8. From the drop down box, select the MediaAgent and click Next.
  9. Enter number of data streams and set the retention period for the policy and click Next.
  10. Click Next.
  11. Click Browse, browse to your designated deduplication store location and click Next.
  12. Confirm your selections and click Finish.

Subclient Policy

Subclient policies allow you to configure multiple subclients within a CommCell from a centralized template. This alleviates the need to manually configure each subclient that shares a similar configuration.

  1. Expand the Policies node, right-click Subclient Policies and click New Subclient Policy.
  2. Enter policy name in the Name entry field, then select the appropriate file system type from the iDataAgent drop-down list.
  3. In the Subclient pane, assign a storage policy for each subclient template by clicking in the drop down box under the Storage Policy column.
  4. Click OK.

Uninstalling Components

You can uninstall the components using one of the following method:

 

Method 1: Uninstall Components Using the CommCell Console

Method 2: Uninstall Components from Add or Remove Programs

Method 1: Uninstall Components Using the CommCell Console

  1. From the CommCell Browser, right-click the desired Client Computer and click All Tasks -> Add/Remove Programs and click Uninstall Software.
  2. Uninstall Software Options dialog will appear.
  3. In the Uninstall Software tab, select Uninstall All to uninstall all the software packages.
  4. In the Job Initiation tab, select Immediate to run the job immediately.

    You can track the progress of the job from the Job Controller or Event Viewer.

Method 2: Uninstall Components from Add or Remove Programs

  1. Click the Start button on the Windows task bar and then click Control Panel.
  2. Double-click Add/Remove Programs.

    For Windows Vista/Windows 2008, click Uninstall a Program in the Control Panel.

  3. Click Remove to uninstall the components in the following sequence:
    1. <Agent>
    2. File System iDataAgent
    3. Base Software

 

Advanced Topics

Provides comprehensive information about additional capabilities for the following features:

Provides comprehensive information about additional capabilities for the following features:

Back to Top