Subclients - Windows/Unix/Macintosh File Systems and Microsoft Data Protection Manager iDataAgents - How To

Topics | How To | Related Topics


Common

Add/Edit a Data Protection Filter for a Subclient

Associate a Subclient to a Storage Policy

Associate or Disassociate a User Group to a Subclient

Configure a Subclient for Pre/Post Processing of Data Protection Operations

Configure Subclient Content

Configure the Subclient for Data Encryption

Create a New Subclient

Create a New Subclient Policy

Delete a Data Protection Filter from a Subclient

Delete a User-Defined Subclient

Disable Global Filters on a Subclient

Enable Global Filters on a Subclient

Enable or Disable Data Protection Operations

Enable Software Compression for a Subclient

Remove a Process from Pre/Post Processing of Data Protection Operations

Rename a Subclient

Set the Network Bandwidth and Network Agents for a Data Protection Operation

View Data Paths

View Subclient Content

AIX, Linux, Solaris File Systems

Configure the Subclient for 1-Touch

Enable QSnap on a Subclient

Windows File Systems and Microsoft Data Protection Manager

Change Account for Executing Pre/Post Commands (Data Protection)

Windows File Systems (only)

Change Account for Configuring UNC Paths

Enable QSnap on a Subclient

Enable VSS on a Subclient (for the Windows iDataAgents that support VSS)

Enter UNC Path as Subclient Content


Add/Edit a Data Protection Filter for a Subclient

Before You Begin

Select the desired procedure:

Required CapabilityCapabilities and Permitted Actions

wedge.gif (136 bytes)To add a data protection or discovery filter entry for a subclient:

  1. From the CommCell Browser, right-click the subclient whose data protection or discovery filter you want to add, and then click Properties from the shortcut menu.
  2. Click the Filters tab of the Subclient Properties dialog box.
  3. For Exchange Mailbox, Exchange Mailbox/Public Folder Archiver Agents and Exchange Compliance Archiver, to specify a mailbox or folder that you want to exclude from data protection operations:
  4. For NAS NDMP iDataAgents, click the Add button and, in the input window, type the name of the file, directory, (or path for BlueArc) that you want to exclude from the backups and click OK. The name displays as an entry in the Exclude these files/folders/patterns pane. Repeat this step if you want to add more files, directories, or paths to the filter.
  5. For Exchange Public/Web Folder iDataAgents and SharePoint Server iDataAgent, to specify a workspace/folder that you want to exclude from the backups, click the upper Browse button and expand the iDataAgent of the client computer.  Click the workspace/folder that you want to exclude from the backups and then click Add. Repeat this step for each additional entry.
  6. For Windows/Unix/Macintosh File System iDataAgents, File Archiver for Windows/Unix Agents, and ProxyHost iDataAgent, to specify a file/folder/directory that you want to exclude from data protection operations, do one of the following:
  7. For NetWare File System/NDS iDataAgents, to specify data that you want excluded from the backups, do one of the following:
  8. For Lotus Notes Database and Lotus Notes Document iDataAgents, to specify a file or folder that you want to exclude from discovery, do one of the following:
  9. For Exchange Mailbox, Exchange Mailbox/Public Folder Archiver Agents and Exchange Compliance Archiver, to specify a wildcard pattern of the folders that you want to exclude across all mailboxes within the subclient:
  10. For Exchange Public/Web Folder iDataAgents and SharePoint Server iDataAgent, to specify an exception to an excluded workspace/folder (i.e., a folder/document that you want included in the backups, but whose parent directory has been excluded), click the lower Browse button and expand the iDataAgent of the client computer. Click the workspace/folder that you want to include in the backups and then click Add.  Repeat this step for each additional entry.
  11. For Windows/Unix/Macintosh File System iDataAgents, File Archiver for Windows/Unix Agents, and ProxyHost iDataAgent, to specify an exception to an excluded folder/directory (i.e., a file or folder/directory that you want included in the data protection operations, but whose parent folder/directory has been excluded), do one of the following:
  12. For NetWare File System/NDS iDataAgents, to specify an exception to an excluded directory or NDS container (i.e., data that you want included in the backups, but whose parent directory or NDS container has been excluded), do one of the following:
  13. Click OK to save your changes.

 

Required CapabilityCapabilities and Permitted Actions

wedge.gif (136 bytes)To edit a data protection filter entry for a subclient:

  1. From the CommCell Browser, right-click the subclient whose data protection filter you want to edit, and then click Properties from the shortcut menu.
  2. Click the Filters tab of the Subclient Properties dialog box.
  3. Click the filter entry that you want to edit, and then click the Edit button associated with that pane.
  4. Type the changes into the Enter Path dialog box, then click OK.
  5. Click OK to save your changes.

