Client - How To

Table of Contents

Enable or Disable Operations

Required Capability: See Capabilities and Permitted Actions

Level Capability
CommCell Administrative Management with CommCell level association
Client Computer Group Administrative Management with Client Computer Group level association
Client Agent Management with Client level association
Agent Agent Management with Agent level association
Subclient Agent Management with Subclient level association

To enable or disable all the data management, data recovery and data aging operations at the client level, complete the following tasks.

  1. From the CommCell Browser, expand Client Computers.
  2. Right-click the appropriate client computer and then click Properties.
  3. Click the Activity Control tab.

    By default, Enable Data Management, Enable Data Recovery and Enable Data Aging check boxes are selected.

  4. To disable, clear Enable Data Management, Enable Data Recovery and Enable Data Aging check boxes.
  5. Click OK.

    If the data management and/or data recovery operations are disabled, client and/or agent icon changes in the CommCell Browser.

Check Client Connectivity

Required Capability: None.

To check client connectivity:

  1. From the CommCell Browser, right-click the icon of the client computer whose connectivity you want to check.
  2. Click All Tasks, and then click Check Readiness.
  3. A message will be displayed indicating whether or not the client is accessible in the CommCell.
  4. Click Ok.

Configure the Proxy for Exchange

Before You Begin

Required Capability: Capabilities and Permitted Actions

To configure the Proxy for Exchange client:

  1. From the CommCell Browser, right-click the icon of the client computer hosting the Exchange Server whose proxy client needs to be configured, and then click Properties.
  2. From the Advanced tab of the Client Computer Properties dialog box, select the name of the proxy client from the Proxy for Exchange list.

    NOTES

    • For 32-bit on 64-bit configurations, select the client name of the instance containing the 32-bit Exchange agents.
    • For off-host proxy configurations, select the client name of the off-host proxy computer.
  3. Click OK to save your changes.

Viewing the Web Server URLs

Before You Begin

Review Web Server URLs.

Required Capability: Capabilities and Permitted Actions

To view the Web Server URLs for the client:

  1. From the CommCell Browser, right-click the icon of the client computer, and then click Properties.
  2. Click Advanced and click the Web Server URLs tab.

    The end user or compliance search URLs are displayed depending on the component installed on the client.

  3. If you have multiple Web Servers installed in the CommCell group, in the Web Server box, select the Web Server to be used for the client search operations.
  4. Click OK to save your changes.

Suspend Use of a Client Computer Temporarily

Required Capability: Capabilities and Permitted Actions

To suspend use of a client computer temporarily:

  1. Create a New Scratch Pool that does not contain any media, and name it No_Media. Note that a scratch pool with no media associations does not harm any existing configurations, nor does it misuse media.
  2. Create a Storage Policy (standard), name it No_Backups, and point it to the No_Media scratch pool.
  3. Disable Operations for the client that you are temporarily disabling.
  4. Verify that the Queue Jobs if Activity Control is Disabled option is disabled. This will reduce the number of queued jobs in the Job Controller.
  5. Re-point all the client's subclients to the No_Backups storage policy. When a user changes the storage policy association of a subclient, retention cycles are set to zero (0), therefore, only the retention days must be exceeded for data to be aged. In this case, the data in the storage policy to which the client's subclients were originally pointing to will age accordingly. Note that if the client computer's activity is re-enabled, you can point the subclients back to their original storage policy.
  6. To resume client activity: Enable Operations for the client, and point the subclients back to their original storage policy.

NOTES

  • This feature does not require a user to uninstall client software; therefore, no licenses are released during this process.
  • Any scheduled jobs associated with the suspended client will cause job failures when initiated. This is normal behavior. Once client activity is re-enabled, these scheduled jobs will no longer cause job failures.

Change the Job Results Path of a Client

Before You Begin

Review Using UNC Paths for Job Results Directory

Required Capability: Capabilities and Permitted Actions

To change the job results path of a client:

  1. From the CommCell Browser, right-click the icon of the client computer whose job results path you want to change, and then click Properties.
  2. Click Advanced.
  3. Click the Job Configuration tab, and then click User Name/Password to establish or change the Impersonate User account to access the Job Results Directory. If you do this, click OK once you have administered the account.
  4. Type a new job results path in the Job results path box.

    You can also click Browse to browse to a new job results path from the Browse for Job Result Path dialog box. Click OK.

  5. Click OK to save your changes.

Change the User Account for Accessing the Job Results Directory

