Apache Ambari Administration
Also available as:
loading table of contents...

Chapter 7. Changing Host Names

Circumstances may require that you change the names of the hosts in your existing cluster. Beyond any infrastructure and environment changes you need to make, you must also change the host names that Ambari uses to manage the HDP cluster.


  • Make a backup of your Ambari database.

  • Disable Kerberos.

    Using Ambari Web, browse to Admin > Kerberos and click Disable Kerberos.

To change a host name in Ambari:


  1. In Ambari Web > Background Operations, stop all pending commands and jobs.

  2. Stop all services.

  3. Stop ambari-server and ambari-agents on all hosts.

    ambari-server stop
    ambari-agent stop
  4. Create *.json file with host names changes.

    Example: host_names_changes.json

      "cluster1" : {
          "c6400.ambari.apache.org" : "c6410.ambari.apache.org",
          "c6401.ambari.apache.org" : "c6411.ambari.apache.org",

    where cluster1 is cluster name and "c6400.ambari.apache.org" : "c6410.ambari.apache.org"is the host names pair in the format "current_host_name" : "new_host_name".

  5. Execute the following command on the ambari-server host:

    ambari-server update-host-names host_names_changes.json
  6. After successful end of this action, please update host names for all nodes, according to changes that you added to *.json file.

  7. If you changed the host name for the node on which the ambari server resides, then you must update that name for every ambari-agent.

    In /etc/ambari-agent/conf/ambari-agent.ini, update the "hostname" field to the new host name for node on which the ambari-server resides.

  8. Start ambari-server and ambari-agents on all hosts.

    ambari-server start
    ambari-agent start
  9. If you have NameNode HA enabled, after starting the ZooKeeper service, you must:

    1. Start all ZooKeeper components.

    2. Execute the following command on one of the NameNode hosts:

      hdfs zkfc -formatZK -force
  10. Start all services, using Ambari Web.

    For each, browse to Services > service_name > Service Actions > Start.

  11. If you disabled Kerberos before starting this procedure, you must enable Kerberos security by working through either the automated or manual setup procedure. If you enable Kerberos with the manual option, you must be sure to generate and deploy new keytabs that contain the new host names.

More Information

Enable Kerberos Security