Client - How To

Topics | How To | Related Topics


Enable or Disable Operations

Browse the Latest Data

Check Client Connectivity

Configure Data Interface Pairs

Configure the Client for Data Encryption

Configure the Proxy for Exchange

Configure the Search Server URLs

Configure Deduplication Options for the Client

Release License for a Client

Suspend Use of a Client Computer Temporarily

Change the Job Results Path of a Client

Change the User Account for Accessing the Job Results Directory

Change the Retention of the Job Results of a Client Computer

Set the Job Priority of a Client

Specify CDR Log File Location on Source and Destination Computers

View Data Interface Pairs Configured for the Client

View the Data Recovery Job History of a Client

View the Data Protection Job History of a Client

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

Delete a Client Computer

Delete a Pseudo-Client

Delete Data Interface Pairs

Create a DB2 DPF Client

Add a NAS Client

View the Software Install Folder

For remote clients:

Associate or Disassociate a User Group to a Client

Associate or Disassociate a Client to a Client Group

Enable/Disable Robust Network Layer

Change Robust Network Layer Configuration

View the Software Version (For CommServe, MediaAgent, Client and/or Agent)


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 activity control at the CommCell, client computer group, client, agent, or subclient levels:

  1. From the CommCell Browser, right-click the CommServe, client computer group, client computer, agent, or subclient, and then click Properties from the short-cut menu.
  2. From the Activity Control tab of the associated Properties dialog box, select or clear option(s), as desired.
  3. Click OK.
note.gif (292 bytes) Disabled data management and/or data recovery operations are displayed with client and/or agent icon changes in the CommCell Browser. For a comprehensive list of all icons in the CommCell Console, see CommCell Console Icons.

Browse the Latest Data

The following procedure can be used to browse data from the client, agent, instance, backup set, replication set, or subclient level, depending on the functionality of a given agent.

Required Capability: See Capabilities and Permitted Actions

To browse the latest data:

  1. From the CommCell Browser, right-click the level whose data you want to browse, click All Tasks, and then click the Browse/Browse Backup Data option from that level.
  2. From the Browse Options dialog box, click OK to execute the browse using the Browse the Latest Data option.

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 Data Interface Pairs

Before You Begin

Required Capability: Capabilities and Permitted Actions

To configure data interface pairs:

1. From the Tools menu in the CommCell Console, click Control Panel and then double-click Data Interface Pairs.

The Data Interface Pairs Wizard guides you through the process of creating Data Interface Pairs between any two computers. Click Next to continue.

  Alternatively, you can also configure data interface pairs from the client computer:
  • From the CommCell Browser, right-click the <Client> for which you wish to configure data interface pair, and click Properties.
  • Click the Job Configuration tab.
  • Under the Data Interface Pairs section, click the Add button.
2. Select the names of computers for which you want to define the Data Interface Pairs and then click Next.  
3. Click Add.  
4. Select the network interface name that you want to use for each client, and then click Next. This will become the interface pair for communication between the two clients.
  • If you do not find an specific network interface in the list, you can type the name or IP address of the NIC card.
  • In the case of remote computers, it is important to specify a network interface that is visible to the other computer.
 
5. The interface names between the two computers are displayed. Click Next to continue.

No more than one data interface pair should be created between two computers. If you want to establish a new interface pair, delete the existing one and configure the interface you want to use.

 
6. Click Finish to create the new data interface pair.  

Configure the Client for Data Encryption

To encrypt data during data protection and recovery operations using the CommCell Console, you must configure encryption at the client level first and then at the subclient level.

To encrypt data during third-party Command Line operations, you must configure encryption at the client level first and then at the instance level.

See Data Encryption - Support for a list of supported products.

Before You Begin

This procedure configures data encryption for all supported agents that reside on this client, however, no content at any level (instance or subclient) will be encrypted until the respective level's encryption property is enabled.

Required Capability: Capabilities and Permitted Actions

To configure the client for data encryption:

  1. From the CommCell Console, right-click the Client and click Properties.
  2. From the client's Client Properties (Encryption) tab, select the Encrypt Data check box to enable options.
  3. Select options based on the criteria described in the Encryption tab help.
  4. Configure data encryption for Restore Access and Direct Media Access.

    If you configure data encryption with With a Pass-Phrase and do not elect to export the pass-phrase to destination clients:

    If you do not require this level of security, consider using Regular encryption instead or Export an Encryption Pass-Phrase. The following  requires you to export the pass-phrase:

    Note, if you selected pass-phrase security you must enter a pass-phrase in the dialog box that appears.

  5. Click OK to save your settings and close client properties.

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

  3. Click OK to save your changes.

Configure the Search Server URLs

Before You Begin

Required Capability: Capabilities and Permitted Actions

