This is the documentation for Cloudera Enterprise 5.8.x. Documentation for other versions is available at Cloudera Documentation.

Moving the Cloudera Manager Server to a New Host

You can move the Cloudera Manager Server if either the Cloudera Manager database server or a current back up of the Cloudera Manager database is available.

To move the Cloudera Manager Server:
  1. Identify a new host on which to install Cloudera Manager.
  2. Install Cloudera Manager on a new host, using the method described under Install the Cloudera Manager Server Packages.
      Important:
    • The Cloudera Manager version on the destination host must match the version on the source host.
    • Do not install the other components, such as CDH and databases.
  3. Copy the entire content of /var/lib/cloudera-scm-server/ on the old host to that same path on the new host. Ensure you preserve permissions and all file content.
  4. If the database server is not available:
    1. Install the database packages on the host that will host the restored database. This could be the same host on which you have just installed Cloudera Manager or it could be a different host. If you used the embedded PostgreSQL database, install the PostgreSQL package as described in Embedded PostgreSQL Database. If you used an external MySQL, PostgreSQL, or Oracle database, reinstall following the instructions in Cloudera Manager and Managed Service Datastores.
    2. Restore the backed up databases to the new database installation.
  5. Update /etc/cloudera-scm-server/db.properties with the database name, database instance name, username, and password.
  6. In /etc/cloudera-scm-agent/config.ini on each host, update the server_host property to the new hostname and restart the Agents.
  7. Start the Cloudera Manager Server. Cloudera Manager should resume functioning as it did before the failure. Because you restored the database from the backup, the server should accept the running state of the Agents, meaning it will not terminate any running processes.
The process is similar with secure clusters, though files in /etc/cloudera-scm-server must be restored in addition to the database. See Cloudera Security.
Page generated July 8, 2016.