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:

• Store Automatic Update Packages Locally before Installation
• Install from the Automatic Update Packages available in the CommServe

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

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

• Disabled data protection and/or data recovery operations are displayed with client and/or agent icon changes in the CommCell Browser.

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

• If you selected the With a Pass-Phrase option and do not elect to export the pass-phrase to destination clients:
  • You will be required to enter the pass-phrase during immediate data recovery operations.
  • You will not be able to run scheduled data recovery operations.

  If you do not require this level of security, consider using Regular encryption instead or Export an Encryption Pass-Phrase.

• Situations for which you must export the pass-phrase:
  • To run scheduled data recovery operations
  • For the Migration Archiver Agents to run a Stub data recovery
  • For a third-party Command Line data recovery operations

Configure the Proxy for Exchange

Before You Begin

• Review Configuring the Proxy for Exchange.

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.

Configure the Web Server URLs

Before You Begin

• Review Configuring the Web Server URLs.
• When editing the Web Server URLs, keep in mind that any changes must be synchronized with the associated Virtual Directory name on the IIS Server.

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

• Decoupled Install

Before you Begin

• A Product License(s) will be consumed when you perform this procedure, even if you have not yet performed an installation of software on the computer which will function as a Client and/or MediaAgent.
• To register a Client computer without connecting to it, an XML input file containing the information needed to create the Client in the database must be available on a local drive of the CommServe. (This XML input file is automatically created during a Decoupled Install, and does not need to be created if you have already performed that procedure.) For more information about the XML input file, see XML Input File for Decoupled Install.
• When registering a computer by connecting with it, ensure the following:
  • The CommServe computer can communicate with the computer being registered.
  • The Client and/or MediaAgent software has been properly installed on the computer being registered. For more information and instructions, see Decoupled Install.

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:
   • Select Connect to a client and get its configuration. Type the Host Name and the number of the CVD port on Client. (Select this option only if you have already pre-installed software on a client computer using a Decoupled Install.)
   • Select Get Client configuration from an input file on CommServe. Type the path and name of the XML input file, or browse to it and select it.  (Select this option only if you have an XML input file available on the CommServe computer.)

   Click Next to continue.

4. In the Optional Data dialog, you can do the following:
   • Select Override the Client name, and type a different Client name from the one specified in the XML input file, or during the Decoupled Install.
   • Select Override the Host name, and type a different Host name from the one specified in the XML input file, or during the Decoupled Install. Ensure that the Host name you supply can be resolved from the CommServe.

   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

Before you Begin:

• For MediaAgent Deconfiguration, ensure that all the storage policies or copies associated with the configured libraries (or drive pools) in the MediaAgent are deleted or re-associated to another MediaAgent.

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

• 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. 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

• For CDR on Windows, this procedure can be performed on both the source and destination computer(s); for CDR on UNIX, this procedure only applies to a source computer.
• There are several considerations for log file space and location; refer to Replication Logs when deciding on a suitable location for Replication Logs.

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.
   • If you want to view more advanced options for restores, from the Job History Filter, select Restore, then click Advanced.
   • From the Data Recovery History Advanced Filter select the destination client computer of the restores you would like to view, 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

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. This does not apply to the pseudo-client for the Oracle RAC iDataAgent because this agent is not installed.
• In order to remove the base client software, there must be no agents installed on the client computer.
• 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 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.