Loading...

Advanced Configuration

Table of Contents

Understanding the CommCell Console

Creating User-Defined Subclients

Configuring Notes Partition

Assigning Domino System Files to a User-Defined Subclient

Configure to Filter Out Data from Being Backed Up

Configure to Discover Newly Added Databases

Configuring Folder Based Auto Discovery

Excluding Files and Paths from Backups

Modifying an Agent, Partition or Subclient

Deleting an Agent, Partition or Subclient

Understanding the CommCell Console

The Notes Database iDataAgent uses the following logical entities to manage backup and restore operations from the CommCell Console.

Agent

Facilitates Notes partition discovery.

Partition

A partition is an instance of the IBM Domino running on a given computer.

Subclient

Defines the Notes Database objects to be backed up.

Creating User-Defined Subclients

By default, all databases are automatically assigned to the default subclient. However, you can divide databases across one or more user-defined subclients to leverage your backups efficiently.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database.
  2. Right-click <Partition> and click All Tasks | New Subclient.
  3. Enter a name in the Subclient Name field.
  4. Click the Databases tab, and then click the Configure button.
  5. In the Add/Modify databases/subclient configuration for partition dialog box click the Discover button.
  6. Select the discovered database and click the Subclient list to assign the database to the subclient.
  7. Click OK.
  8. Click the Storage Device tab and select a Storage Policy from the available list.
  9. Click OK.

Configuring Notes Partition

A Notes partition is an instance of the IBM Domino running on a given computer. IBM Domino may be installed multiple times on the same computer, with each partition acting as an individual server.

For example, computer A is running a simple Notes database. It is decided that computer A will also host a Domino web server database. The Domino administrator could add this data to the existing Domino partition, or install another partition of IBM Domino for this new database.

During installation of the IBM Domino iDataAgent, the system detects and configures all IBM Domino partitions. If you have multiple partitions, you may add any of the detected partitions to the system during the install or add them manually later. By default, Notes partition consists of the following:

  • A default subclient
  • A transaction log subclient

On Windows

For Windows, available partitions will be automatically shown.

Use the following steps to add partitions:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database.
  2. Right-click the Notes Database and click All Tasks | Add New Partition.

    The Add New Partition dialog box appears.

  3. Under the Partition column, select the partition check box to add, and click OK.
  4. In the Backup Schedule dialog box, select one of the options for scheduling.
  5. Click OK.

On UNIX

Use the following steps to add partitions:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database.
  2. Right-click the Notes Database and click All Tasks | Add New Partition.

    The Add New Partition dialog box appears.

  3. Type a name for the new partition in the Partition Name box.
  4. Enter the path for Domino Data Directory.
  5. Type the Domino user name, select a storage policy, and then click OK.
  6. In the Backup Schedule dialog box, select one of the options for scheduling.
  7. Click OK.

Assigning Domino System Files to a User-Defined Subclient

You can assign the Domino system files, such as NLO files, server ID, and notes.ini files to a user-defined subclient. If not assigned, the system files are automatically assigned to the default subclient.

About This Task

To keep data in a consistent state, it is recommended to back up regular databases first and then back up the NLO files. Therefore, it is good to assign the NLO files, server ID and notes.ini files to a single subclient.

Before You Begin

Procedure

  1. In the CommCell Browser, click Client Computers > client > Notes Database > partition.
  2. Right-click a subclient, and then click Properties.

    The Subclient Properties dialog box appears.

  3. On the Databases tab, click Configure.
  4. On the Add/Modify Databases/Subclient Configuration for Partition dialog box, click Discover.
    • To assign a single system database to a subclient,
      1. In the Database Title column, select a SYSTEMFILES database.
      2. In the Subclient Name column, select a subclient.
      3. Click OK.
    • To assign two or more system databases to a subclient,
      1. In the Database Title column, press the CTRL key, and then click to select two or more SYSTEMFILES databases.
      2. In the Change all selected databases to list, select a subclient.
      3. Click OK.

        ATTACHMENTS\*.NLO is a relative path for the NLO files. This path automatically resolves to the actual location of the NLO files during backup.

  5. On the Storage Device tab, select a storage policy from the Storage Policy list.
  6. Click OK.

What to Do Next

Backing Up the Domino System Files

Configure to Filter Out Data from Being Backed Up

Use one of the following  methods to filter out data from being backed up.

