Content, Filters, and Regular Expressions - How To
Topics | How To | Related Topics
Content
Configure Subclient Content
Filters
Add/Edit a Data Protection Filter for a Subclient
Delete a Data Protection Filter from a Subclient
Add/Edit/Delete Filters for a Replication Set
Global Filters
Add/Modify an Exclusion
for the Exclusions List
Delete an Exclusion from the Exclusions List
Disable Global Filters on a Subclient
Enable Global Filters on a Subclient
Before You Begin
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/Web 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/Web Folder iDataAgents:
Click Browse, select folders to include as content, then click
Add.
- 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 DataArchiver for Exchange Agents follow the procedure to
Discover and Assign New Journal
Mailboxes or Assign Journal 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 2000 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 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.
NOTES
- 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.
- SQL Server 2000 Database iDataAgents:
The logical and physical names are available to assist in identifying the correct
content. Files and file groups that are configured as content of other subclients
are unavailable for selection.
- 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.)
|
Add/Edit a Data Protection Filter for a Subclient
Before You Begin
- Review Filters.
- Do not change the data protection or discovery filter of a subclient that
has a data protection operation in progress.
- The system does not allow you to add entries that are not content of a particular subclient to that subclient's filter.
- For BlueArc and EMC Celerra (running at least DART OS 5.6.x) subclients,
the filter string with or without wildcards must match the name or path of
the file or directory being filtered.
- For NetApp subclients only name type filters (with wildcards) are
supported:
- You cannot enter paths as a filter (e.g.
/vol/vol0/data1). Since NetApp does not support the use of paths in filters, if there are multiple files with the same name, even though they may be in different directories, all of them will be excluded from backups.
- Name of the file or directory must exactly match the filter string.
- You can specify a maximum of 32 strings in the exclude list.
Select the desired procedure:
Required Capability: Capabilities and Permitted Actions
To add a data protection or discovery filter entry for a subclient:
- 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.
- Click the Filters tab of the Subclient Properties dialog box.
- 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:
- 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.
- 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.
- 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:
- Click the upper Add button and, in the Enter Path window, type the complete path (including drive letter) of the file/folder/directory that you want to exclude from the
backups/archive operations. Repeat this step if you want to add more files/folders/directories to the filter.
- Click the upper Browse button and expand the file system
of the client computer. Click the file/folder/directory that you
want to exclude from backups/archive operations and then click Add. Repeat this step for each additional entry.
- For NetWare File System/NDS iDataAgents, to specify data that you want excluded from the backups, do one of the following:
- To manually enter the path:
- Click the Add button.
- In the Input window, type the complete path (e.g., VOL1:\demo\disk2) of the data that you want to exclude.
- Click OK. (The path that you typed displays as an entry in the upper pane.) Repeat this step if you want to exclude more data.
- To browse and select a path:
- Click the Browse button.
- From the Backup Data window, expand the file system or NDS tree of the NetWare server.
- Select the data that you want to exclude, and then click Add. Repeat this step for each additional entry.
- From the Backup Data window, click OK. The data that you selected displays as entries in the upper pane.
- 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:
- Select the Pattern/path to be excluded field. Then type in a file or folder that you want to exclude. The format of the entry should start with a slash (\). The path entered is always relative to the data path of the partition. Then click Add. Repeat this step for each additional entry.
- Click the upper Browse button and expand the file system of the client computer. Click the file or folder that you want to exclude from the backups and then click Add. Repeat this step for each additional entry.
- 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:
- Click the lower Add button.
- In the Input window, type the wildcard pattern of the folders that you want to
exclude from backup/archive operations on the selected
subclient.
- Click OK. The path that you typed appears as an entry in the lower
pane. Repeat this step if you want to add more entries to the filter.
- 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.
- 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:
- Click the lower Add button and, in the Enter Path
window, type the complete
path (including drive letter) of the file/folder/directory that you want to include in the
backups/archive operations. Repeat this step if you want to add more exceptions to the filter.
- Click the lower Browse button and expand the file system of the client
computer. Click the file/folder/directory that you want to include in the backups/archive
operations and then
click Add. Repeat this step for each additional entry.
- 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:
- To manually enter the path:
- Click the Add button.
- In the Input window, type the complete path (e.g., VOL1:\demo\disk2\readme) of the data
that you want to include.
- Click OK.
- To browse and select a path:
- Click the Browse button.
- From the Backup Data window, expand the file system or NDS tree of the NetWare server.
- Click the file or folder that you want to include in the backups and then click Add. Repeat this step for each additional entry.
- Click OK. The selected data displays as entries in the lower pane.
- Click OK to save your changes.
Required Capability: Capabilities and Permitted Actions
To edit a data protection filter entry for a subclient:
- From the CommCell Browser, right-click the subclient whose data protection filter you want to edit, and then click Properties from the shortcut menu.
- Click the Filters tab of the Subclient Properties dialog box.
- Click the filter entry that you want to edit, and then click the Edit button associated with that pane.
- Type the changes into the Enter Path dialog box, then click OK.
- Click OK to save your changes.
NOTES
- When you change a data protection or discovery filter, the change is effective the next time
a data protection operation is run on the applicable subclient.
- Performing a full backup after changing filters or exceptions is recommended.
Delete a Data Protection Filter from a Subclient
Before You Begin
- Review Filters.
- Do not change the data protection or discovery filter of a subclient that
has a data protection operation in progress.
- File Archiver for Windows/Unix Agents: We recommend that you don't delete the following entries from the exclusion filter, as it could cause your file system to be inoperable. For Windows, these include: *.dll, *.bat, *.exe, *.cur, *.ico, *.lnk. For Unix, these include *.a, *.ksh, *.csh, *.sh, *.lib, *.so.
Required Capability: Capabilities and Permitted Actions
To delete a data protection or discovery filter entry from a subclient:
- 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.
- Click the Filters tab of the Subclient Properties dialog box.
- 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.)
- 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.)
- Click OK to save your changes.
NOTES
- Whenever you delete an entry from the exclusion filter, check if the exceptions list (i.e., lower pane) contains any entries that are children of the deleted data (if applicable for your agent). If so, you should delete them as described in Step 4 since they no longer need to be listed. The system automatically deletes any exceptions that are children of a deleted exclusion unless you used wildcard expressions in the exclusion path.
- When you change a data protection or discovery filter, the change is effective the next time the subclient is backed up/archived.
- Data will not be backed up in a differential backup for a subclient after a filter was removed.
- Since Incremental backups only back up data that has been modified since the last backup, previously filtered files whose filters are now removed, will not be backed up unless they have been modified since that last backup. To back up previously filtered files that have not been modified but whose filters have been removed since the last backup, you need to run a Full backup.
- Performing a full backup after changing filters or exceptions is recommended.
Add/Edit/Delete Filters for a Replication Set
Related Topics:
Before You Begin
- When Filtering is edited for a Replication Set, any existing and active Replication Pairs will be automatically aborted and restarted to effect the change. If the newly configured filtering excludes files or folders that had previously been replicated, these files and folders on the destination(s) will be handled according to your
Orphan Files settings.
- To configure filters for a new Replication Set, see Create a Replication Set.
Required Capability: Capabilities and Permitted Actions
To add/edit/delete a filter for a Replication Set:
- In the CommCell Browser, right-click a Replication Set on the source machine, and select Properties.
- In the Filters tab, specify the files and folders to filter from the content of any Replication Pairs that are created for this Replication Set. For more information, see Replication Filters.
- Click OK to save your changes.
Add/Modify an Exclusion for the Exclusions List
Before You Begin
- Review Global Filters.
- Do not change the Global Filter for subclients that have a data protection operation in progress.
- Performing a full backup after changing Global Filters is recommended.
- When you change a Global Filter, the change is effective the next time a data protection operation is run on the applicable subclients.
Required Capability: Capabilities and Permitted Actions
To add
or modify an exclusion to the exclusions list:
- From the CommCell Browser, right-click the CommServe, click Control Panel, and then click Global Filters.
- From the Global Filters
window, select the appropriate agent option from the Global Filter
Category windowpane for the exclusions list you want to define.
- For File System iDataAgents,
perform one of the following actions:
- To add a file or folder that will be excluded from backups, click Browse and select the desired path.
Click OK.
- To add a file, folder or pattern that will be excluded from backups, click Add,
and in the Enter Path dialog box, type the complete path (including
drive letter) of the file, folder, or wildcard pattern that you want to
exclude. Click OK.
- To modify an existing filter entry, select the entry in the display
pane, then click Modify. In the Enter Path dialog box, type in
your modification to the complete path (including drive letter) of the
file, folder, or wildcard pattern that you want to exclude. Click OK.
See Wildcards
for a list of supported wildcards for File System
iDataAgents. Repeat this step if you want to
add or modify more files and/or folders for the filter.
- For Exchange Mailbox-based agents, perform one of the following
actions:
- To add a mailbox folder that will be excluded from data
protection operations, on the Exclude Folder tab, click Add,
and in the Enter Folder Name (or Enter Path) dialog box, type in the
mailbox folder path that you want to exclude. Click OK.
- To add a mailbox folder pattern that will be excluded from data
protection operations, click the Exclude Folder Patterns tab, click Add,
and in the Enter Folder Name (or Enter Path) dialog box, type in the
wildcard pattern of the mailbox folders that you want to exclude. Click
OK.
- To modify an existing filter entry on either the Exclude Folder
tab or Exclude Folder Patterns tab, select the entry in the display
pane and click Modify. In the Enter Folder Name (or Enter Path) dialog box, type in
your modification to the mailbox folder name or wildcard pattern that you want to exclude.
Click OK.
See Wildcards for a list of supported wildcards
for Exchange Mailbox-based agents. Repeat this step to add or modify more mailbox folders and/or wildcard patterns
for the filter.
- If applicable, you can select the Use CommNet Global Filter checkbox
to have CommNet Global Filter exclusions applied to this CommCell.
- To save your changes to the global filter, click OK.
Delete an Exclusion from the Exclusions List
Before You Begin
- Review Global Filters.
- Do not change the Global Filter for subclients that have a data protection operation in progress.
- Performing a full backup after changing Global Filters is recommended.
- When you change a Global Filter, the change is effective the next time a data protection operation is run on the applicable subclients.
Required Capability: Capabilities and Permitted Actions
To delete an exclusion from the exclusions list:
- From the CommCell Browser, right-click the CommServe, click Control Panel, and then click Global Filters.
- From the Global Filters
window, select the appropriate agent option from the Global Filter
Category windowpane for the exclusions list you want to delete.
- Select the file, folder path, mailbox folder or wildcard expression from the Exclusions list you wish to delete, and then click Delete. (Repeat this step for each entry that you want to delete.)
- To save your changes to the global filter, click OK.
Disable Global Filters on a Subclient
Before You Begin
- Review Global Filters.
- Do not disable the Global Filter for a subclient that has a data protection operation in progress.
- Performing a full backup after disabling the Global Filter on a subclient is recommended.
- When you disable the Global Filter on a subclient, the change is effective the next time a data protection operation is run on the subclient.
Required Capability: Capabilities and Permitted Actions
To disable the Global Filter on a subclient:
- From the CommCell Browser, right-click the subclient whose Global Filter you want to disable, and then click Properties from the shortcut menu.
- Click the Filters tab of the Subclient Properties dialog box.
- To disable Global Filters on this subclient, select one of the following
values from the Include Global Filters list:
- OFF - select this option to
always disable Global Filters for this subclient.
- Use Cell Level Policy - select this option to disable
Global Filters for this subclient only when the Use Global Filters on
All Subclients option is disabled on the Control Panel (Global
Filters) dialog.
- Click OK to save your changes.
Enable Global Filters on a Subclient
Before You Begin
- Review Global Filters.
- This procedure assumes that you have previously established CommCell Level Global Filters. See Add an Exclusion to the Exclusions List for step-by-step instructions.
- Do not enable the Global Filter for a subclient that has a data protection operation in progress.
- Performing a full backup after enabling the Global Filter on a subclient is recommended.
- When you enable the Global Filter on a subclient, the change is effective the next time a data protection operation is run on the subclient.
Required Capability: Capabilities and Permitted Actions
To enable the Global Filter on a subclient:
- From the CommCell Browser, right-click the subclient whose Global Filter you want to enable, and then click Properties from the shortcut menu.
- Click the Filters tab of the Subclient Properties dialog box.
- To enable Global Filters on this subclient, select one of the following
values from the Include Global Filters list:
- ON - select this option to
always enable Global Filters for this subclient.
- Use Cell Level Policy - select this option to enable
Global Filters for this subclient only when the Use Global Filters on
All Subclients option is enabled on the Control Panel (Global
Filters) dialog.
- Click OK to save your changes.
Back To Top