Name Management - Operations

Table of Contents

Changing the CommServe Computer Name

When you change the name of the computer where the CommServe resides, you need to notify the CommServe database and client computers about the new computer name, as it will also affect the CommServe hostname. Change the name of the CommServe computer from the CommCell Console if you want to update the computer name without reinstalling the CommServe software.

During the name change operation, the CommCell changes the CommServe name and informs all MediaAgents and clients (clustered and non-clustered) in the CommCell of the new CommServe name.

Notes:

  • The new CommServe name must not be or include the word "commcell".
  • If MediaAgents or clients are unavailable or offline during the name change operation, a dialog box lists the items that were unavailable. Make sure that the items are available and then perform the steps described in Changing the CommServe Name for All Clients after Restoring the Database.

    You can also update the CommServe name for each client through their client properties window.

  • On the computer hosting the Web Server, you should update the value of the sINSTANCE registry key to reflect the new CommServe name. This registry key contains the SQL database instance name in which CommServe database is stored.

Before You Begin

Before changing the name of the CommServe computer, follow the steps below:

  1. Perform a Disaster Recover Backup.

    Verify that the Disaster Recovery Backup completed successfully. Also note down the location of the disaster recovery backup file.

  2. Specify the current CommServe name in the hosts file located in the C:\Windows\System32\drivers\etc directory. The CommServe name should be specified in the following format:

    172.xx.xx.xx commservName commservComputer.mydomain.company.com

    Adding the CommServe name to the hosts file will allow the upcoming name change operation to automatically update the system DSN with the new CommServe name.

  3. Verify that all MediaAgents and clients will be accessible during the CommServe name change process.
  4. If you have a firewall, review the information in Firewall Considerations for Name Change Operations.

Procedure

  1. Perform the name change on the computer's operating system.
  2. After changing the name, verify the following:
    • Make sure that the computer is available in the network with the new name. (DNS lookup or other name resolution facilities is appropriately configured to resolve the new name of the computer.)
    • Make sure that all applications running on the computer, for example, SQL server, Exchange, Server, and Oracle database, function with the new name. To rename a computer that hosts a stand-alone instance of SQL Server, see http://msdn.microsoft.com/en-us/library/ms143799.aspx.
    • Use ping (or other network connectivity utilities) to verify that the computer with the new name is accessible. Also verify that other computers in the network are accessible to the computer with the new name.
  3. From the CommCell Console ribbon, click the Home tab and then click Control Panel.
  4. Under Configure, click Name Management.

    The Name Management Wizard appears.

  5. Select Update CommServe hostname on CommServe and Remote clients and then click Next.

    The current hostname of the CommServe is automatically populated in the Old CommServe Name box.

  6. In the New CommServe Name box, enter the new host name and then click Finish.

Changing the CommServe Name for All Clients after CommCell Migration

During a CommCell Migration, the clients and MediaAgents are moved from one CommCell to another. After the migration, you must update all clients and MediaAgents with the new CommServe name. For more information on migrating CommCell components, see CommCell Migration.

