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
- 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.
Required Capability: See
Capabilities
and Permitted Actions
To associate
a subclient to a storage policy:
- From the CommCell Browser, right-click the subclient whose associated storage
policy you want to change, then click Properties from the shortcut
menu.
- Click the Storage
Device tab of the Subclient Properties dialog box.
- 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.
- From the
Changing
a Storage Policy window select the next type of
backup operation. Click OK.
- If applicable for your agent, you can change the number of data streams
from the Number of Data/Database Backup Streams
field.
- 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.
- Click OK to save your changes and close the Subclient Properties
Storage Device tab.
Required Capability: See
Capabilities
and Permitted Actions
To
associate or disassociate a user group to a CommCell entity:
- 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.
- 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.
- Click OK.
Configure a Subclient for Pre/Post Processing of Data Protection/Archive Operations
Before You Begin
- We recommend not configuring a pre/post process for a subclient that is
currently running a data protection or archive operation.
- Verify that there are no pre/post processes already assigned for the subclient.
- Review the Overview and
Agent-Specific Guidelines
for your agent before configuring pre/post processes for data protection/archive
operations.
- Pre-process commands for the iDataAgents
will be executed only when the necessary resources (e.g., media, library, drive,
etc.) are available.
Required Capability:
Capabilities
and Permitted Actions
To configure
a subclient for Pre/Post processing of data protection/archive operations:
- 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.
- Click the Pre/Post
Process tab of the Properties dialog box.
- 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.
- PreBackup
- PreScan
- PreArchive
- PreCopy
- PreSnap
- PostBackup
- PostScan
- PostArchive
- PostCopy
- PostSnap
Click OK.
- If you want to run a Post Process for all attempts to run that job phase, then select the
corresponding checkbox.
- 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.
- In the
User Account dialog box, select Use Local System Account, or
select Impersonate User and enter a user name and password. Click
OK.
- 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.
- Click OK to save your changes and close the
Pre/Post Process
tab of the Properties dialog box.
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.)
|
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:
- From the CommCell Console, right-click the subclient and click Properties.
- From the
Subclient Properties (Encryption)
tab, select an option based on the
criteria described in the Encryption tab help.
- Click OK to save your settings and close subclient properties.
Before You Begin
Required Capability: See
Capabilities
and Permitted Actions
To create
a new subclient:
- 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.
- For the SQL Server iDataAgent,
expand New Subclient and click either Database to include
individual databases or File/File Group to include database
elements.
- For the File Archiver Agent for Windows with Data
Classification, right-click the DataClassSet, expand All
Tasks, and then click Create DataClassSet (subclient).
- 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.
- Select other options from the General tab as appropriate for the agent.
- Click the Content or Databases tab of the Subclient Properties
dialog box and Configure Subclient Content
as appropriate for your agent.
- 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.
- For the DB2 and DB2 DPF iDataAgents, you
can also change the number of data backup streams. For the DB2 DPF
iDataAgent, the default
stream threshold should be equal to the total number of database
partitions for the subclient.
- For SQL Server iDataAgents,
you can also click the
Storage Device (Log
Storage Policy) tab of the Subclient Properties dialog box, then select
a log storage policy to associate with this subclient from the storage policy
list and select the number of backup streams for transaction log backup
jobs.
- For 1-Touch for Unix, it is strongly recommended that the storage
policy that you select for the subclient configured for 1-Touch use a
MediaAgent on a different computer. If you do this, and if the system
crashes, the media will not have to be exported to another MediaAgent in
order to recover the system.
- 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.
- 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.
- 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.
- Optionally (if supported
for your agent) you can:
- 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.
- 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.
- If you want to associate this subclient with an All Agent Types schedule
policy, click Associate with Generic Schedule Policy, and then select
that schedule policy from the drop-down list box. Click OK.
- If you want to associate this subclient with a specific schedule
policy, click Associate to schedule policy, and then select the
schedule policy from the drop-down list box. Click OK.
- If you have selected to define a schedule for this subclient:
- Click Schedule.
- From the Backup/Archive
Options dialog box, select the type of data protection operation
that you want to schedule.
- If you want to set Advanced Backup/Archive Options, click
Advanced.
- After selecting the data protection type and any advanced options,
click OK. The Schedule Details dialog box appears.
- From the
Schedule Details
tab, select the scheduling options that you want to apply, then click
OK.
- If you don't want to create a data protection schedule at this time,
click Do Not Schedule, and then click OK.
This task is now complete.
Create a New Subclient Policy
Before You Begin
- Ensure that no data protection operations are currently running on the backup
sets that you will be associating with the new Subclient Policy.
- Ensure that there are no user-defined subclients in the backup sets that
you will be associating with the new Subclient Policy.
Required Capability: See Capabilities and Permitted Actions
To create a new Subclient Policy:
- 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.
- 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.
- 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.
- 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:
- Create New Subclient
(General) tab (required)
- Enter a name for your user-defined subclient in the Name
field.
- Optionally, you can change the Number of Data Readers to
a value other than 1 (which is the default), if applicable for your
agent type.
- Optionally, you can select the Allow multiple data readers within
a drive or mount point checkbox to enable this feature.
- Optionally, you can clear the Backup System State checkbox,
which is selected by default and causes the Default Subclient to
back up the system state with the file system. Clearing the checkbox
causes the Default Subclient to back up only the file system and
not the system state. You can then enable system state backup for a
different client in the Backup Set.
- Optionally, you can select the Use VSS checkbox to enable
VSS backups for this subclient, if applicable for your agent type.
- Optionally, you can select the Use QSnap checkbox to enable
backups of locked and/or open files for this subclient using QSnap,
when QSnap is installed on clients of the applicable agent type.
- Create New
Subclient (Content) tab (required)
- Specify the contents for this subclient by either clicking Browse
to browse for content, or by typing in a path in the Enter New Content
field then clicking Add. Repeat this step to include additional
objects in subclient content. If you are editing the content for a Default
subclient, see the Notes section below for more
information.
- If you are typing in a UNC path as content, then you will be prompted
to enter a user name and password for accessing that path.
- Optionally, you can select the Treat characters as regular expressions
checkbox so that any characters that are sometimes used as wildcard
characters will be treated as wildcards not as literals. See
Wildcards
for a list of supported regular expressions for your agent.
- Create New Subclient
(Filters) tab (optional)
- You can select one of the following values from the Include Global Filters
list to enable or disable global filters to exclude data from
backups on this subclient:
Do not use - Disables Global Filters for this subclient.
Always use - Enables Global Filters for this subclient.
Auto - Enables or disables Global
Filters for this subclient depending on whether the Use Global
Filters on All Subclients option is enabled or disabled on the
Control Panel (Global Filters) dialog.
- You can specify a file/folder/pattern that you want to exclude from
backups by clicking the upper Browse button to browse for an
object, or by clicking the upper Add button and then typing in
the object you want to exclude.
- You can specify an exception to your exclude filter by either clicking
the lower Browse button and browsing for the object, or by clicking
the lower Add button and then typing in the object you want to
enter as an exception to the exclusions list.
- Create New Subclient
(Pre/Post Process) tab (optional)
- You can type in or Browse for a batch file or shell script
that want executed after each job phase.
- You can also select the Run Post Process for
all attempts checkbox(es) if desired for the appropriate job phase.
- For Windows agents, you can click the Change button for the
Run As field to specify Local System Account or other username
and password that has authorization to run the specified processes.
- Create New Subclient
(Storage Device - Data Storage Policy) tab (required)
- Select a Storage Policy that you want to use for this subclient
from the drop-down list.
- Create
New Subclient (Storage Device - Data Transfer Option) tab (optional)
- You can select the desired software compression setting to be used
in case hardware compression is not available or not selected on the
destination storage policy copy. Otherwise you can leave the default
setting of Off to specify no software
compression.
- You can change the number of Network Agents to a value other
than 1 by typing in or selecting another value from the list.
- You can enable the option to Throttle Network Bandwidth
and adjust the throughput setting by selecting another value from
the list.
Once you have entered all of your configuration for the Regular user-defined
subclient type, click OK to save your changes.
- 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). |
- Click the
Association
tab of the Create New Subclient Policy dialog box.
- 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.
- 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
- 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.
Delete a User-Defined Subclient
Related Topics:
Required Capability: See
Capabilities
and Permitted Actions
To
delete a user-defined subclient:
- From the CommCell Browser, right-click the user-defined subclient that you
want to delete, and then click Delete from the shortcut menu.
- 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:
- the subclient, and any data that may have been protected/archived by
the subclient are logically deleted, and you can no longer access the corresponding
data for recovery/retrieve purposes. However, the data remains valid for
the length of time specified by the associated retention period. Some agents
allow you to browse data from a deleted subclient provided that the Browse
Data Before date and time precedes the time that the user-defined subclient
was deleted.
- for agents that support a default subclient, once the user-defined subclient
is deleted its contents are automatically reallocated to the default subclient
the next time a data protection/archive/discovery operation is run on the
default subclient to ensure data protection coverage.
- the system deletes the selected subclient node and removes it from the
CommCell Browser.
- the system deletes any data protection/archive and recovery/retrieve
job schedules that are associated with the subclient.
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.
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:
- 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.
- From the
Activity
Control
tab of the associated Properties dialog box, select or clear option(s), as desired.
- Click OK.
|
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
- Do not enable/disable software compression for a subclient that is being
backed up/archived.
Required Capability:
Capabilities and Permitted Actions
To
enable software
compression for a subclient:
- From the CommCell Browser, right-click the subclient for which you wish to
enable software compression and then click Properties.
- 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.
- Then click the
Storage
Device (Data Transfer Option) tab and choose the appropriate compression
option for this subclient.
- 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
- We recommend not removing a pre/post process for a subclient that is currently
running a data protection or archive operation.
- Review the Overview and
Agent-Specific Guidelines
for your agent before removing pre/post processes for data protection/archive
operations.
Required Capability: Capabilities and Permitted Actions
To remove a process from Pre/Post processing of data protection/archive operations:
- 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.
- Click the Pre/Post
Process tab of the Subclient Properties dialog box.
- 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:
- PreScan
- PreArchive
- PreCopy
- PreSnap
- PostBackup
- PostScan
- PostArchive
- PostCopy
- PostSnap
- Repeat Step 3 for any additional processes that you want to remove.
- Click OK.
Before You Begin
- You can rename a subclient at any time. However, we recommend that you don't
rename a subclient while a data protection or archive operation is running on
that subclient.
- In cases where a subclient is renamed using the same name as a deleted subclient,
the system will append a Unix time stamp to the deleted subclient's name in
data protection job history reports and views to distinguish the two subclients.
For example, subclientname_1104257351.
Required Capability: See
Capabilities
and Permitted Actions
To
rename a subclient:
- From the CommCell Browser, right-click the subclient that you want to rename,
and then click Properties from the shortcut menu.
- 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
- Do not modify the network bandwidth and network agents for a subclient or instance that is being backed up.
Required Capability:
Capabilities and Permitted Actions
To Set
the Network Bandwidth and Network Agents for a Data Protection Operation:
- 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.
- Click the Storage
Device
Data Transfer Option tab.
For the QR Agent:
- To control network bandwidth settings, use the Throttle Network
Bandwidth section in the General tab of the Subclient Properties dialog box.
- To control the number of network agents, you must create a
nQRNetworkAgents registry
key.
- Enter a number of Network Agents that must be used to perform
data protection operations on the subclient/instance.
- 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.
- 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:
- From the CommCell Browser, right-click the subclient whose data paths you
want to view, then click Properties from the shortcut menu.
- Click the Storage
Device tab of the Subclient Properties dialog box.
- 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.
- Click OK to exit the Subclient Properties
Storage Device tab.
Required Capability: See
Capabilities
and Permitted Actions
To view
content of a subclient:
- From the CommCell Browser, right-click the subclient whose content you want
to view, then click Properties.
- From the Subclient Properties dialog box, click the Content tab (or
Databases tab for Lotus Notes) to view the contents of the subclient.
- Click OK to close the dialog box.
Related Topics:
Before You Begin
Required Capability: See
Capabilities
and Permitted Actions
To
configure the subclient for 1-Touch:
- From the CommCell Browser, right-click the appropriate (usually the
default) subclient and then click Properties from the shortcut menu.
- From the
Subclient Properties (1-Touch
Recovery) tab, click 1-Touch Recovery.
- 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.
- For 1-Touch for Linux, this will be the directory that is exported
in NFS from the 1-Touch server per the appropriate directive in
Setting up 1-Touch for Linux.
- Click OK.
Required Capability: See
Capabilities
and Permitted Actions
To change
a user account for configuring UNC paths:
- 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.
- From the Subclient Properties dialog box, click the Content
tab.
- 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.
- Click As User.
- Enter the required information in the
Impersonate
User dialog box.
- Click OK to save the settings.
Required Capability: See
Capabilities
and Permitted Actions
To change
a user account for executing pre/post commands for Data Protection jobs:
- From the CommCell Browser, expand the tree to view the appropriate level
icon for the affected agent.
- From the agent, instance/partition, or backup set/archive set level, right-click
the appropriate icon, click All Tasks, and click New Subclient
from the short-cut menu.
- From the subclient level, right-click the subclient icon and click
Properties from the short-cut menu.
- From the Subclient Properties dialog box, create and/or configure the subclient
as appropriate. Then click the Pre/Post Process tab.
- From the Pre/Post Process tab, click Change.
- From the
User Account dialog box, select one of the account options. If you select
Impersonate User, type the appropriate user name and password.
- Click OK to save the settings.
Related Topics:
Before You Begin
Required Capability: See
Capabilities
and Permitted Actions
To enter
UNC path(s) as subclient content:
- From the CommCell Browser, right-click the subclient whose content you want
to change, then click Properties.
- 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.
- 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:
- Login name must be provided in the following format: <domain>\UserName
For example, to log on as usr1 in a domain called
MyDomain, enter MyDomain\usr1
as the user name
- The domain user that you specify should have access to all the UNC paths
entered as contents of the subclient.
- Adding a UNC shared path as subclient content of a member server that
points to a server in a workgroup requires the local user name and password
is identical to a domain user's name and password. (This is a scenario where
<UserName> and password is accepted.)
- Adding a UNC shared path as subclient content of a non-member (workgroup)
server that points to a member server requires the local user name and password
is identical to a domain user's name and password. (This is a scenario where
<UserName> and password is accepted.)
- The domain user can be changed at a later time with the As User
button.
- 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
To
enable QSnap on a subclient:
- From the CommCell Browser, right-click the subclient that you want to back up,
and choose Properties.
- For Unix File System iDataAgents
or Windows File System iDataAgents,
from the General tab, select the Use QSnap checkbox.
- 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:
- From the CommCell Browser, right-click the subclient for which you want
to enable VSS, and then click Properties.
- 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. |
- Click OK to save your changes.
This task is now complete.
Back To Top