Client - How To

Topics | How To | Related Topics


Enable or Disable Operations

Browse the Latest Data

Check Client Connectivity

Configure the Client for Data Encryption

Configure the Proxy for Exchange

Configure the Web Server URLs

Register a Client Computer

Deconfigure 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 the Data Recovery Job History of a Client

View the Data Protection Job History of a Client

View the Log Files of a Client Computer

Delete a Client Computer

Create a RAC Client

Add a Client for NAS NDMP iDataAgents

View the Software Install Folder

For remote clients:

Associate or Disassociate a User Group to a Client

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.

NOTES


Browse the Latest Data

The following procedure can be used to browse data from the client, agent, instance, or backup set 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 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 Connectivity.
  3. A message will be displayed indicating whether or not the client is accessible in the CommCell.
  4. Click Ok.

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. Click OK to save your settings and close client properties.
  5. If you elected pass-phrase security you must enter a pass-phrase in the dialog box that appears.

NOTES


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 Web Server URLs

Before You Begin

Required Capability: Capabilities and Permitted Actions

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

Register a Client Computer

Related Topics

Before you Begin

Required Capability: Capabilities and Permitted Actions

To register a client computer:

  1. From the CommCell Browser, right-click the Client Computers icon, then select Register Client from the short-cut menu.
  2. The Register a new Client wizard is displayed.
  3. In the Select Configuration Source dialog, choose one of the following:

    Click Next to continue.

  4. In the Optional Data dialog, you can do the following:

    Click Next to continue.

  5. The Summary screen is displayed. Verify that the information is correct, then click Finish.
  6. The Progress screen is displayed until all the steps complete successfully.
  7. Refresh the CommCell Console to see the newly registered Client and/or MediaAgent.
  8. If you selected Get Client configuration from an input file on CommServe in Step 3, perform the following additional steps:
    1. Install the Client and/or MediaAgent software on the computer that will be a Client or MediaAgent. If that computer has connectivity to the CommServe, you can perform a regular install or a Decoupled Install; if it does not have connectivity, you can only perform a Decoupled Install. For more information and instructions, see Installation or Decoupled Install.
    2. To connect the Client or MediaAgent to the CommCell, right-click the Client or MediaAgent in the CommCell Browser and select Complete Registration. The CommServe will connect to the selected computer and complete the connection process. When finished, based on whether Agent or MediaAgent software, or both, were installed on the remote computer, it will appear in the browser as a Client, MediaAgent, or both.
  9. Verify that Updates have been installed on the newly registered Client and/or MediaAgent. For more information, see Install Updates on CommCell Computers.

Deconfigure a Client, MediaAgent, Agent, or Enabler

Required Capabilities: Capabilities and Permitted Actions

Administrative Management capability cannot be used to perform the deconfigure operation from the MediaAgent level.

Before you Begin:

To deconfigure a client, MediaAgent, agent, or enabler:

  1. In the CommCell Browser, right-click the name of the client, MediaAgent, agent, or enabler you want to deconfigure, click All Tasks (if displayed), and select Deconfigure.
  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 the deconfigure 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 deconfigure process.

If the deconfigure 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.

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, 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. In the case of 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 appears. For a non-pseudo-client, 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.

    For a pseudo-client, 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.


Create a RAC Client

Before You Begin
Review the following to avoid common problems:
  • You should have DBA and SYSDBA privileges
  • You have an available license on the CommServe for each Oracle iDataAgent you wish to add to the RAC nodes.
Add Client Checklist
For each Oracle iDataAgent instance that you want to include in the Oracle RAC node, collect the following information in the first block before creating the RAC pseudo-client. Also collect the information in the second block. (Use the space provided at the right to record the information. Retain this information in your Disaster Recovery binder.)

1.

Name of the Oracle iDataAgent instance(s) along with the name of the associated physical client for each Oracle iDataAgent:__________________________________________________________________________________

Path to the Oracle home directory:_______________________________________________________________

Database connect string:________________________________________________________________________