Use the following procedure to update the CommServe name for all clients and MediaAgents in the new CommCell.

  1. On the new CommCell, navigate to the CommCell Console ribbon and then click Control Panel.

    Under Configure, click Name Management. The Name Management Wizard appears.

  2. Select Update CommServe for Clients (use this option post migration) and then click Next.
  3. Select the old CommServe hostname from which you wish to migrate the clients to the current CommServe.
  4. Click Next.
  5. Select the clients from the Available list and click > to add them to Selected list.

    If the migrated client has Virtual Server Agent installed, select only the client from the Available list. Do not select the virtualization client.

  6. Click Next.
  7. Select the following options in the Select Client Configuration wizard:

    Under Source Options:

    1. By default, the Try to contact Source CommServe check box is selected to access the client information from the source CommServe.

      If you do not want the migrated client to contact the source CommServe, clear the Try to contact Source CommServe check box. In the Confirmation dialog box, click OK..

    2. If you want to deconfigure the migrated clients and delete the data paths (mount paths) associated with the MediaAgent clients, select Deconfigure the migrated clients on source and remove datapaths.
    3. Select Do not deconfigure migrated clients on source, only disable client activity and datapaths to not configure the migrated clients but:
      • Disables all client activities (such as backups/subclient creation so on).
      • If the client is MediaAgent then disable write operation on the datapaths (mount paths).

      Note that this will not deconfigure the migrated client. You can still perform restore operations from these clients.

    Under Destination Options:

    1. By default, Consume Licenses check box is selected to consume the license for the migrated clients on the destination CommCell.
    2. Select Only proceed if licenses are available for clients to be migrated to consume licenses for the migrated clients if you have sufficient licenses on the destination CommCell.
    3. Select Consume available licenses, migrate the rest as restore-only clients, if you have a few licenses available on the destination CommCell and you wish to consume those licenses for those migrated clients and for rest of the clients you wish to register as uninstalled clients.
  8. Click Next.
  9. On the Confirmation dialog box, click Yes to register the CommServe.
  10. On the Register remote CommCell dialog box, provide the credentials and hostname of the source CommCell. Click OK.
  11. From the Storage Policy list, select the storage policy that you want to store the client backup data. To assign a storage policy for all subclients, from the Change all selected Storage Policies to list, select the Storage Policy and then click Apply.
  12. Click Finish.
  13. Click OK to the Confirmation popup, and then close the Control Panel window.

    The client appears as configured under the Client Computers node if Consume licenses is selected.

    The client appears as uninstalled under the Client Computers node if Consume licenses is not selected.

  14. If you did not select Try to contact Source CommServe, run the script ChangeCSHostNameAfterMigration QScript on the PodCell for all of the selected clients.
  15. Restart the services on the client after the name change. For more information, see Restarting a Service.

What to Do Next

Changing the CommServe Name for All Clients after Restoring the Database

When you move or restore the CommServe database to a new computer that uses a name that is different from the original CommServe computer, you must inform the clients about the new CommServe name.

Important: The approximate time needed for this operation is 30 seconds per online physical client and 20 seconds per offline physical client. Use these time estimates to calculate the time needed to run this operation in your CommCell environment.

Procedure

  1. From the CommCell Console ribbon, click the Home tab and then click Control Panel.
  2. Under Configure, click Name Management.
  3. In the Name Management Wizard, select Update CommServe for Clients (use this option after DR restore) and then click Next.
  4. From the Old CommServe host name list, select the name of the old CommServe and then click Next.
  5. From the Available list, select the clients on the new CommCell, and then click the right arrow > button to add them to the Selected list.
  6. Clear the Update database even if clients are unreachable check box.

    If any clients are unreachable, re-run this operation for the failed clients once they are reachable.

  7. Click Finish.

The selected clients are updated to point to the new CommServe.

Changing the Domain Name for One or More Clients

If you move one or more clients to a different domain or if the current domain has been renamed, you must specify the new domain name in the CommCell.

Use the following steps to update the domain name for one or more client computers.

  1. From the CommCell Console ribbon, click the Home tab and then click Control Panel.
  2. Under Configure, click Name Management.
  3. In the Name Management Wizard, select Update Domain name and then click Next.
  4. From the Old Domain Name list, select the old domain name.
  5. In the New Domain Name box, type the new domain name and then click Next.
  6. From the Available list, select the clients for which the domain name should change, and then click the right arrow button > to add them to the Selected list.
  7. Clear the Update database even if clients are unreachable check box.

    If any clients are unreachable, re-run this operation for the failed clients once they are reachable.

  8. Click Finish.

The domain name is changed for the selected clients.

Changing the Client Computer Name

Before You Begin

  • Review the schedules associated with the client. Client schedules must be recreated after changing the name of a client computer. For information on viewing schedules, see Viewing Job Schedules.
  • If you are changing the name or host name of a proxy client or a client behind a proxy, review the information in Firewall Considerations for Name Change Operations.

