Loading...

Agents - OES File System - How To

Table of Contents

Browse Latest Data

Create Backup Sets and Archive Sets

View Job History Details

Change Account for Restoring to Mapped or Shared Network Drives and Restricted Directories

View the Software Version

Browse Latest Data

The option to browse the backup data provides the facility to view and restore the data that was backed up. The following sections explain how to browse the backup data.

Follow the steps given below to view the latest data backed up by a backup set:

  1. In the CommCell Browser, navigate to Client Computers > client > Agent.
  2. Right-click a backup_set, then click All Tasks > Browse and Restore.
  3. Click OK.

The latest data backed up by all the subclients is displayed in the Client Browse tab.

Create Backup Sets and Archive Sets

  1. From the CommCell Browser, locate the correct client computer node, right-click the iDataAgent, Agent or instance node (depending on your agent's functionality) for which you want the backup set/archive set created, select All Tasks and then click Create New Backup Set or Create New Archive Set.
  2. For most agents, from the Create New Backup Set or Create New Archive Set dialog box, enter a New Backup Set Name or New Archive Set Name (up to 32 characters) of the backup set/archive set that you want to create. For the DB2 or DB2 MultiNode iDataAgent, from the same dialog box, click the desired database (backup set) name under Available DB Names and move this name under Selection.

    NOTES

    • For DB2 or DB2 MultiNode, to prevent archive log backup failures, ensure that the name that you select is the actual name of the database and not the alias name for the database. If the database name and the corresponding alias name are different, both names are displayed under Available DB Names; if both names are the same, the name that is displayed is the database name. To find out about database names and their aliases, run the following command as a DB2 or DB2 DPF or DB2 pureScale instance owner on the DB2 or DB2 MultiNode client: db2 list db directory.
  3. Where applicable, if you want to designate this backup set/archive set as the default backup set/archive set, select Make this the Default backup set or Make this the Default Archive Set; otherwise, leave the check box cleared.
  4. For most agents, verify that the storage policy copy associated with the default subclient is the storage policy that you want. If you want to select a different storage policy, click the storage policy box and select the one you want from the list. If the agent supports a system-state subclient, repeat this step for that subclient. For the DB2 or DB2 MultiNode iDataAgent, to establish a storage policy for all the log files, click the storage policy in the list provided.
  5. Where applicable, if you want to create additional subclients within this backup set/archive set:
    • Click Add.
    • Follow Create a New Subclient procedure.
    • Repeat this step for each additional subclient that you want to define within this backup set/archive set.
    • When all subclients have been added, click OK.
    • A message will advise you to schedule backups for your new backup set. It is recommended that you elect to set a schedule now. You can also associate this backup set/archive set 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 (Agent, Client, or Client Computer Group) the schedules defined in the Schedule Policy will be automatically applied to the new backup set/archive set. See Schedule Policy for more information.

      If you want to associate this backup set/archive set 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 have selected to define a schedule for this backup set/archive set:

      • Click Schedule.
      • If applicable, from the Backup Options dialog box, select the type of backup that you want to schedule.
      • If you want to set Advanced Backup/Archive Options, click Advanced.
      • After selecting the backup 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 backup/archive schedule at this time, click Do Not Schedule, and then click OK.

    The new backup set/archive set is displayed in the CommCell Browser.

View Job History Details

Use the following steps to view the details of a job:

  1. In the CommCell Browser, right-click the appropriate entity and click View > Job History.

    The Job History Filter dialog box appears.

  2. Click OK.
  3. From the Job History window, right-click the job and then click View Job Details.

    The Job Details dialog box appears, displaying detailed job history.

  4. Click OK.

Change Account for Restoring to Mapped or Shared Network Drives and Restricted Directories

Required Permissions: See Permissions and Permitted Actions

To change a user account for restoring to mapped/shared network drives and restricted directories:

  1. From the CommCell Browser, expand the tree to view the desired level icon for the affected agent. Then right-click the icon and click All Tasks from the short-cut menu.
  2. Click the appropriate Browse or Restore option. Then populate, select, and click as appropriate to access the Restore Options (for All SelectedItems) dialog box.
  3. From the Restore Options (for All Selected Items) dialog box, click Advanced.
  4. From the Advanced Restore Options dialog box, select Impersonate Windows User. Then type the appropriate user name and password.
  5. Click OK to save the settings.

View the Software Version

To view the Software Version:

  1. From the CommCell Browser, click the CommServe, Client, Agent, MediaAgent, or Enabler for which you wish to view the version, and then click Properties.
  2. Click the Version tab.

    The component version and post release service pack, additional updates and missing updates are displayed.

Create a New Subclient

Before You Begin

  • 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.
  • 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.
  1. 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.
  2. Click the General tab of the Subclient Properties dialog box and type the name (up to 32 characters) of the subclient that you want to create.
  3. Select other options from the General tab as appropriate for the agent.
  4. Click the Content or Databases tab of the Subclient Properties dialog box and Configure Subclient Content as appropriate for your agent.
  5. For all agents, 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 MultiNode iDataAgents, you can also change the number of data backup streams. For the DB2 MultiNode 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.
  6. Optionally (if supported for your agent) you can:
  7. Click OK to save the subclient configuration.
  8. A message 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.

Configure Subclient Content

Before You Begin

  • 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 and the Exchange Mailbox Archiver Agent: 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 or archived unless they are discovered manually and assigned to a subclient.
  • SharePoint Server Agent: 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.
  • Notes Document iDataAgent: Review Assigning Restore View Names to Newly-discovered Databases
  • Caution Against Reconfiguring Default Subclient Content

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.

  1. From the CommCell Browser, right-click the subclient for which you want to configure content, click All Tasks (if applicable) and then click Properties.
  2. Follow the procedure below that is applicable for your agent:
    • For File System, Active Directory, File Archiver, the Exchange Mailbox Archiver Agent, and SharePoint Server Agent 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, and SharePoint Server Agent: 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 Unix File Systems, you can enter the mount point of an NFS-mounted file system, see the Notes section below for examples.
      • For the Exchange Mailbox Archiver Agent: 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 Enable Apple 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 Exchange Mailbox and the Exchange Mailbox Archiver Agent, follow the procedure to Discover and Assign New Mailboxes or Assign Mailboxes to Another Subclient.
    • For DB2, DB2 MultiNode, the Exchange Database Agent, 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 MultiNode 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 Database Agent: 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 Sybase iDataAgent, follow the procedure to Manually Discover Databases.
      • For the MySQL iDataAgent, follow the procedure to Advanced Configuration - MySQL iDataAgent.
    • 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:
  3. Click OK to save your content configuration.

NOTES

  • 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 and the Exchange Mailbox Archiver Agent: 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 Agent: 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.

 

Last modified: 1/18/2018 10:18:19 AM