To configure Search Server URLs for the client:

  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 Search Server URLs tab of the Client Computer Properties dialog box, enter the desired changes.
  3. Click OK to save your changes.

Configure Deduplication Options for the Client

Required Capability: Capabilities and Permitted Actions

Before You Begin

Review Source Deduplication.

To configure deduplication options for the client:

  1. From the CommCell Browser, right-click the client computer for which you wish to configure deduplication options, and then click Properties.
  2. From the Client Side Deduplication tab of the Client Computer Properties dialog box, provide the following options.
  3. If you wish to deduplicate the client's backup data on the client side before transferring the data to the MediaAgent, select Perform client side Deduplication.
  4. If you wish to maintain a signature cache at the client for local lookups, select Enable Client Side Disk Cache.
  5. Click OK to save your changes.

Release License for Client, MediaAgent, Agent, or Enabler

Required Capabilities: Capabilities and Permitted Actions

Administrative Management capability cannot be used to release the license from the MediaAgent level.

Before you Begin:

To release license for client, MediaAgent, agent, or enabler:

  1. In the CommCell Browser, right-click the name of the client, MediaAgent, agent, or enabler you want to release license, click All Tasks (if displayed), and select Release License.
  2. A popup warning message appears.

    Click OK to continue.

  3. Another popup message then appears.

    Click Yes to continue with the deconfiguration or No to abort.

  4. If releasing a license is unsuccessful, a number of popup messages appears. In some cases, the message requests that you take some corrective action. For example, the message might advise you to ensure that there are no jobs running on the agent. In such a case, click OK and take the appropriate action. Then repeat the process.

If releasing a license is successful, the tree element is dimmed and available for deletion.


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


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. From the Job Configuration tab of the Client Computer Properties dialog box, if necessary or desired, 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.
  3. From the Job Configuration tab, type a new job results path in the Job results path field.

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

  4. 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. From the Job Configuration tab of the Client Computer Properties dialog box, click User Name/Password.
  3. In the Change User Account dialog box, enter the appropriate User Impersonation account information.
  4. 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. From the Job Configuration tab of the Client Computer Properties dialog box, select the number of days job results should be pruned from the Prune job results after field.
  3. Select a disk capacity after which job results should be pruned from the Prune job results when disk capacity reaches field.
  4. Click OK to save your changes.

View Data Interface Pairs Configured for the Client

Required Capability: Capabilities and Permitted Actions

To view data interface pairs:

  1. In the CommCell Browser, right-click the Client computer for which you wish to view the data interface pair, and select Properties. In the client's properties dialog box, select the Advanced tab.

  2. The list of data interface pairs configured for the client is displayed in the Data Interface pairs area.

  3. Click OK to exit the screen.

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 from the short-cut menu.
  2. From the Job Configuration tab of the Client Computer Properties dialog box, click in the Job Priority (0-9) field and enter a new client priority value. Remember that the lower the value, the higher the priority.
  3. Click OK to save your changes.

Specify CDR Log File Location on Source and Destination Computers

Before You Begin

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

To view the history of data recovery operations:

  1. From the CommCell Browser, right-click a client computer whose data recovery history you want to view, click View, then click to view a job history.
  2. From the Job History Filter dialog box, select Restore, QR Volume Recovery, Recovery/Retrieve and/or Stub Recall from the Data Recovery Operations pane, then click OK.
  3. The system displays the results of the options you selected in the Data Recovery Job History window.

    If you selected Stub Recall as a job history filter option, the system displays the results of the options you selected in the Data Recovery Job History window's Stub Recall Jobs tab.

  4. Click OK.

View the Data Protection Job History of a Client

To view the data protection job history of a client:

  1. From the CommCell Browser, right-click a client computer whose data protection history you want to view, click View, then click View Job History.
  2. From the Job History Filter, select Backup, QR Volume Creation, and/or Archive/Compliance Archive from the Data Protection Operations pane, then click OK.
  3. If you want to view more advanced options, from the Job History Filter window, select Backup and/or QR Volume Creation, then click Advanced.
  4. From the Data Protection History Advanced Filter, select the type of backup you would like to view, as well as the type of QR Volume Creation operation. Click OK.
  5. The system displays the options you selected in the Data Protection Job History window.
  6. Click OK.

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

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)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

Required Capability: Capabilities and Permitted Actions

To delete a client computer:

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

    If the Delete command is not available, then you have not successfully deleted the base client software (if relevant) from the client computer.

  2. A confirmation message appears. Click Yes to delete the client computer or click No to cancel the deletion.

    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. If you click Yes, the client computer icon is removed from the view.


Delete a Pseudo-Client

Before You Begin

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.

Delete Data Interface Pairs

Required Capability: Capabilities and Permitted Actions

