Changing Hostnames
After you have installed Cloudera Manager and created a cluster, you may need to update the names of the hosts running the Cloudera Manager Server or cluster services.
Minimum Required Role: Full Administrator. This feature is not available when using Cloudera Manager to manage Data Hub clusters.
To update a deployment with new hostnames, follow these steps:- Verify if TLS/SSL certificates have been issued for any of the services and make sure to create new TLS/SSL certificates in advance for services protected by TLS/SSL.
- Export the Cloudera Manager configuration using one of the following methods:
- Open a browser and go to this URL
http://cm_hostname:7180/api/api_version/cm/deployment
. Save the displayed configuration. - From terminal type:
$ curl -u admin:admin http://cm_hostname:7180/api/api_version/cm/deployment > cme-cm-export.json
If Cloudera Manager SSL is in use, specify the
-k
switch and the port number as 7183:
where cm_hostname is the name of the Cloudera Manager host and api_version is the correct version of the API for the version of Cloudera Manager you are using. For example,$ curl -k -u admin:admin https://cm_hostname:7183/api/api_version/cm/deployment > cme-cm-export.json
http://tcdn5-1.ent.cloudera.com:7180/api/v43/cm/deployment
.
- Open a browser and go to this URL
- Stop all services on the cluster.
- Stop the Cloudera Management Service.
- Stop the Cloudera Manager Server.
- Stop the Cloudera Manager Agents on the hosts that you want to change the hostname of.
- Back up the Cloudera Manager Server database using
mysqldump
,pg_dump
, or another preferred backup utility. Store the backup in a safe location. - Update names and principals:
- If one of the hosts that was renamed has a NameNode configured with high
availability and automatic failover enabled, reconfigure the ZooKeeper Failover Controller
znodes to reflect the new hostname.
- Update the Hive metastore:
- Back up the Hive metastore database.
- In the Cloudera Manager Admin Console, go to the Hive service.
- Select and confirm the command.
- Update the Database Hostname property for each of the cluster roles for which a database is located on the host being renamed. This is required for both Cloudera Management Service roles (Reports Manager, Activity Monitor, Navigator Audit and Metadata Server) and for cluster services such as Hue, Hive, and so on.
- Start all cluster services.
- Start the Cloudera Management Service.
- Deploy client configurations.