Job Results Directory - Advanced

Table of Contents

Changing the Path of the Job Results Directory

The Job Results directory stores the job result files created when a job is initiated. By default, the Job Results directory is created when the software is installed. For example, the directory may be software_installation_directory\iDataAgent\JobResults. You can change this location by specifying a new path. If you change this path, all existing job results are copied to the new path.

Notes:

  • The job results directory cannot reside on a compressed drive or in the following folders:
    • <software install folder>/Base
    • Log Files Folder
    • <software install folder>/GUI
  • You cannot change the path of the Job Results directory for laptop clients.

Use the following steps to change the path of the Job Results directory:

  1. From the CommCell Browser, go to Client Computers.
  2. Right-click the client and click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Job Configuration tab.
  5. In the Job Results Directory box, type the new path or click Browse to select the path.
  6. Click OK twice to close the properties dialog boxes.

Using UNC Paths for Job Results Directory

UNC paths are supported for job results directory by the SharePoint Server Agent. If configured in a Cluster Continuous Replicator environment, the UNC paths are also supported by the Windows File System Agent and the Exchange Database Agent 2007 and later.

When assigning UNC paths, the designated directory must be ONE level below the directory which is shared for this purpose.

Examples:

\\machine1\<share_name>\job_results\ is shared. Then specify \\machine1\<share_name>\job_results\job_results_1 as the job results directory.

\\machine1\<share_name>\job_results\ is shared. Then specifying \\machine1\<share_name>\job_results as the job results directory is not supported.

Use the following steps to use a UNC path for the Job Results directory:

  1. From the CommCell Browser, go to Client Computers.
  2. Right-click the client and click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Job Configuration tab.
  5. In the Job Results Directory box, type the UNC path.
  6. Click OK twice to close the properties dialog boxes.

Calculating the Size Required for Job Results Directory

The size of the Job Results Directory can be customized if needed.

When you are creating a new Job Results Directory use the following steps to calculate the size of the Job Results Directory:

  1. For backup jobs, identify the value for the directory size of the subclients, to be calculated as below:

    6 * (number of files) * (subclient average filename size)

    Assume you have the following for all your subclients:

    • 2000 files like /dir1/dir2/filename1. The filename size of these files is 20.
    • 1000 files like /dir1/dir2/dir3/filename2. The filename size of these files is 25.

    Using the values above, you can find that:

    • the number of files is 3000
    • the subclient average filename size is

      (20*2000 + 1000*25)/3000 = 21.67

    So, you can conclude that the directory size of the subclients is:

    6*3000*21.67 = 390060 bytes = 0.372 MB

  2. For restore jobs, identify the value for the average size of a restore job, to be calculated as below:

    1.5 * (number of restore files) * (average filename size)

    Assume you have the following;

    • 1500 restore files like /dir1/dir2/filename1. The filename size of these files is 20.
    • 1000 restore files like /dir1/dir2/dir3/filename2. The filename size of these files is 25.

    Using the values above, you can find that:

    • the number of restore files is 2500
    • the average filename size is

      (20*1500 + 1000*25)/2500 = 22

    So, you can conclude that the average size of a restore job is:

    1.5*2500*22 = 82500 bytes = 0.079 MB

    For system state restore jobs on client computers using Windows Vista or later, the job results folder requires about 15 to 20 GB of additional disk space. After the restore is complete and the computer is restarted, the allocated space for system state restore is made available.

  3. For each subclient configured for SnapProtect operations, identify the value for the size of the snapshot copy job, to be calculated as below:

    7 * (number of files) * (subclient average filename size)

    Assume you have the following for all your SnapProtect subclients:

    • 1000 files like /dir1/filename1. The filename size of these files is 15.
    • 500 files like /dir1/dir2/filename2. The filename size of these files is 20.

    Using the values above, you can find that:

    • the number of files is 1500
    • the subclient average filename size is

      (15*1000 + 500*20)/1500 = 16.67

    So, you can conclude that the directory size of the subclients is:

    7*1500*16.67 = 175035 bytes = 0.167 MB

  4. If using deduplication, identify the value for the size of the Source Side Database.

    This value is controlled from the Client Side Deduplication tab of the client properties in the CommCell Console. The default size is 4 GB.

    Assuming the default size is being used, then 4 GB are 4096 MB.

  5. Using the size values identified in the previous steps, obtain the required space for the Job Results Directory, to be calculated as below:

    directory size of the subclients + (average size of a restore job * A) + (size of the snapshot copy job * B) + size of the Source Side Database

    where A is the number of restore results to be stored for longer time and B is the number of snapshot copy jobs to be run.

    Assume you plan to have:

    20 restore results to be stored for longer time

    10 snapshot copy jobs to be run

    Using the size values from the examples above, the required space is:

    0.372 + 0.079*20 + 0.167*10 + 4096 = 4099.62 MB