NOTES


Associate a Subclient to a Storage Policy

Required Capability: See Capabilities and Permitted Actions

To associate a subclient to a storage policy:

  1. From the CommCell Browser, right-click the subclient whose associated storage policy you want to change, then click Properties from the shortcut menu.
  2. Click the Storage Device tab of the Subclient Properties dialog box.
  3. From the Storage Policy list of the Data Storage Policy tab, select a data storage policy to associate with this subclient. If necessary, click the Create Storage Policy button to create a new storage policy to which the subclient can then be associated.
  4. From the Changing a Storage Policy window select the next type of backup operation. Click OK.
  5. If applicable for your agent, you can change the number of data streams from the Number of Data/Database Backup Streams field.
  6. If applicable for your agent, click the Log Storage Policy tab and select a storage policy to associate with this transaction log subclient from the Transaction Log Storage Policy list. Also, you can set the Number of Transaction Log Backup Streams from this tab.
  7. Click OK to save your changes and close the Subclient Properties Storage Device tab.

Associate or Disassociate a User Group to a CommCell Object

Required Capability: See Capabilities and Permitted Actions

To associate or disassociate a user group to a CommCell entity:

  1. From the CommCell Browser, click the CommServe, client computer group, client computer, agent, MediaAgent, Library, Storage Policy, backup set, subclient, or Shelf media, and then select Properties.
  2. From the Security tab, select the appropriate user groups to which you want to associate to the CommCell object from the Available Groups pane, and then move the user group to the Associated Groups pane.
  3. Click OK.

Configure a Subclient for Pre/Post Processing of Data Protection/Archive Operations

Before You Begin

Required Capability: Capabilities and Permitted Actions

To configure a subclient for Pre/Post processing of data protection/archive operations:

  1. From the CommCell Browser, right-click the subclient for which you want to configure a pre/post process, and then click Properties from the shortcut menu.
  2. Click the Pre/Post Process tab of the Properties dialog box.
  3. For an agent other than the Oracle RAC iDataAgent, click inside the space that corresponds to one of the following phases and type the full path of the process that you want executed during that phase. Alternatively, click Browse to locate the process (applicable only for paths that do not contain any spaces). For the Oracle RAC iDataAgent, click Browse for the corresponding process, click the name of the control node client in the Select Client for Browse dialog box, and click OK. Then browse for and click the process.

    Click OK.

  4. If you want to run a Post Process for all attempts to run that job phase, then select the corresponding checkbox.
  5. For subclients on Windows platforms, if Run As displays Not Selected, or if you want to change the account that has permission to run these commands, click Change.
    1. In the User Account dialog box, select Use Local System Account, or select Impersonate User and enter a user name and password. Click OK.
    2. If you selected Local System Account, click OK to the message advising you that commands using this account have rights to access all data on the client computer.
  6. Click OK to save your changes and close the Pre/Post Process tab of the Properties dialog box.

Configure Subclient Content

Before You Begin

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To configure subclient content:

  1. From the CommCell Browser, right-click the subclient for which you want to configure content, click All Tasks (if applicable) and then click Properties.
  2. Follow the procedure below that is applicable for your agent:
  3. Click OK to save your content configuration.

NOTES


Configure the Subclient for Data Encryption

Encryption settings made at the subclient level are for data protection and recovery operations run from the CommCell Console and are not related in any way to settings made at the instance level which is for third-party Command Line operations only.

See Data Encryption - Support for a list of supported products.

Before You Begin

Required Capability: Capabilities and Permitted Actions

To configure the subclient for data encryption:

  1. From the CommCell Console, right-click the subclient and click Properties.
  2. From the Subclient Properties (Encryption) tab, select an option based on the criteria described in the Encryption tab help.
  3. Click OK to save your settings and close subclient properties.

Create a New Subclient

Before You Begin

Required Capability: See Capabilities and Permitted Actions