By default, the system creates a Do Not Backup subclient. You can assign databases to this subclient so that they will not be backed up.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. Right-click the subclient, and then click Properties.
  3. Click the Databases tab, and then click the Configure button.
  4. Click Configure.
  5. In the Add/Modify databases/subclient configuration for partition dialog box click the Discover button.
  6. Select the discovered database. Under the Subclient column, select Do Not Backup.
  7. Click OK.
  8. Click OK.

Configure to Discover Newly Added Databases

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database.
  2. Right-click <Partition> and click All Tasks | Configure.
  3. In the Add/Modify databases/subclient configuration for partition dialog box click Discover.
  4. Select a database. Under the Subclient column, click to select a subclient.
  5. Click OK.

Configuring Folder Based Auto Discovery

Auto discovery can be set by specifying the folder patterns. Based on the folder patterns specified, the databases are backed up. You can apply regular expressions or wildcards patterns to filter folders and enable data protection for specific folder types.

For example you may want:

  • To include all the databases in a folder, enter a single asterisk (*) at the end of the folder path: mail\NotesVolume1\*
  • To include all the databases in all the 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\*

Procedure

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. Right-click the subclient to which you want to add databases, and then click Properties.
  3. Click the Databases tab.
  4. Select the Auto Discover Based on Folder Pattern(s) check box.

    In case of an existing subclient, if you change the Folder Pattern by changing the alphabet case, then the change will not be saved. Therefore it is recommended to create a new subclient with the correct Folder Pattern.

  5. Enter a folder pattern in regular expressions to back up databases that you want to include in the subclient.
  6. Click OK.

Excluding Files and Paths from Backups

You can use filters to exclude certain files and paths from your backup operation. These files and paths are not required for successful a backup operation and are not integral to the operation of the system or application. Filters minimize protected storage and prevents unnecessary folders (such as, junk and spam) from being backed up.

You can use regular expressions to filter files or folders. For more information, see Content, Filters, and Regular Expressions.

Follow the steps given below to exclude files and paths from backups using filters:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. Right-click the default subclient, and then click Properties.
  3. From the Subclient Properties dialog box, click the Filters tab.
  4. Click Browse, and then select the file, folder, or directory that you want to exclude from backup operations. Click Add.

    Alternatively, click Add, and then type the path to files and folders that you want to exclude from backup operations. Click OK.

  5. Click OK.

Notes:

  • You can use filters only on a default subclient. Filters cannot be used on user-defined subclients.
  • Do not run manual discovery on a default subclient if you have configured filters on it. Else, filters will not work.
  • A filter pattern (or database name) should not already be associated with any other subclient. If you associate a database to any subclient, and then provide the same database name as a filter pattern, the filter will not be honored.

Modifying an Agent, Partition or Subclient

There are several configurable properties available for your agent that can be modified from the agent, partition, or subclient level.

The following table describes the properties that can be configured from the client, agent, partition, and subclient levels.

Option

Description

Related Topics

Change Storage Policies

You can modify the storage policies in any of the following situations:

  • To include a different media for the backup operation.
  • To use a storage policy with a different retention criteria.

    You can change the storage policies from the subclient level.

  1. From the CommCell Browser, right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Select the Storage policy from the drop-down menu.
  1. Click OK.

Refer to Storage Policies.

Rename a Subclient

You can rename a subclient:

  1. From the CommCell Browser, right-click the subclient.
  2. Click Properties.
  3. Type the new name in the Subclient name field.
  4. Click OK.

 

Data Transfer Options

You can configure the available resources for transferring data secured by data protection operations from the subclient level. This includes the following:

  • Enable or disable Data Compression either on the client or on the MediaAgent.
  • Configure the transfer of data in the network using the options for Network Bandwidth Throttling and Network Agents.

    You can configure the data transfer options.

  1. From the CommCell Browser, right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Click Data Transfer Option tab.
  5. Choose the appropriate software compression option for this subclient.
  6. Select Throttle Network Bandwidth and set the required bandwidth.
  1. Click OK.

Refer to Data Compression and Network Bandwidth Throttling.

View 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 including their priority from the subclient level.

  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Select Storage Policy from the drop-down menu.
  1. Click Data Paths.

 

Configure a Subclient for Pre and Post Processing of Data Protection