The minimum space required for the Job Results directory is the size value obtained from Step 1. If using SnapProtect backups, the minimum space required is the addition of Step 1 and Step 3.

Changing the User Account for Accessing the Job Results Directory

You can change the User account to access the Job Results Directory for Windows clients. The Impersonate User Account should have the following privileges to access the Job Results Directory:

  • The specified user should have Read/Write permissions to the product installation folders. If the specified user belongs to another domain, ensure that the necessary trust relationships are established between the two domains.
  • The specified user should have full permissions (registry rights) to the following registry key: \\HKEY_LOCAL_MACINE\SOFTWARE\CommVault Systems.
  • If UNC paths are used for job results and subclient contents are also specified as UNC paths, the user impersonation account used for the job results directory must have access to both paths.

For the File System iDataAgent, the user impersonation occurs only once; therefore, the user impersonation account specified for the job results directory will take precedence and will be used to back up the contents of the UNC path included in the subclient content.

On a Windows client computer, use the following steps to change the user account for accessing the job results directory for the client:

  1. From the CommCell Browser, go to Client Computers.
  2. Right-click the client and click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Job Configuration tab.
  5. In the Job Results Directory for Windows Clients section, click User Name/Password and type the following:
    1. In the User Name box, type the new user name.
    2. In the Password box, type the new password and in the Confirm Password box, re-type the password.
    3. Click OK.
  6. Click OK twice to close the properties dialog boxes.

Setting the Minimum Free Space for Job Results Directory

The low space threshold limit is the minimum free space to be maintained under the job results folder. By default it is of 500 MB size. If the amount of free space in the job results folder falls below the specified amount, an event message is generated. The Clients (Disk Space Low) alert is also generated, if configured.

Use the following steps to change the low space threshold limit for the Job Results directory:

  1. From the CommCell Browser, go to Client Computers.
  2. Right-click the client and click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Job Configuration tab.
  5. In the Low space threshold on job results folder (MB) box, type the value.
  6. Click OK twice to close the properties dialog boxes.

Configuring the Retention Criteria for Job Results

The job results for data protection and recovery operations can be pruned:

  • For Windows machines, job results are pruned from the CV_JobResults\2 folder. The default location for the CV_JobResults folder is software_installation_directory\iDataAgent\JobResults.
  • For UNIX machines, job results are pruned from the CV_JobResults directory. The default location for the CV_JobResults directory is software_installation_directory/iDataAgent/jobResults.

To change the default location, see Changing the Path of the Job Results Directory.

Setting the Time Period for Pruning Job Results

By default, job results are pruned after 7 days. You can change the number of days the job results for data protection and recovery operations are retained.

Procedure

  1. From the CommCell Browser, go to Client Computers.
  2. Right-click the client and click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Job Configuration tab.
  5. In the Prune job results after box, type or select the number of days to prune job results.
  6. Click OK twice to close the properties dialog boxes.

Setting the Disk Capacity for Pruning Job Results

By default, job results are pruned when disk capacity reaches 90%. For this setting, disk capacity refers to the combined disk usage of all data (including applications) stored on the disk, not just the portion used for job results. (The disk referred to is the disk on which the job results of the client computer are stored (probably a local disk).) You can update the disk capacity threshold to change when job results for data protection and recovery operations are pruned.

Procedure

  1. From the CommCell Browser, go to Client Computers.
  2. Right-click the client and click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Job Configuration tab.
  5. In the Prune job results when disk capacity reaches box, type or select the disk capacity percentage at which job results can be pruned.
  6. Click OK twice to close the properties dialog boxes.