To create a new subclient:

  1. From the CommCell Browser, right-click the node (agent/backup set/archive set/instance) for which you want to create a new subclient, click All Tasks (if applicable), and then simply click New Subclient for most agents.
  2. Click the General tab or General (Quick Recovery Agent) tab of the Subclient Properties dialog box and type the name (up to 32 characters) of the subclient that you want to create.
  3. Select other options from the General tab as appropriate for the agent.
  4. Click the Content or Databases tab of the Subclient Properties dialog box and Configure Subclient Content as appropriate for your agent.
  5. For all agents (except QR), click the Storage Device (Data Storage Policy) tab of the Subclient Properties dialog box, then select a data storage policy to associate with this subclient from the storage policy list.
  6. For Oracle and DB2 iDataAgents, click the Backup Arguments (Oracle) or Backup Arguments (DB2, DB2 DPF) tab of the Subclient Properties dialog box and Configure Backup Arguments as appropriate for your agent. Note that the backup arguments for Informix are located on the Content tab.
  7. For Migration Archiver Agents, click the Archiving Rules or Rules tab of the Subclient Properties dialog box and configure archiving rules as appropriate for your agent. In order to perform rules-based migration archiving operations, the Disable All Rules checkbox must be cleared.

    If the File Archiver for Windows supports Data Classification, several filter-like configuration fields are defined as archiving rules and are available from the Subclient Properties (Rules) tab. If you want to define content and archiving rules based on file attributes other than volumes, size, and modified time (i.e., if you want to customize your rules), click the Advanced tab and configure as appropriate. Also, stub management options can be configured from the Stub Rule tab. See Configure Archiving Rules - File Archiver Agents for step-by-step instructions.

  8. For ProxyHost and Image Level ProxyHost iDataAgents, click the Pre/Post Process tab of the Subclient Properties dialog box. In the PreScan field, type the path to the batch file/shell script file that contains those commands that are to run before each backup of the subclient, or click Browse to locate and select this file. For ProxyHost and Image Level ProxyHost, the file must reside on the backup host or primary host.
  9. Optionally (if supported for your agent) you can:
  10. Click OK to save the subclient configuration. For QR Agents, this procedure is now complete. For all other agents, continue on to the next step.
  11. The Backup Schedule dialog box advises you to schedule data protection operations for your new subclient. It is recommended you elect to set a schedule now. You can also associate this subclient with an All Agent Types schedule policy (which is automatically created by the system, or can be a user defined Data Protection schedule policy). If you have already associated a schedule policy at a previous level (Backup Set/Instance, Agent, Client, or Client Computer Group) the schedules defined in the Schedule Policy will be automatically applied to the new subclient. See Schedule Policy for more information.

This task is now complete.


Create a New Subclient Policy

Before You Begin

Required Capability: See Capabilities and Permitted Actions