You can add, modify or view Pre-processes and Post-processes for the subclient. These are batch files or shell scripts that you can run before or after certain job phases.

  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Pre/Post Process.
  4. Click one of the following phases and type the full path of the process that you want to execute during that phase. Alternatively, click Browse to locate the process (applicable only for paths that do not contain any spaces).
    • PreBackup Process
    • PostBackup Process
    • PreSnap Process
    • PostSnap Process
  5. Click OK.
  6. Select Run Post Backup Process for all attempts to run a post backup process for all attempts.
  7. For subclients on Windows platforms, Run As displays Not Selected.

    If you want to change the account that has permission to run these commands, click Change.

    1. In the User Account dialog box, select Use Local System Account, or select Impersonate User and enter the user name and password. Click OK.
    2. 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.

Refer to Pre-processes and Post-processes.

Configure Activity Control

You can enable backup and restore operations from the agent and subclient level. However, you can enable restore operations only from the agent level.

  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Activity Control, and then select or clear options as required.
  1. Click OK.

Refer to Activity Control.

Configure User Security

You can configure user security from the agent, partition or subclient level.

You can perform the following functions:

  • Identify the user groups to which this CommCell object is associated.
  • Associate this object with a user group.
  • Disassociate this object from a user group.
  1. From the CommCell browser, right-click the agent/partition/subclient.
  2. Click Properties.
  3. Click Security.
  4. 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.
  5. Click OK.

Refer to User Administration and Security.

Enable and Disable Data Encryption

When you configure encryption at the client level, it is configured automatically for all the subclients associated with all the agents installed on that client. If you want to disable or change the encryption at the subclient level, follow the steps given below:

  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Encryption.
  4. Select the desired encryption.
  1. Click OK.

Refer to Data Encryption.

View Software Version

At the client level, the Version tab of the Properties dialog box displays the software version of the component.

  1. From the CommCell Browser, expand Client Computers.
  2. Right-click the appropriate client, and then click Properties.
  3. Select the Version tab.
  1. Click OK.

 

CommCell Configuration Report

The CommCell Configuration Report provides the properties of the CommServe, MediaAgents, clients, agents, subclients, and storage policies within the CommCell based on the selected filter criteria.

  1. On the CommCell Console menu bar, select the Reports tab.
  2. Click Configuration.

    The Report Selection dialog box appears.

  3. Click Run.

Refer to CommCell Configuration.

Deleting an Agent, Partition or Subclient

The following sections describe the steps involved in deleting an agent or subclient.

When you delete a partition or backupset, the associated data is logically deleted and you can no longer access the corresponding data from CommCell Console for recovery purposes.

For information on how to recover data if you accidentally delete an entity, see Recovering Data Associated with Deleted Clients and Storage Policies.

Deleting an Agent

You need to uninstall or de-configure the agent software from the client computer before deleting from CommCell Browser. After you delete the client software, you can either leave the corresponding data intact for appropriate action or you can remove the data immediately. If you choose to remove the data immediately, you must delete the agent from the CommCell Browser. If you delete the agent, all of the agent's data is irretrievably lost.

  • You cannot delete an agent while operations for that agent are running.
  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the <Agent>, and then click All Tasks | Delete.
  3. A confirmation message is displayed with the following message:

    This operation will permanently delete the data backed up from this level and it cannot be restored.

  4. Click OK to continue with the deletion operation or click Cancel to abort the deletion.

Deleting a Partition

Consider the following before deleting a partition:

  • When you delete a specific partition all job schedules and job histories that pertain to any of the levels within the deleted partition are deleted.
  • You cannot delete a partition if it is being backed up. Attempts to delete a partition under such conditions cause the deletion to fail. If a backup is in progress, either wait for the backup to complete or kill the backup job using the Job Controller. Once the backup is no longer in progress, you can delete the partition.
  • You cannot delete a partition if there is only one partition present for an agent. To delete the final partition, you must remove the agent software from the client computer.

Deleting a Partition on Windows

Use the CommCell Console to delete a partition on a Windows client:

  1. From the CommCell Browser, right-click the <Partition> that you want to delete, and then click All Tasks | Delete.
  2. Click Yes to confirm the deletion. (Clicking No cancels the deletion and retains the node.)
  3. Type the requested phrase in the Enter Confirmation Text dialog box and click OK. This should delete the partition.

Deleting a Partition on UNIX

You cannot delete a partition on a UNIX client using the CommCell Console.

On UNIX, you can delete a partition using the command line interface.

Deleting a Subclient

Consider the following before deleting a subclient:

  • You cannot delete a default subclient.
  • Schedules associated with the subclient are also automatically deleted.
  1. From the CommCell Browser, navigate to Client Computers | <Client> | <Agent> | <Partition>.
  2. Right-click the <subclient> that you want to delete, and then click Delete.
  3. 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.

Last modified: 8/28/2018 5:05:47 AM