V11 SP8
Loading...

Configuring User-Defined Subclients

A default subclient is created when you install the agent. This default subclient contains all the devices along with supported file system types.

You can add additional subclients as needed to back up data within the backup set. The default subclient, skips the content you add to other subclients under the same backup set.

Best Practice: If the subclient contains /QSYS.LIB, exclude contents from the subclient. For more information see, QSYS.LIB Subclient Backup Exclusions.

To speed up the backup process and to avoid backup failures, you can filter out items which consistently fail, such as locked system objects, system libraries, and operating system objects. For information on how to set filters for backups, see Defining Filters.

After you add the failed objects to the filter, run a full backup to remove them from backups.

About This Task

The following subclient content options are available.

  1. Commvault pre-defined content that consists of one or more of the following data:
    • Security objects
    • Configuration objects
    • IBM system libraries
    • User libraries
    • Documents, folders and distribution objects
    • IBM directories and the user objects that are contained in the directories
  2. User defined content is a set of folders and directories that you define.

Procedure

  1. From the CommCell Browser, expand Client Computers > client > Proxy Client File System > backup_set.
  2. Right-click the backup_set, point to All Tasks, and then click New Subclient.

    The Subclient Properties dialog box appears.

  3. On the General tab, in the Subclient Name box, type a unique subclient name.
  4. On the Content tab, select the data that you want to back up.

    For information on the content options, see IBM i File System Agent Subclient Properties (Content).

    • To include pre-defined data, select Subclient content and then select check boxes for the data to include.
    • To add directories, folders, libraries and objects to the backup content select Custom subclient content and then select the directories, folders, libraries and objects that you want to include.

      To back up all specified libraries at the object level select the Backup library content(s) as objects (Save while active) option. When you select this, the software makes the SYNCLIB option unavailable.

      You can use wildcards to define content for a subclient. For a list of supported wildcards,  see Supported Wildcards for the IBM i File System Agent Agent.

      Notes:

      If the file or directory name that you want to add to the content contains a wildcard character, you must add an escape ("\") before the wildcard character.

      The Network File System (NFS) is not included in the backup. You must manually add the directory.

      Both libraries and objects

      When a symbolic link is included in the subclient content, the software displays the target of the symbolic link and the link.

      For information on the SAVACT options, see the IBM manual. The Commvault software does not support the *SYSDFN option.

    • The backups include the libraries and objects that are included in the subclient content.

      You can back up all IASP libraries by configuring a custom content path that is similar to “/<IASP_Name>/QSYS.LIB”.

      You can back up any IASP directories by configuring a custom content path that is similar to “/<IASP_Name>/<Dir_Name>”.

  5. On the Storage Device tab, in the Storage Policy list, click a storage policy name to associate with the subclient.

    Tip: To create a new storage policy, click Create Storage Policy and follow the instructions in the storage policy creation wizard.

    For information on storage policy creation, see Storage Policy - Getting Started.

  6. On the Advanced Options tab, configure the advanced backup options.

    For additional information on the advanced options, see IBM i File System Agent Subclient Properties (Advanced Options).

    • To set the number of simultaneous backup data streams that the subclient can use, enter the number in the Number of Data Readers box.
    • To allow multiple data reads for a single UNIX mount point during backups on this subclient, select the Allow multiple data readers within a drive or mount point check box.
    • To specify a different operating system version on the destination client, enter the version number in the Target release for backup data box.
    • To include library objects in the backup, in the Backup library objects section, check the box associated with the object that you want to include in the backup.
  7. Optional: Select the subclient options.
    Expand All

    Set the option to have incremental backups include files that have changes in the ctime or mtime timestamp

    The ctime timestamp indicates when the file properties (for example the file owner) were modified.

    The mtime timestamp indicates when the file contents were modified.

    On the General tab, in the Incremental backup should use section:

    • To include files with a modified mtime timestamp in the incremental backup, select the Use mtime check box.
    • To include files with a modified ctime timestamp in the incremental backup, select the Use ctime check box.

    Configure a process to run before or after the backup

    Run scripts before or after the backup.

    Enter the full path for the pre- and post-scripts.

    1. Create the script.
    2. Click Advanced.

      The Advanced Subclient Properties dialog box appears.

    3. On the Pre/Post tab, in the PreBackup Command box, type the full path name for the script.
    4. On the Pre/Post tab, in the PostBackup Command box, type the full path name for the script.
    5. To run the post-backup process regardless of the job's outcome, select the Run Post Backup Process for all attempts check box.

    Configure multiple data streams for backup operations

    When you configure multiple data streams, the subclient data is distributed across the streams and transmitted in parallel to the storage media, which makes backups more efficient.

    1. Click Advanced.

      The Advanced Subclient Properties dialog box appears.

    2. On the Advanced Options tab, enter the number of data streams to use for backup operations in the Number of Data Readers box.

      Note: The number of the streams associated with the subclient storage policy must be greater than or equal to this value.

    3. Select the Allow multiple data readers within a drive or mount point check box.
    4. Click OK to close the Advanced Subclient Properties dialog box

    Set filters to exclude data from backups

    You can use filters to exclude system-related data, that can cause the jobs to fail, from backups.

    If there is a file or sub-directory that is an exception to the excluded data, you can create exceptions to the excluded files.

    Configure the Save while active options

    Configure the options for the backup library content.

    1. Click Advanced.

      The Advanced Subclient Properties dialog box appears.

    2. On the Save While Active tab, select the options.

      For information on the Save While Active feature and options, see Subclient Properties (Save While Active).

    3. Click OK to close the Advanced Subclient Properties dialog box
  8. Click OK to close the Subclient Properties dialog box