Required Capability: Capabilities and Permitted Actions

To change the user account for accessing the Job Results Directory for the client:

  1. From the CommCell Browser, right-click the icon of the client computer whose job results path user account you want to change, and then click Properties.
  2. Click Advanced.
  3. Click the Job Configuration tab and then click User Name/Password.
  4. In the Change User Account dialog box, enter the appropriate User Impersonation account information.
  5. Click OK to save your changes.

Change the Retention of the Job Results of a Client Computer

Required Capability: Capabilities and Permitted Actions

To change the retention of the job results of a client computer:

  1. From the CommCell Browser, right-click the icon of the client computer whose job results retention criteria you want to change, and then click Properties.
  2. Click Advanced.
  3. Click the Job Configuration tab, and then select the number of days job results should be pruned from the Prune job results after box.
  4. Select a disk capacity after which job results should be pruned from the Prune job results when disk capacity reaches box.
  5. Click OK to save your changes.

Set the Job Priority of a Client

Required Capability: Capabilities and Permitted Actions

To set the priority of a client:

  1. From the CommCell Browser, right-click the client computer icon, and then click Properties.
  2. Click Advanced.
  3. Click the Job Configuration tab, and then enter a new client priority value in the Job Priority (0-9) box. Remember that the lower the value, the higher the priority.
  4. Click OK to save your changes.

Specify CDR Log File Location on Source and Destination Computers

Before You Begin

  • On Windows, this procedure can be performed on both the source and destination computer(s); On UNIX, this procedure only applies to a source computer.

Required Capability: Capabilities and Permitted Actions

To specify a location for the CDR log files:

  1. In the CommCell Browser, right-click the Client on either a source or destination computer, and select Properties.
  2. In the Advanced tab of the Client Computer Properties screen, type or browse to path for CDR Log File Location.
  3. Click OK to save your changes.

View the Data Recovery Job History of a Client

Use the following steps to view the restored items associated with a job:

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

    The Job History Filter dialog box appears.

  1. From the Job History window, right-click the job and then click View Restore Items and select from the type of items to view.
  2. The Restored Files window will display the selected type of restored items for the job.
  3. Click OK.

View the Log Files of a CommServe, MediaAgent, or Client Computer

Required Capability: See Capabilities and Permitted Actions

To view the log files of a CommServe, MediaAgent, or client computer.

  1. From the CommCell Browser, right-click a CommServe, MediaAgent, or client computer, click View, and then click Log Files. The Select the Log File to Open window displays.
  2. To see a specific log file, either select the log file name from the list or type the name of the log file in the field provided. (In the Files of type field, Log Files (*.log) is displayed by default.) Click Open. The contents of the log file are displayed.

View the Log Files of a CommServe, MediaAgent, or Client Computer

Required Capability: See Capabilities and Permitted Actions

To view the log files of a CommServe, MediaAgent, or client computer.

  1. From the CommCell Browser, right-click a CommServe, MediaAgent, or client computer, click View, and then click Log Files. The Select the Log File to Open window displays.
  2. To see a specific log file, either select the log file name from the list or type the name of the log file in the field provided. (In the Files of type field, Log Files (*.log) is displayed by default.) Click Open. The contents of the log file are displayed.

Delete a Client Computer

Before You Begin

  • Before deleting the client computer for most agents, remove the base client software.
  • In order to remove the base client software, there must be no agents installed on the client computer.

Required Capability: Capabilities and Permitted Actions

To delete a client computer:

  1. From the CommCell Browser, right-click the <Client Computer> that you want to delete, and then click All Tasks | Delete.

    If the Delete command is not available, then you have not successfully deleted the base client software from the client computer. Right-click the <Client Computer> and then click All Tasks | Release License for Client.

    Click Yes to confirm the license release. The client icon in the CommCell Browser is displayed as deconfigured (or grayed out). After this, you can proceed to delete the client.

  2. A confirmation message appears. Click Yes to delete the client computer.

    If you click Yes, the backup data that corresponds to the selected client computer is deleted. Consequently, you will not be able to browse or restore this data. The client computer icon is removed from the CommCell Browser.

Delete a Pseudo-Client

Before You Begin

  • For NAS clients, the client must first be deconfigured before you can delete it. For more information, see Deconfiguring Agents.

Required Capability: Capabilities and Permitted Actions