To create a new Subclient Policy:

  1. From the CommCell Browser, expand the Policies node then right-click the Subclient Policies node and click New Subclient Policy. The Create New Subclient Policy dialog box will display.
  2. From the Create New Subclient Policy (General) tab of the Create New Subclient Policy dialog box, enter a name for your subclient policy in the Name entry field, then select the appropriate file system type from the iDataAgent drop-down list. The display pane will show one or more subclient templates listed for your policy.
  3. From the display pane of the Create New Subclient Policy (General) tab, assign a Storage Policy for each subclient template by clicking in the Storage Policy column and selecting one from the list.
  4. If you wish to set up a Regular user-defined type of Subclient Policy Subclient, then click Add. The Create New Subclient dialog box will display that will allow you to enter the following information:

    Once you have entered all of your configuration for the Regular user-defined subclient type, click OK to save your changes.

  5. If you wish to further define the configuration settings, or enter a different name for the Default Subclient, you can do so by selecting the desired subclient type in the display pane and then clicking Edit. Refer to Step 4 above for entering specific information on each of the subclient property tabs.
    If you want to preserve the characteristic behavior of the Default subclient to back up all content on the client that is not assigned to other subclients within the backup set, then we recommend leaving the default setting on the Content tab (which is "\" or "/" depending on your file system type).
  6. Click the Association tab of the Create New Subclient Policy dialog box.
  7. From the Association tab, expand the tree nodes and select the desired backup set checkbox(es) for file system clients that you want to be associated to this Subclient Policy.
  8. Click OK to save the new Subclient Policy, then press F5 to refresh and update the CommCell Console.

Delete a Data Protection Filter from a Subclient

Before You Begin

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To delete a data protection or discovery filter entry from a subclient:

  1. From the CommCell Browser, right-click the subclient whose data protection or discovery filter you want to delete, and then click Properties from the shortcut menu.
  2. Click the Filters tab of the Subclient Properties dialog box.
  3. To delete an entry from the Exclusions list, click the entry in the upper pane then click the upper Delete button. (Repeat this step for each entry that you want to delete.)
  4. To delete an entry from the Exceptions list (if applicable for your agent), click the entry in the lower pane then click the lower Delete button. (Repeat this step for each entry that you want to delete.)
  5. Click OK to save your changes.

NOTES


Delete a User-Defined Subclient

Related Topics:

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To delete a user-defined subclient:

  1. From the CommCell Browser, right-click the user-defined subclient that you want to delete, and then click Delete from the shortcut menu.
  2. A confirmation message is displayed, asking if you want to delete the subclient.
    Click No to cancel the deletion and retain the subclient, or click Yes to continue the deletion. If you click Yes:

Disable Global Filters on a Subclient

Before You Begin

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To disable the Global Filter on a subclient:

  1. From the CommCell Browser, right-click the subclient whose Global Filter you want to disable, and then click Properties from the shortcut menu.
  2. Click the Filters tab of the Subclient Properties dialog box.
  3. To disable Global Filters on this subclient, select one of the following values from the Include Global Filters list:
  4. Click OK to save your changes.

Enable Global Filters on a Subclient

Before You Begin

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To enable the Global Filter on a subclient:

  1. From the CommCell Browser, right-click the subclient whose Global Filter you want to enable, and then click Properties from the shortcut menu.
  2. Click the Filters tab of the Subclient Properties dialog box.
  3. To enable Global Filters on this subclient, select one of the following values from the Include Global Filters list:
  4. Click OK to save your changes.

Enable or Disable Operations

Required Capability: See Capabilities and Permitted Actions

Level Capability
CommCell Administrative Management with CommCell level association
Client Computer Group Administrative Management with Client Computer Group level association
Client Agent Management with Client level association
Agent Agent Management with Agent level association
Subclient Agent Management with Subclient level association

To enable or disable activity control at the CommCell, client computer group, client, agent, or subclient levels:

  1. From the CommCell Browser, right-click the CommServe, client computer group, client computer, agent, or subclient, and then click Properties from the short-cut menu.
  2. From the Activity Control tab of the associated Properties dialog box, select or clear option(s), as desired.
  3. Click OK.
note.gif (292 bytes) Disabled data management and/or data recovery operations are displayed with client and/or agent icon changes in the CommCell Browser. For a comprehensive list of all icons in the CommCell Console, see CommCell Console Icons.

Enable or Disable Software Compression for a Subclient

Before you Begin

Required Capability: Capabilities and Permitted Actions

To enable software compression for a subclient:

  1. From the CommCell Browser, right-click the subclient for which you wish to enable software compression and then click Properties.
  2. Click the Storage Device tab and from the Data Storage Policy tab, select the storage policy from the Storage Policy list.

    If applicable for the selected agent, click the Log Storage Policy tab and select a storage policy from the Transaction Log Storage Policy list.

  3. Then click the Storage Device (Data Transfer Option) tab and choose the appropriate compression option for this subclient.
  4. Click OK to save your changes.

This task is now complete.


Remove a Process from Pre/Post Processing of Data Protection/Archive Operations

Before You Begin

Required Capability: Capabilities and Permitted Actions

To remove a process from Pre/Post processing of data protection/archive operations:

  1. From the CommCell Browser, right-click the subclient for which you want to remove a pre/post process, and then click Properties from the shortcut menu.
  2. Click the Pre/Post Process tab of the Subclient Properties dialog box.
  3. Click the text inside the space that corresponds to one of the following phases for which you want a pre/post process removed, then press the Delete key:
  4. Repeat Step 3 for any additional processes that you want to remove.
  5. Click OK.

Rename a Subclient

Before You Begin

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To rename a subclient:

  1. From the CommCell Browser, right-click the subclient that you want to rename, and then click Properties from the shortcut menu.
  2. From the Subclient Properties (General) tab, or the QR Agent Subclient Properties (General) tab, type the new name in the Subclient Name field, and then click OK.

The CommCell Browser updates the subclient with its new name. The new name will also be reflected in any associated schedules and reports.


Set the Network Bandwidth and Network Agents for a Data Protection Operation

Before you Begin

Required Capability: Capabilities and Permitted Actions

To Set the Network Bandwidth and Network Agents for a Data Protection Operation:

  1. From the CommCell Browser, right-click a subclient and then click Properties.

    For the DB2, DB2 DPF, Informix, Oracle, Oracle RAC, SAP, or Sybase iDataAgent, right-click an instance and then click Properties.

  2. Click the Storage Device Data Transfer Option tab.

    For the QR Agent:

  3. Enter a number of Network Agents that must be used to perform data protection operations on the subclient/instance.
  4. Click the Throttle Network Bandwidth (MB/HR) option and then enter the throughput as needed. Note that throttling is done on a per Network Agent basis.
  5. Click OK to save the changes.

This task is now complete.


View Data Paths Associated with a Subclient

Required Capability: See Capabilities and Permitted Actions

To view data paths:

  1. From the CommCell Browser, right-click the subclient whose data paths you want to view, then click Properties from the shortcut menu.
  2. Click the Storage Device tab of the Subclient Properties dialog box.
  3. From the Data [or Logs] Storage Policy tab, click Show Data Paths to view the data paths used by the subclient to access the storage media for data protection operations. Click Close to exit the Data Paths dialog box.
  4. Click OK to exit the Subclient Properties Storage Device tab.

View Subclient Content

Required Capability: See Capabilities and Permitted Actions

To view content of a subclient:

  1. From the CommCell Browser, right-click the subclient whose content you want to view, then click Properties.
  2. From the Subclient Properties dialog box, click the Content tab (or Databases tab for Lotus Notes) to view the contents of the subclient.
  3. Click OK to close the dialog box.

Configure the Subclient for 1-Touch

Related Topics:

Before You Begin

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To configure the subclient for 1-Touch:

  1. From the CommCell Browser, right-click the appropriate (usually the default) subclient and then click Properties from the shortcut menu.
  2. From the Subclient Properties (1-Touch Recovery) tab, click 1-Touch Recovery.
  3. From the same tab, accept or select the name of the 1-Touch server in the 1-Touch server field. Also, accept or type the path to the 1-Touch server directory in the 1-Touch server directory field.
  4. Click OK.

Change Account for Configuring UNC Paths

Required Capability: See Capabilities and Permitted Actions

To change a user account for configuring UNC paths:

  1. From the CommCell Browser, expand the tree to view the subclient for the affected Windows File System agent. Then right-click the subclient and click Properties.
  2. From the Subclient Properties dialog box, click the Content tab.
  3. From the Content tab, if you want to include more shares as subclient content, type in the UNC path of the first share that you want to add in the Enter New Content field and click Add. Repeat this step if you want to add more files and/or folders to the content.
  4. Click As User.
  5. Enter the required information in the Impersonate User dialog box.
  6. Click OK to save the settings.

Change Account for Executing Pre/Post Commands (Data Protection)

Required Capability: See Capabilities and Permitted Actions

To change a user account for executing pre/post commands for Data Protection jobs:

  1. From the CommCell Browser, expand the tree to view the appropriate level icon for the affected agent.
  2. From the Subclient Properties dialog box, create and/or configure the subclient as appropriate. Then click the Pre/Post Process tab.
  3. From the Pre/Post Process tab, click Change.
  4. From the User Account dialog box, select one of the account options. If you select Impersonate User, type the appropriate user name and password.
  5. Click OK to save the settings.

Enter UNC Path as Subclient Content

Related Topics:

Before You Begin

Required Capability: See Capabilities and Permitted Actions

To enter UNC path(s) as subclient content:

  1. From the CommCell Browser, right-click the subclient whose content you want to change, then click Properties.
  2. From the Content tab of the Subclient Properties dialog box, type in the UNC path of the share that you want to add in the Enter New Content field and click Add. Repeat this step if you want to add more files and/or folders to the content.
  3. If this is the first UNC path being entered as subclient content the Impersonate NT User dialog box will appear. Enter the user account information for the Domain User with permissions for that path. Note the following:
  4. To save your content changes, click OK from the Content tab of the Subclient Properties dialog box.

Enable QSnap on a Subclient

Related Topics:

Before You Begin

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To enable QSnap on a subclient:

  1. From the CommCell Browser, right-click the subclient that you want to back up, and choose Properties.
  2. For Unix File System iDataAgents or Windows File System iDataAgents, from the General tab, select the Use QSnap checkbox.
  3. Click OK. Your next backup will use QSnap.

Enable VSS Backups of a Subclient

Related Topics:

Use this procedure to enable VSS backups on a subclient of a Windows iDataAgent that supports VSS or on a subclient of an Image Level iDataAgent.

Before You Begin

Required Capability: See Capabilities and Permitted Actions

To enable VSS on a subclient:

  1. From the CommCell Browser, right-click the subclient for which you want to enable VSS, and then click Properties.
  2. From the General tab of the Subclient Properties dialog box, click the Use VSS checkbox to back up data files using VSS.

    If the subclient includes system state, and you want to back up system state and data files, click Use VSS for System State.
    In case of Windows 2008 Use VSS for System State option is not visible. It is always on and cannot be edited.

  3. Click OK to save your changes.

This task is now complete.


Back To Top