Whenever you create a subclient for the QR Agent, you must associate that subclient to a QR Policy. The QR Policy defines which snap engine and copy manager will be used for operations on the subclient.
Before You Begin
Do not change the QR Policy association while a QR Volume Creation operation is running on the subclient.
From the CommCell Browser, right-click the subclient of a QR Agent whose associated QR Policy you want to change, then click Properties from the shortcut menu.
Click the General tab of the Subclient Properties dialog box.
From the QR Policy list, select a QR Policy to associate with this subclient.
Click OK to save your changes and close the Subclient Properties dialog box.
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.
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.
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.
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.
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.
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.
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.
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 EnableApple 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 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 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.
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.
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.
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.)
Do not create a subclient while the parent node or any sibling subclient
has a data protection or archive operation currently running on it.
In cases where a new subclient is created with 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.
Informix iDataAgents: If you
will be using the Informix ONBAR utility to create backup and restore scripts,
you need not create subclients. Otherwise, if you will be using the CommCell
Console to back up and restore Informix database objects (subsets/dbspaces),
then you will need to create a subclient.
ProxyHost
iDataAgents: If you are using a BCV, you must prepare a batch
file or a shell script file on the backup host containing commands to synchronize
and split the BCV. The Resource Pack includes information on configurations
for these batch files or shell scripts, as well as examples that apply to specific
applications and hardware (e.g., Exchange databases in an EMC Symmetrix environment).
See Resource
Pack for more information on the Resource Pack.
The ProxyHost
iDataAgent also requires
that you set permissions for the batch/shell script file on the backup host.
SQL Server Database iDataAgents:
When running on Windows Server 2003 and VSS is enabled, the New Subclient
command is not available.
PostgreSQL
iDataAgents: Once you configure the PostgreSQL instance, the
system automatically generates the default backup sets and default
subclients. However, you can use the CommCell Console to create user-defined
subclients for dump backup sets to distribute some of the database content.
You cannot create user-defined subclients for FS backup sets.
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.
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.
For supported agents identified in
Support Information -
Snapshot Engines, you can select a
QSnap option to snap data and
then perform a data protection operation on the data.
For Image Level on Unix and Image Level ProxyHost on Unix, use the
Incremental Support Using field to configure either a CXBF
subclient or a checksum subclient and to enable incremental support for
either subclient type.
For QR Agents, you must also select a QR Policy from the QR Policy
list.
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 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.
View or change the user group security associations for this
subclient from the
Security tab.
Determine location from where archive logs will be backed up or
deleted from the
Log
Destinations tab.
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.
Subclient overlap is intended for use when you would like to have the same
source volume have both a full QR volume to hold a copy of your data from a
healthy point-in-time, and an incrementally updated QR volume to hold a more
recent copy of your data. Below is a general outline of the steps necessary
to add the same volume as content to two different subclients.
Create a new subclient as outlined in
Create a New
Subclient and add the volume as contents.
Create a new subclient as outlined in
Create a New
Subclient, add the volume as contents and assign the subclient to a different
QR Policy than the one assigned to the first subclient you created with this
volume as content. Note that in order for subclient overlap to work, both QR
policies must use the same snap engine.
When a volume has been added as content to more than one subclient, the
system will prompt you to disable incremental updates on one of the subclients.
Click OK. From the
Subclient Properties
(General) tab, select the Disable Incremental update of QR Volumes
option. The subclient for which you select this option will only be able to
perform full QR volume creations. The other subclient that does not have the
Disable Incremental update of QR Volumes option selected is able to perform
both full QR volume creations and incremental updates.
The subclients are now setup for overlapping content. When scheduling the
subclients, note that QR operations on the two subclients will not execute in
parallel (i.e., the first subclient cannot perform an incremental update of
the volume while the other subclient is performing a full QR Volume creation).
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.
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 and Network Bandwidth for a QR Subclient
Before you Begin
Do not change the software compression while a QR Volume Creation operation
is running on the subclient.
To
enable software
compression and Network Bandwidth for a QR subclient:
From the CommCell Browser, right-click the subclient of a QR Agent for
which you wish to enable software compression, then click Properties
from the shortcut menu.
Click the General
tab of the Subclient Properties dialog box.
Select the Compression ON option to enable software
compression.
Click the Throttle Network Bandwidth (MB/HR) option and then
enter the throughput as needed.
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.
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.
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.
To associate a subclient to a QR Policy: