Subclients - Lotus Notes

Topics | How To | Related Topics


Overview

Configurable Properties

Things to Consider when Creating and Configuring Lotus Notes Subclients

Setting Folder-Based Auto-Discovery for Subclients


Overview

The following table shows subclient creation and configuration details specific to Lotus Notes iDataAgents.

Agent

Type of Data Default Subclient created during install of the Agent Supports Default Subclient Supports User Defined Subclient Contents of the default subclient when user-defined subclient is present Other Types of subclients supported by the Agent Notes
Lotus Notes Database  Lotus Notes database Yes Yes Yes databases/ database elements not assigned to the other subclients, unless otherwise configured* Transaction Log;

Do Not Backup

*See Caution Against Re-configuring Default Subclient Content.
Lotus Notes Document  Lotus Notes documents Yes Yes Yes content not assigned to other subclients, unless otherwise configured* Do Not Backup *See Caution Against Re-configuring Default Subclient Content.

The following example illustrates a simple subclient configuration: 

Example - Lotus Notes

Default Subclients

When you perform a full backup for the default subclient, the subclient performs a discover on the partition and performs a full backup of any new databases and of the databases that already exist within the subclient. When an incremental backup is performed for the default subclient, the subclient performs a discover on the partition, and it performs a full backup of discovered and newly-added databases and new or modified documents of existing databases, including:

While this feature ensures that all the new databases will be automatically backed up, you may want to assign the new databases to specific subclients. To do this, you can conduct the discovery process and assign the databases yourself using any of the following:

User-Defined Subclients

Optionally, users can create additional subclients with each one containing one or more databases. When a full backup is performed for a user-defined subclient, the subclient performs a full backup of its databases. When an incremental backup is performed for a user-defined subclient, the subclient performs a full backup of any database that was not part of this subclient on the last backup (incremental or full), and new or modified documents of existing databases, and databases that were:

Transaction Log Subclients

The system creates a transaction log subclient for the Lotus Notes Database iDataAgent that handles backing up transaction logs for all log-enabled databases within the partition.

Do Not Backup Subclient

The Do Not Backup subclient is created by the system. It cannot be scheduled for backup, so databases included in this subclient are never backed up. Essentially, this subclient acts as a backup filter.


Configurable Properties

Once installed, the agent is configured and is therefore able to manage the data or volumes on the client computer. However, you can change certain aspects of the subclient configuration to manage the data in the manner that best suits your needs.

You can view or change the subclient configuration from the Subclient Properties dialog box. The following information can be configured.

Activity Control

You can enable or disable all operations for this CommCell object and all objects below it. For more information, see Activity Control.

Content/Databases

You can define the content of the subclient. Most agents include a configure button that displays a dialog where you can add or modify the data included as subclient content. For step-by-step instructions, see Configure Subclient Content.

Data Transfer Options

Several configurable options to efficiently use available resources for transferring data secured by data protection operations are provided in the subclient. This includes the following:

Data Encryption

You can enable or disable the encryption of data for transmission over unsecure networks and for storage on media. For more information, see Data Encryption.

Data Paths

You can view the data paths associated with the primary storage policy copy of the selected storage policy or incremental storage policy. You can also modify the data paths for the subclient including their priority. For additional information, see Configuring Alternate Data Paths for Subclients.

Discovery Filters

You can perform the following functions:

The Filters tab is only available for the default subclient.

Pre/Post Processes

You can add, modify or view Pre/Post processes for the subclient. These are batch files or shell scripts that you can run before or after certain job phases. For more information, see Pre/Post Processes.

Subclient Name

You can rename a user-defined subclient.

User Accounts

You can define an account with permissions to execute Pre/Post commands for the agent's archive, backup, or volume creation jobs.

See Lotus Domino Server iDataAgents in User Accounts and Passwords for more information.


Things to Consider when Creating and Configuring Lotus Notes Subclients

When creating and configuring subclients for Lotus Notes iDataAgents, keep in mind the following considerations:


Setting Folder-Based Auto-Discovery for Subclients

This operation is only available for subclients of a Notes Database iDataAgent.

You can create a registry key that sets the auto-discover feature to find certain databases and assign them to subclients, based on a folder pattern that you specify in the registry key. Even if the databases that match the folder pattern are already assigned to another subclient, the databases move to the subclient where the registry key is set.

To create the registry key:

  1. Open Registry Editor (Regedit.exe or Redegt32.exe).
  2. Navigate to the Lotus Notes Database iDataAgent folder.

    For example: HKEY_LOCAL_MACHINE | SOFTWARE | Commvault Systems | Galaxy | <Instance Name> | LotusNotesDBagent.

  3. Right click LotusNotesDBAgent, point to New, and then click String Value.
  4. In the Name box, enter <Domino partition name>_<subclient name>.

    Each registry key name must be unique in the registry so that it is associated with the correct subclient. Therefore, you must name the registry key with the Domino partition name and the subclient name, separated by an underscore (_). For example: partition1_subclient1.

  5. Right click the <Domino partition name>_<subclient name> key that you just created, and then click Modify.
  6. In the Value box, enter a folder pattern in regular expression that will discover the databases you want to automatically include in the subclient. For information about regular expressions, see Content, Filters, and Regular Expressions.

    For example:

    • To include all databases in a folder, enter a single asterisk (*) at the end of the folder path: mail\NotesVolume1\*
    • To include all databases in all sub-folders, enter two asterisks (**) at the end of the folder path: mail\NotesVolume2\**
    • To add multiple regular expressions, separate each expression with a semi-colon (;): mail\NotesVolume1\*;mail\NotesVolume2\*
  7. Click OK.

For more information, see the entry in Registry Keys.

Back to Top