Catalog connect string for the catalog database:_____________________________________________________

____________________________________________________________________________________________

Path to the TNS Admin directory (optional):_________________________________________________________

Block size for backup and restore operations for each Oracle instance (optional):__________________________

____________________________________________________________________________________________

Pass-phrase to enable data encryption for RMAN command line backups (optional):________________________

____________________________________________________________________________________________

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 RAC Client

1.

From the CommCell Console, right-click Client Computers and click New Client.

2.

From the Add New Client dialog box, click RAC Client and then click OK.

3.

In the Create RAC Client (General) dialog box, type or select values for the fields as appropriate. Then click Details.

4.

In the Create RAC Client (Details) dialog box, type or select values for the fields at the bottom of the dialog box as appropriate.

5.

In the Create RAC Client (Details) dialog box, click Add. In the Add Instance dialog box, select the physical client containing the Oracle iDataAgent instances that you want to include in the Oracle RAC node. Thereafter, type or browse values for the fields as appropriate. Then click OK. Repeat this step for each Oracle iDataAgent instance that you want to include.

6.

From each tab in the Create RAC Client (Storage Device) dialog box, select values for the fields as appropriate.

7.

If Encryption is enabled, click Encryption and select the appropriate value.

 

8.

After you configure all your instances as appropriate, click OK.

This task is now complete.

Add a Client for NAS NDMP iDataAgents

Before You Begin
Review the following to avoid common problems:
  • You have an available license on the CommServe for the NAS NDMP client you wish to add.
  • You have configured the Libraries and Drives for the NAS NDMP iDataAgent. See the Post-Install section of Deployment - NetApp NAS NDMP iDataAgent for more information.
  • For NetApp file servers only - after attaching the file server and MediaAgent machine to the library and before you begin your software installation, verify that the NDMP service is enabled in the NetApp file server. This is not enabled by default. See Enabling the NDMP Service for more information.
Add Client Checklist
Collect the following information before installing the software. (Use the space provided at the right to record the information. Retain this information in your Disaster Recovery binder.)
1. MediaAgent:_________________________________________________________________________

NDMP Server Host Name:______________________________________________________________

Storage Policy:_______________________________________________________________________

Backup content path:__________________________________________________________________

See Step 3 for more information.

To add a NAS client
1. Right-click Client Computers and select New Client.
2. Select NAS Client and click OK.
3. Enter or edit the following information in the Add NDMP Server dialog and then click OK.

NDMP Server Hostname: The long name of the NAS file server.

NDMP Login: The user account through which the system will access the filer.

NDMP Password: The password for the NDMP Server Login account.

Confirm NDMP Password: The password for the NDMP Server Login account, for confirmation.

Click the Detect button. The system automatically populates the Vendor, Hardware OS Revision and Listen Port information.

NOTES

  • If the NAS file server version does not support detection, you will have to enter the Vendor and Firmware Revision information manually.
  • Note that this will create a NAS client for the NDMP server added. If there are no available licenses for this NAS client type, this action will fail.
  • Use the following accounts for NDMP Login:
    • For BlueArc, this account is user-defined.
    • For EMC Celerra, this account must be ndmp.
    • For Hitachi NAS, this account is user-defined.
    • For NetApp, this account must be root.
  NOTES
  • Because file servers define their directories as different portions of a specific root directory on a file server or storage processor, the subclient must contain the full path of the content you want to back up, including the correct root directory. Once your CommCell console is fully configured, you will be given the opportunity to add additional paths to the default subclient, or create additional subclients, which you can define for each directory. At that time, refer to the help provided with the software for more information on subclient definition and for steps involved in changing the content of the subclient.

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. In the Update Information area, click the Store Updates Locally option and then specify a local folder in which the updates must be stored. This serves as a temporary cache area.
  4. Click OK to save the information.

Install from the Automatic Update Packages available in the CommServe

To install from the Update Packages available in the CommServe:

  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. In the Update Information area, click the Get Updates from Share option. This option can only be selected if the CommServe cache is configured on a network share.
  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.

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.