Procedure

  1. Verify there are no jobs running for the client.
  2. Perform the name change on the computer's operating system.
  3. After changing the name, verify the following:
    • Make sure that the computer is available in the network with the new name. (DNS lookup or other name resolution facilities is appropriately configured to resolve the new name of the computer.)
    • Make sure that all applications running on the computer, for example, SQL server, Exchange, Server, and Oracle database, function with the new name. To rename a computer that hosts a stand-alone instance of SQL Server, see http://msdn.microsoft.com/en-us/library/ms143799.aspx.
    • Use ping (or other network connectivity utilities) to verify that the computer with the new name is accessible. Also verify that other computers in the network are accessible to the computer with the new name.
  4. From the CommCell Browser, right-click the client or MediaAgent whose name was changed, and then click Properties.
  5. Update the name:

    On a Client Computer

    1. In the Client Name section of the General tab, click Edit.
    2. In the Edit Client Name Dialog window, update Client Name and Host Name with the new name.

      Notes:

      • Do not use spaces when specifying a new name for the Client.
      • CommServe HostName displays the full interface name of the CommServe computer used by the Client to communicate with the CommServe.
    3. Click OK to save the changes.

    On a MediaAgent Computer

    1. In the Names section of the General tab, click Edit.
    2. In the Edit MediaAgent Name window, update MediaAgent Name with the new name.

      Notes:

      • Do not use spaces when specifying a new name for the Client.
      • MediaAgent CommServe Host Name displays the full interface name of the CommServe computer used by the MediaAgent to communicate with the CommServe.
    3. Click OK to save the changes.
  6. Click OK to close the properties dialog box.
  7. Restart the services on the client. See Restarting a Service for instructions.

    For clients that contain the File Archiver for Windows/Unix agent or the One Pass agent, it is important that services are restarted after the name change. This ensures that stub recalls from these clients function correctly.

Changing the Data Source Name

The following procedure describes the steps involved in changing the Data Source Name (DSN) of the CommServe and SRM databases:

  1. Using Internet Explorer, type in the following:

    https://localhost/Reports[$service_display_name]

    where service_display_name is NetApp.

  2. Select SRM node.
  3. Edit the following DSNs:
    • CommServe
    • SRM
    • SRMRaw
  4. Select a DSN.
  5. Change the old System Name to the new System Name in the Connection String field.
  6. Re-enter the password, then click Apply.

The DSN will connect to the New System.

Firewall Considerations for Name Change Operations

You must manually push the firewall configuration if you change the name or host name of any of the following entities:

  • CommServe computer
  • Proxy
  • Client behind a proxy

Important: The firewall configuration must be pushed in a specific order as indicated in the following procedure.

Procedure

Note: The old and new host name must remain available until all clients or related clients (for example, MediaAgents and proxies) are updated with the latest firewall configuration.

  1. Perform the appropriate renaming procedure:
  2. Manually push the firewall configuration to the following entities in the order listed:
    1. Right-click the client, point to All Tasks, then click Push Firewall Configuration.
    2. Right-click the MediaAgent, point to All Tasks, then click Push Firewall Configuration.
    3. Right-click the proxy, point to All Tasks, then click Push Firewall Configuration.
    4. Right-click the CommServe, point to All Tasks, then click Push Firewall Configuration.

Command Line Operations for Name Management

The following sections describe name management from the command line.

To run command line operations, you must first login to the CommServe.

From Command prompt, navigate to <Software_Installation_Directory>/Base and run the following command:

qlogin -cs <commserve name> -u <user name>

For example, to log on to CommServe 'server1' with username 'user1':

qlogin -cs server1 -u user1

Changing the CommServe Computer Name

Review the information and prerequisites in Changing the CommServe Computer Name before continuing.

  1. Download the update_host_name_cs_remoteclients_template.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <Software_Installation_Directory>/Base folder after updating the parameters in the update_host_name_cs_remoteclients_template.xml file. Use the Available Command Parameters table for reference.

Available Command Parameters

Parameter Description
operation The modification type. Use "CS_HOST_NAME_CHANGE_ON_CS_REMOTECLIENTS" for this template.
oldData The old CommServe host name, for example:

<oldData>ABC</oldData>

newData The new CommServe host name, for example:

<newData>XYZ</newData>

Changing the CommServe Name for Clients after Restoring the Database

  1. Download the update_host_name_dr_restore_template.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <Software_Installation_Directory>/Base folder after updating the parameters in the update_host_name_dr_restore_template.xml file. Use the Available Command Parameters table for reference.

Available Command Parameters

Parameter Description
updateDBOnClientsUnreachable The option to update the database if clients are unreachable.

Valid values are true/false.

operation The modification type. Use "CS_HOST_NAME_CHANGE" for this template.
oldData The old CommServe host name, for example:

<oldData>ABC</oldData>

