Configure Subclient Content

Before You Begin

Review Subclients.
Do not configure the content of a subclient while the parent node or any sibling subclient has a data protection or archive operation currently running on it.
Exchange Mailbox iDataAgents and Exchange Mailbox/Public Folder Archiver Agents: If you change the contents of the default backup set or archive set then the auto-discover feature will be disabled. If you disable the auto-discovery feature, newly created mailboxes will not be backed up/archived unless they are manually discovered and assigned to a subclient.
NAS NDMP iDataAgents: You must ensure there is no overlap in content between all subclients. Overlap in subclient content will result in loss of data. An existing subclient's contents are not automatically changed when another subclient is added with overlapping contents.
SharePoint Server iDataAgent: The Site Content Database, the Site Collection Database, the Site Database, and the Site Index for the virtual server must all be assigned to the same subclient.
Lotus Notes Document iDataAgent: Review Assigning Restore View Names to Newly-discovered Databases
QR Agent: Follow these guidelines when adding a volume to a QR Agent subclient:
- The volume must correspond to a physical disk or RAID array.
- A volume created by volume management software other than VxVM is not valid subclient content.
- Subclients may have overlapping content; however, if two or more subclients overlap, they all must use the same snapshot engine. If the QR policies associated with the subclients are configured to use different snap engines, they must be reconfigured to use the same snap engine in this scenario.
Caution Against Re-configuring Default Subclient Content
We recommend that you do not re-configure the content of a default subclient because this would disable its capability to serve as "catch-all" entity for client data. As a result, the likelihood that some data will not get backed up or scanned for archiving would increase.

Required Capability: See Capabilities and Permitted Actions

To configure subclient content:

From the CommCell Browser, right-click the subclient for which you want to configure content, click All Tasks (if applicable) and then click Properties.
Follow the procedure below that is applicable for your agent:
- For File System, Active Directory, File Archiver, Exchange Public Folder iDataAgents, NDS, and SharePoint Server iDataAgents click the Subclient Properties (Content) tab and configure content for the subclient as described below for your agent:
  - For File System, Active Directory, File Archiver, NDS, and SharePoint Server iDataAgents: Type the full path of the data that you want to include as subclient content in the Enter New Content field, then click Add. Optionally, click Browse to enter the content. When browsing content while configuring SharePoint subclients, you can add content via multiple selections with the CTRL or SHIFT keys. For Windows, when specifying a UNC Path, click As User, and enter the user account information for the domain user with permissions for that path. For NetWare/DNS, see the Notes section below for content path examples. For Unix File Systems, you can enter the mount point of an NFS-mounted file system, see the Notes section below for examples.
  - For Exchange Public Folder iDataAgents: Click Browse, select folders to include as content, then click Add.
  - For the Unix File System iDataAgents, to facilitate the management of resource fork data in Apple double-encoded Macintosh files, click Enable Apple Double Support.
  - For the Unix File System iDataAgents, to view the actual data path for any symbolic link in the subclient content, click Expand symbolic links of subclient content and then click Discover.
- For NAS NDMP iDataAgents, configure the Backup Content Path field(s) as described below, then click Add:
  - Click the drop-down list arrow to display the root volumes on the file server. To change the root volume, click one in the list. If you want to refine the content path further, use the space to the right of (or below) the root volume list to enter additional path information. Note the following:
    - For NetApp, the root volume is the mount path of each volume.
      Example: for volume FS1 the root volume will be /vol/FS1.
    - For EMC Celerra, the root volume is the mount point created for a volume.
      Example: for volume FS1 with mount point /FS1 the root volume will be /FS1.
    - For Hitachi, no root volumes are shown in the drop down list. Type the full path of the root volume.
      Example: for volume FS1 with mount point /mnt/FS1 the root volume will be /mnt/FS1.
    - For BlueArc, the root volume is a combination of a descriptor of the path and the volume name.
      Example: for volume FS1 with a mount point of / the root volume will be /__VOLUME__/FS1.
  - Optionally, for NetApp NAS NDMP, click Browse to enter the content.
- For Exchange Mailbox and Exchange Mailbox/Public Folder Archiver Agents follow the procedure to Discover and Assign New Mailboxes or Assign Mailboxes to Another Subclient.
- For Lotus Notes Database and Document iDataAgents follow the procedure to Discover and Assign New Databases or Assign Databases to a Subclient.
- For DB2, DB2 DPF, Exchange Database, Novell GroupWise, SharePoint Server, SQL Server Database, Sybase, and MySQL iDataAgents, click the Subclient Properties (Content) tab and configure content for the subclient as described below for your agent:
  - For the DB2 iDataAgent, specify whether you want to include the entire database or a subset of this data as content for the subclient. For the DB2 DPF iDataAgent, specify whether you want to include all the affected database partitions or a subset of this data as content for the subclient.
  - For Exchange and GroupWise iDataAgents: Click Configure. From the Add/Modify Subclients dialog box click the subclient entry for the database element/Storage Group that you want to add to the new subclient and select the name of the destination subclient from the list that appears. Alternatively, you can select and assign a range of databases/storage groups using the Change all selected databases/storage groups to list. Note that you must have at least one database element/Storage Group assigned to this subclient in order to save the configuration.
    A database/Storage Group that is not configured for a subclient does not appear in the list. This can be the case if the subclient containing the database/Storage Group was deleted. If this happens, click Discover to display all databases/Storage Groups.
  - For the SharePoint Server iDataAgent, follow the procedure to Discover and Assign New Data Types.
  - For the Sybase iDataAgent, follow the procedure to Manually Discover Databases.
  - For the MySQL iDataAgent, follow the procedure to Configure MySQL Databases.
