Changing the Domain Name for Clients Using the Command Line Interface

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

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


  1. Download the template and save it on the computer from where the command will be executed:
  2. Run the qlogin command to log on to the CommServe computer.
  3. Update the parameters in the your template file. Use the Available Command Parameters table for reference.
  4. On the command line, go to software_installation_directory/Base and type the appropriate command:

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:


newData The new domain name, for example:


clientName The clients to update.

To update more than one client, add the following block to the XML file for each client:


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.