Changing the CommServe Hostname on Commserve and Remote Clients Using the Command Line Interface

Use XML to change the name of the CommServe host name. The CommServe host name is used by clients and MediaAgents to communicate with the CommServe.

Caution: If you are 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. Run the qlogin command to log on to the CommServe computer.
  3. Update the parameters in the update_host_name_cs_remoteclients_template.xml file. Use the Available Command Parameters table for reference.
  4. On the command line, go to software_installation_directory/Base and type the following command:

    qoperation execute -af update_host_name_cs_remoteclients_template.xml

Available Command Parameters




The modification type. Use "CS_HOST_NAME_CHANGE_ON_CS_REMOTECLIENTS" for this template.


The old CommServe host name, for example:



The new CommServe host name, for example:


Last modified: 10/11/2018 4:04:54 PM