To delete a pseudo-client:

  1. From the CommCell Browser, right-click the icon of the pseudo-client that you want to delete, click All Tasks and then click Delete from the short-cut menu.

    For a NAS client, if the Delete command is not shown, you have not deconfigured the client, and the Deconfigure command will be shown instead; refer to Deconfiguring Agents. (There is no base client software for a NAS Client.)

  2. A confirmation message is displayed. Click OK, type the supplied phrase in the Enter Confirmation Text dialog box, and click OK. The pseudo-client icon should be removed from the view.

Add a NAS Client

  1. From the CommCell Browser, right-click Client Computers, point to New Client | File System, and then select NAS.

  2. Enter the NAS file server in the NDMP Server Hostname field.
  3. Enter the user account credentials used to access the storage device in the NDMP Login field.
  4. In the NDMP Password field, enter the password for the login account, and then click Detect.

    The system automatically populates the Vendor, Firmware Revision, and Listen Port information.

  5. Click OK.

    Depending on the File Server you are using, your screen may look different from the example shown.

    Any NAS storage device that will be used for backing up secondary storage data (Vault, Mirror, or backup copy) must be configured as a NAS Client in the CommCell with the same name that is used by the OCUM server to communicate to the secondary NAS file server.

  1. In the CommCell Browser, confirm that the NAS client was added under Client Computers.

View the Software Install Folder

To view the Software Install folder:

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

    The Software Install Directory displays the software installation folder on the local computer.

Store Software Locally Before Installation

To Store Software Packages and Updates Locally before Installation:

  1. From the CommCell Browser, right-click the Client or MediaAgent for which you wish to configure the Update installation, and then click Properties.
  2. Click the Version tab.
  3. To store the software locally before installation, specify a local folder in the Store Software Locally field in which the software packages and updates must be stored. This serves as a temporary cache area. By default, this location will be set to SnapProtect install directory.

    • The updates will be stored exactly under SnapProtect directory.

      For example:  C:\Program Files\Cmvt\SnapProtect

    • The software packages will be stored one directory up from the SnapProtect directory.

      If we consider the above example, the software packages will be stored under the following folder:

      C:\Program Files\Cmvt\

  4. Click OK to save the information.

Associate or Disassociate a User Group with a CommCell Object

Required Capability: See Capabilities and Permitted Actions

To associate or disassociate a user group to a CommCell entity:

  1. From the CommCell Browser, click the CommServe, client computer group, client computer, agent, MediaAgent, Library, Storage Policy, backup set, subclient, or Shelf media, and then select Properties.
  2. From the Security tab, 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.
  3. Click OK.

Associate or Disassociate a Client with a Client Group

Required Capability: Capabilities and Permitted Actions

To associate or disassociate a client to a client group:

  1. From the CommCell Browser, right-click the icon of the client computer for which you would like to configure the Web Server URLs, and then click Properties.
  2. From the Groups tab of the Client Computer Properties dialog box, associate a client to a client group or remove the association from a group.
  3. Click OK to save your changes.

Enable or Disable Robust Network Layer

During an installation of a CommServe, a Client or a MediaAgent, the Robust Network Layer is automatically enabled by default.

Use the following steps to disable (or re-enable) Robust Network Layer:

  1. From the CommCell Console, right click a client and select Properties. Click the Advanced tab.

    Alternatively, right click a MediaAgent and select Properties. Click the Control tab.

  2. Select the Enable retry on network errors checkbox to enable the feature. Clear the checkbox to disable the feature.
  3. Click OK.

Change Robust Network Layer Configuration

During the data transfer phase of a backup operation, which runs on a MediaAgent and client, the Job Manager will periodically need to communicate directives to the CommServe. If during this time, a loss of network connectivity is detected, the Robust Network Layer enables the Job Manager to keep the job in a Running (Cannot be verified) job state, visible in the Job Controller, for up to 20 minutes while continuously checking for network connectivity at set intervals, e.g., every 30 seconds.

The default amount of time the system will hold a job in a running state when there is loss of connectivity is up to 20 minutes.

You can modify the Robust Network Layer configuration as follows:

  1. From the CommCell Console, right click a client and select Properties. Click the Advanced tab.

    Alternatively, right click a MediaAgent and select Properties. Click the Control tab.

  2. Select the Enable retry on network errors checkbox to enable the feature.
    • In Retry Frequency (seconds) select or type the time interval at which the Job Manager will check for network connectivity. The default value is set at 30 seconds.
    • In Retry Count select or type the number of times the Job Manager will check for network connectivity. The default value is set at 40.

    Clear the checkbox to disable the feature.

  3. Click OK.

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.