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

## Procedure

1. Download the template and save it on the computer from where the command will be executed:

   - Specific clients: update_domain_name_list_template.xml

   - All clients: update_domain_name_all_template.xml

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:

   - Specific clients:

          qoperation execute -af update_domain_name_list_template.xml

   - All clients:

          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>company1.com</oldData>
newData | The new domain name, for example: <newData>company2.com</newData>
clientName | The clients to update. To update more than one client, 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.

×

Loading...