To delete data interface pairs:

  1. From the Tools menu in the CommCell console, click Control Panel, and then double-click Data Interface Pairs. Select the names of computers of which you wish to delete the Data Interface Pairs and then click Next.
  2. The Data Interface Pairs Wizard displays the list of data interface pairs available.
  3. Select the data interface pair you wish to delete, and then click the Delete button.
  4. Select Next to review the details and click Finish to delete the selected data interface pair.

Create a DB2 DPF Client

When you create a DB2 DPF pseudo-client, you also create a DB2 DPF partition instance at the same time. Each pseudo-client can include only this one partition instance; you cannot create additional instances for any one pseudo-client. To create additional partition instances, you must create additional pseudo-clients.

Before You Begin
Review the following to avoid common problems:
  • You should have administrative privileges.
  • Ensure that the user group to which the user belongs has agent management capability on the DB2 DPF clients that will be added to the DB2 DPF pseudo-client.
  • You have the appropriate licenses available.
Add Client Checklist
For each DB2 DPF pseudo-client/instance that you want to create, collect the following information in the first block before creating the pseudo-client. Also collect the information in the second block. (Use the spaces provided to record the information. Retain this information in your Disaster Recovery binder.)
1. Name of the DB2 DPF pseudo-client: ___________________________________________________

Instance path for which the DB2 DPF pseudo-client is being created: _________________________

__________________________________________________________________________________

User account information (Windows only, optionally): ______________________________________

Names of DB2 DPF database partitions and corresponding clients for the DB2 DPF instance

__________________________________________________________________________________

2. Storage policy to be used by the default subclient for data:__________________________________

Storage policies to be used by the instance for user command backups and archive log backups:___

___________________________________________________________________________________

To create a DB2 DPF Client
1. From the CommCell Console, right-click Client Computers and click New Client.
2. From the Add New Client dialog box, click DB2 DPF Client and then click OK.
3. In the Create DPF Client (General) dialog box, type or select values for the fields as appropriate. To change the Windows user account, click Change User Account, type the DB2 DPF user name and password credentials, and click OK. Ensure that Auto detect new and deleted partitions is enabled. Then click Details.
4. In the Create DPF Client (Details) dialog box, use the Clients list and click Add/Refresh to include the appropriate database partitions in the instance. Selected database partitions and their corresponding clients will be displayed in the DB2 Partition Clients space.
5. From the Data Backup tab in the Create DPF Client (Storage Device) dialog box, click the default data storage policy from the list.
6. From the Log Backup tab in the Create DPF Client (Storage Device) dialog box, click the storage policy for all log files from the list.
7. From the Command Line Backup tab in the Create DPF Client (Storage Device) dialog box, click the storage policy for command line backups from the list.

Also, configure items in the Data Transfer Option and De-Duplication tabs as appropriate.

8. Click OK.

This task is now complete.

 

Add a NAS Client

1.
  • From the CommCell Browser, right-click Client Computers.
  • Select New Client.
2.
  • Select NAS Client from the list.
  • Click OK.
3.
  • Enter the NAS file server in the NDMP Server Hostname field.
  • Enter the user account used to access the storage device in the NDMP Login field.
    • For NetApp, type root.
    • For EMC Celerra, type ndmp.
    • For all other file servers, use any valid login.
  • In the NDMP Password field, enter the password for the login account.
  • Click Detect. The system automatically populates the Vendor, Hardware OS Revision, and Listen Port information.
4. Click OK.

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

5. 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, 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 Automatic Update Packages Locally before Installation

To Store Update Packages Locally before Installation:

  1. From the CommCell Browser, 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 update packages locally before installation, specify a local folder in the Store Updates Locally field in which the updates must be stored. This serves as a temporary cache area. Note that you cannot specify a different folder to serve as the temporary cache area for NetWare clients; this field is disabled.
  4. Click OK to save the information.

Associate or Disassociate a User Group to 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 to 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/Disable Robust Network Layer

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To enable or disable the Robust Network Layer feature:

  1. From the CommCell Console, right click on a client, and select Properties from the pop-up menu. Select the Client Computer Properties (Advanced) tab.

    Alternatively, right click on a MediaAgent and select Properties from the pop-up menu. Select the MediaAgent Properties (Control) tab.

  2. Select the Enable retry on network errors option to enable the feature. Deselect it to disable the feature.
  3. Click OK.

Change Robust Network Layer Configuration

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To change the Robust Network Layer configuration:

  1. From the CommCell Console, right click on a client, and select Properties from the pop-up menu. Select the Client Computer Properties (Advanced) tab.

    Alternatively, right click on a MediaAgent and select Properties from the pop-up menu. Select the MediaAgent Properties (Control) tab.

  2. Select the Enable retry on network errors option to enable the feature. Deselect it to disable the feature. If enabled, you may configure the following:
  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.