- For the Informix iDataAgent, click the Subclient Properties (Content) tab and define the contents of the subclient. Specifically, establish the backup mode for the data to be backed up, set the backup level, and decide whether to back up the emergency boot file and/or the ONCONFIG file.
- For the Oracle, SAP for Oracle, or Oracle RAC iDataAgent, click the Subclient Properties (Content) tab and define the contents of the subclient. To configure this subclient for specialized types of backups, follow the appropriate procedure below:
- For SAN iDataAgents, click the Subclient Properties (Content) tab and configure content for the subclient as described below for your agent:
  - Image Level on Unix iDataAgent: Click Add. From the Add Content Path dialog box, select the volume(s) that you want to back up (use CTRL + click to select multiple volumes). Click OK. The selected volumes are added to the Contents of subclient list. These volumes are automatically configured to be CXBF devices. Alternatively, use Volume Explorer per specific scenarios to configure CXBF devices.
    To configure an unmounted block device or raw device as content, first use Volume Explorer to configure the device as a CXBF device. Then select the configured CXBF device as subclient content. You can ignore the warning that is displayed.
    
    For more information, see When to Use Volume Explorer. For a step-by-step procedure, see Configure a CXBF Device in Volume Explorer.
  - Image Level and Image Level ProxyHost on Windows iDataAgents: Click Add. Then in the Add Content dialog box, type the full path of the volume or mount point that you want to include as subclient content, then click Add. Optionally, click Browse to select the content. Click OK. The volume or mount point is added to the Contents of subclient list. Add additional content by repeating this step.
  - ProxyHost iDataAgent: Select a backup host from the Backup Host list. This is the computer to which the BCV is connected. Click Add. In the Content field of the Add/Edit Content for Subclient dialog box, type the primary host path of the content that you want to back up, or click Browse to find and select this data. In the Backup Host BCV Path field of the Add/Edit Content for Subclient dialog box, type the path through which the backup host accesses this data on the BCV, or click Browse to find and select this path. Click OK. The primary host data path and corresponding backup host BCV path are added as a single entry in the Contents of subclient list. To add additional entries, repeat these steps. Refer to Notes below for more information.
- For Quick Recovery Agents, click the Subclient Properties (Content) tab and configure the following options:
  - Click Add Volume. From the Adding Volume dialog box, select volume(s) that you want to add to the subclient content (use CTRL + click to select multiple volumes). You can add/edit additional advanced options for the selected volume by select Advanced on the Adding Volume dialog box. Click OK.
  - Click Add App to select an application and associated volumes. Click OK.
    Any instances you intend to protect and recover with the QR Agent must be configured in the QR Agent properties Authentication tab. They will not appear in the Add App dialog box if they are not configured. Only volumes containing datafiles and archive log files will be detected by Add App. Volumes containing control files and redo log files will not be detected.
    
    For a clustered Exchange Server, if you are not using VSS to perform an online quiesce, sufficient permissions are required in order to be able to perform an offline quiesce; in such cases, ensure that the User Name specified has Exchange Administrator rights.
    
    See also Configure Subclients for Overlapping Content.
Click OK to save your content configuration.

Content examples for NetWare are OU=prospects.O=engineering.[Root], (for NDS content), and SYS:\public (for File System content).
Content examples for adding an NFS-mounted file system to subclient content of a Unix File System iDataAgent:
- /mountpointA to include the entire file system at mountpointA
- /mountpointA/projects for only the projects directory within the file system at mountpointA.
Informix subclients include one or more dbspaces. As databases are added to the dbspaces, the subclients are updated automatically.
Exchange Mailbox iDataAgents and Exchange Mailbox/Public Folder Archiver Agents: Initially, all unconfigured mailboxes are assigned to the default subclient. You can create a new subclient and reassign mailboxes to this new subclient (within the same backup set/archive set). Once assigned, the mailboxes become part of the content of the new subclient.
SharePoint Server iDataAgent: Initially, all unconfigured data types are assigned to the default subclient. You can create a new subclient and reassign data types to this new subclient. Once assigned, they become part of the content of the new subclient.

ProxyHost iDataAgent: The primary host data path is backed up by the subclient and is the path through which the backup host accesses this data on the BCV. A primary host path and its corresponding backup host path are listed in the following format:

<primary_host_path> --> <backup_host_path>

For example, assume that you want to back up the D:\data directory from your primary host and D:\ is mirrored by a BCV, which is mapped to the backup host as F:\. Consequently, the path to this data on the backup host is F:\data. When you add this directory to a subclient, it is listed in the Contents of subclient pane as D:\data --> F:\data.

The primary host path in the Content field is used for browse and restore purposes. However, it is the data in the Backup Host BCV Path which is actually backed up. If these two paths do not accurately correspond, the path that appears when data is browsed for restore does not accurately reflect the data that will be restored. In the example given above, assume that D:\data is entered in the Content field, while F:\data1 is accidentally entered in the Backup Host BCV Path. If you browse and select D:\data to be restored, it is actually D:\data1 that is restored. (Remember, F:\Data1 is the path on the backup host that corresponds to D:\data1 on the primary host.)