Subclients - Quick Recovery Agent - How To
Topics | How To | Related Topics
Associate a Subclient to a QR Policy
Change Account for Executing Pre/Post Commands (Data Protection) (QR Agent on
Windows)
Configure a Subclient for Pre/Post Processing of Data Protection Operations
Configure Subclient Content
Create a New Subclient
Configure Subclients for Overlapping Content
Delete a User-Defined Subclient
Enable or Disable Operations
Enable Software Compression
and Network Bandwidth for a QR Subclient
Remove a Process from Pre/Post Processing of Data Protection Operations
Rename a Subclient
View Subclient Content
Associate a Subclient to a QR Policy
Related Topics
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.
Required Capability: See Capabilities and Permitted Actions
To associate a subclient to a QR Policy:
- 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.
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.
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 and then click
Properties.
- Click the Subclient Properties
(Content) tab and configure the following options:
- Click Detect to configure the disk volumes of a host computer
or NetApp file server
that is eligible to have a QR Volume created by the Quick Recovery Agent.
- 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.
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.
Related Topics:
Before You Begin
- Review Overlapping Content.
- 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.
Required Capability: See
Capabilities
and Permitted Actions
To configure
subclients for overlapping content:
- 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).
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.
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.
![note.gif (292 bytes)](../../images/note.gif) |
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.
Required Capability:
Capabilities and Permitted Actions
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.
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.
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.
Back To Top