newData The new CommServe host name, for example:

<newData>XYZ</newData>

clientName The clients to update. If the clientName parameter is left empty, all clients that have the CommServe host name specified in the oldData parameter are updated.

To update multiple clients, add the following block to the XML file for each client:

<clientList>
<clientName>client001</clientName>
</clientList>

Changing the Domain Name

If you move one or more clients to a different domain or if the current domain has been renamed, you must specify the new domain name in the CommCell.

By default, the database is updated with the new domain name even if the clients are not reachable.

Specific Clients

  1. Download the update_domain_name_list_template.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <Software_Installation_Directory>/Base folder after updating the parameters in the update_domain_name_list_template.xml file. Use the Available Command Parameters table for reference.

    qoperation execute -af update_domain_name_list_template.xml

All Clients

  1. Download the update_domain_name_all_template.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <Software_Installation_Directory>/Base folder after updating the parameters in the update_domain_name_all_template.xml file. Use the Available Command Parameters table for reference.

    qoperation execute -af update_domain_name_all_template.xml

Available Command Parameters

Parameter Description
updateDBOnClientsUnreachable The option to update the database if clients are unreachable.

Valid values are true/false.

operation The modification type. Use "DOMAIN_NAME_CHANGE" for these templates.
oldData The old domain name, for example:

<oldData>abcdomain.company.com</oldData>

newData The new domain name, for example:

<newData>xyzdomain.company.com</newData>

clientName The clients to update.

To update multiple clients, add the following block to the XML file for each client:

<clientList>
<clientName>client001</clientName>
</clientList>

If the new domain name applies to all clients, use the allClients parameter.
allClients The option to update all clients. Use "true" in the update_domain_name_all_template.xml file.

Changing the Client Computer Name

It is useful to change the hostname and display name of a client computer through the command line when you install the software using the Decoupled Install, and when you want to change the name of the computer once the computer is registered.

Notes:

  • The command must be executed locally and cannot be used to change the name of a remote computer.
  • For clients that are part of a cluster environment, the name change must be performed from the CommCell Console. See Changing the Client Computer Name.

Before You Begin

  • Review the schedules associated with the client. Client schedules must be recreated after changing the name of a client computer. For information on viewing schedules, see Viewing Job Schedules.
  • If you are changing the name or host name of a proxy client or a client behind a proxy, review the information in Firewall Considerations for Name Change Operations.

Procedure

  1. Verify there are no jobs running for the client.
  2. Perform the name change on the computer's operating system.
  3. After changing the name, verify the following:
    • Make sure that the computer is available in the network with the new name. (DNS lookup or other name resolution facilities is appropriately configured to resolve the new name of the computer.)
    • Make sure that all applications running on the computer, for example, SQL server, Exchange, Server, and Oracle database, function with the new name. To rename a computer that hosts a stand-alone instance of SQL Server, see http://msdn.microsoft.com/en-us/library/ms143799.aspx.
    • Use ping (or other network connectivity utilities) to verify that the computer with the new name is accessible. Also verify that other computers in the network are accessible to the computer with the new name.
  4. On the client computer, open the command prompt, go to the software_install_directory\Base folder and run the following command:

    Changing the Host Name

    SetPreImagednames.exe CCNAME -hostname newhostname oldhostname -displayname computername

    where,

    • newhostname and oldhostname are the new and old host names of the computer, which should be in the computer.domain.company.com format
    • computername is the name of the computer currently displayed in the CommCell Browser

    Changing the Client Name displayed in the CommCell Browser

    SetPreImagednames.exe CCNAME -displayname newcomputername oldcomputername

    where,

    • newcomputername is the new display name of the computer
    • oldcomputername is the name of the computer currently displayed in the CommCell Browser

    The command displays the "Successfully changed names" message when completed.

    You can run the above commands for the CommServe and Web Server computers by replacing the CCNAME parameter in the command with CSNAME for the CommServe, or WEBSERVER for the Web Server.

  5. Restart the services on the client. See Restarting a Service for instructions.

    Important: For clients that contain the File Archiver for Windows/Unix agent, restart the services after the name change. This ensures that stub recalls from these clients function correctly.

  6. Once the services are started, open the CommCell Console. The new name for the computer will be displayed in the CommCell Browser.