Procedure to Rollback from CDP 7.1.8 to CDP 7.1.7 SP1

Review Limitations

The rollback procedure has the following limitations:

HDFS – If you have finalized the HDFS upgrade, you cannot roll back your cluster.
Compute clusters – Rollback for Compute clusters is not currently supported.
Configuration changes, including the addition of new services or roles after the upgrade, are not retained after rolling back Cloudera Manager.
note
Cloudera recommends that you not make configuration changes or add new services and roles until you have finalized the HDFS upgrade and no longer require the option to roll back your upgrade.
HBase – If your cluster is configured to use HBase replication, data written to HBase after the upgrade might not be replicated to peers when you start your rollback. This topic does not describe how to determine which, if any, peers have the replicated data and how to roll back that data. For more information about HBase replication, see HBase Replication.
Sqoop 1 – Because of the changes introduced in Sqoop metastore logic, the metastore database that is created by the CDH 6.x version of Sqoop cannot be used by earlier versions.
Sqoop 2 – As described in the upgrade process, Sqoop2 had to be stopped and deleted before the upgrade process and therefore will not be available after the rollback.
Kafka – Once the Kafka log format and protocol version configurations (the inter.broker.protocol.version and log.message.format.version properties) are set to the new version (or left blank, which means to use the latest version), Kafka rollback is not possible.

Stop the Cluster

On the Home> Status tab, click the Actions menu and select Stop.
Click Stop in the confirmation screen. The Command Details window shows the progress of the stopping process.
When the All services successfully stopped message appears, the task is complete and you can close the Command Details window.
Go to the YARN service and click Actions> Clean NodeManager Recovery Directory. The CDH 6 NodeManager does not start after the downgrade if it finds CDP 7.x data in the recovery directory. The format and content of the NodeManager's recovery state store was changed between CDH 6.x and CDP 7.x. The recovery directory used by CDP 7.x must be cleaned up as part of the downgrade to CDH 6.

(Parcels) Downgrade the Software

Follow these steps only if your cluster was upgraded using Cloudera parcels.

Log in to the Cloudera Manager Admin Console.
. Select Hosts> Parcels.

A list of parcels displays.
Locate the CDP Private Cloud Base 7.1.7 parcel and click Upgrade. The upgrade option activates the parcel and restarts the services. At this point the HBase service restart fails. However, you must continue with the rollback steps for all the services (after performing the CM restore steps if needed). After the services are in running state after successfully performing their rollback, you can continue by clicking the Resume option of the failed Upgrade action. (From the left Navigation pane, click on Running Commands > All recent commands > Upgrade (failed upgrade option , you need to adjust the relevant Time Range))
After Upgrade step if the cluster is in running state, Stop the cluster.

important
Do not start any services. (Select the Activate Only option.) If you accidentally restart services, stop your cluster before proceeding.

Stop Cloudera Manager

Stop the Cloudera Management Service.

a. Log in to the Cloudera Manager Admin Console.

b. Select Clusters> Cloudera Management Service.

c. Select Actions> Stop.
Stop the Cloudera Manager Server.

sudo systemctl stop cloudera-scm-server
Hard stop the Cloudera Manager agents.

Run the following command on all hosts:

sudo systemctl stop cloudera-scm-supervisord.service

Stop Cloudera Manager

Restore the Cloudera Manager databases from the backup of Cloudera Manager that was taken before upgrading the cluster to CDP Private Cloud Base 7.1.7. See the procedures provided by your database vendor.

MariaDB 10.2, 10.3, 10.4 and 10.5:https://mariadb.com/kb/en/backup-and-restore-overview/

MySQL 5.7:https://dev.mysql.com/doc/refman/5.7/en/backup-and-recovery.html

MySQL 8:https://dev.mysql.com/doc/refman/8.0/en/backup-and-recovery.html

PostgreSQL 10:https://www.postgresql.org/docs/10/backup.html

PostgreSQL 11:https://www.postgresql.org/docs/11/backup.html

PostgreSQL 12:https://www.postgresql.org/docs/12/backup.html

PostgreSQL 13:https://www.postgresql.org/docs/13/backup.html

PostgreSQL 14:https://www.postgresql.org/docs/14/backup.html

Oracle 19c:https://docs.oracle.com/en/database/oracle/oracle-database/19/index.html

Restore Cloudera Manager Server

Use the backup of CDH that was taken before the upgrade to restore Cloudera Manager Server files and directories. Substitute the path to your backup directory for cm7_cdh6 in the following steps:

On the host where the Event Server role is configured to run, restore the Events Server directory from the CM 7/CDH 6 backup.

cp -rp /var/lib/cloudera-scm-eventserver /var/lib/cloudera-scm-eventserver-CM
rm -rf /var/lib/cloudera-scm-eventserver/*
cp -rp /var/lib/cloudera-scm-eventserver_cm7_cdh6/*
/var/lib/cloudera-scm-eventserver/

Remove the Agent runtime state. Run the following command on all hosts:
```
rm -rf /var/run/cloudera-scm-agent /var/lib/cloudera-scm-agent/response.avro
```
This command may return a message similar to: rm: cannot remove ‘/var/run/cloudera-scm-agent/process’: Device or resource busy. You can ignore this message.

On the host where the Service Monitor is running, restore the Service Monitor directory:

rm -rf /var/lib/cloudera-service-monitor/*
cp -rp /var/lib/cloudera-service-monitor_cm7_cdh6/* /var/lib/cloudera-service-monitor/

On the host where the Host Monitor is running, restore the Host Monitor directory:

rm -rf /var/lib/cloudera-host-monitor/*
cp -rp /var/lib/cloudera-host-monitor_cm7_cdh6/* /var/lib/cloudera-host-monitor/

Restore the Cloudera Navigator storage directory from the CM 7/CDH 6 backup.

rm -rf /var/lib/cloudera-scm-navigator/*
cp -rp /var/lib/cloudera-scm-navigator_cm7_cdh6/* /var/lib/cloudera-scm-navigator/

At this point, roll-backing Cloudera Manager is not required and is completely optional. But, if you want to rollback Cloudera Manager as well, follow steps as discussed in (Optional) Cloudera Manager Rollback Steps prior to going to the next step which is Start Cloudera Manager.

Start Cloudera Manager

Log in to the Cloudera Manager server host.
Start the Cloudera Manager Server.
```
sudo systemctl start cloudera-scm-server
```
Start the Cloudera Manager Agent.
Run the following commands on all cluster hosts:
```
sudo systemctl start cloudera-scm-agent
```
Start the Cloudera Management Service.
1. Log in to the Cloudera Manager Admin Console.
2. Select Clusters > Cloudera Management Service.
3. Select Actions > Start.
The cluster page may indicate that services are in bad health. This is normal.
Stop the cluster. In the Cloudera Manager Admin Console, click the Actions menu for the cluster and select Stop.

Roll Back ZooKeeper

Using the backup of Zookeeper that you created when backing up your CDH 6.x cluster, restore the contents of the dataDir on each ZooKeeper server. These files are located in a directory specified with the dataDir property in the ZooKeeper configuration. The default location is /var/lib/zookeeper. For example:
```
rm -rf /var/lib/zookeeper/*
cp -rp /var/lib/zookeeper_cm7_cdh6/* /var/lib/zookeeper/
```
Make sure that the permissions of all the directories and files are as they were before the upgrade.
Start ZooKeeper using Cloudera Manager.

Roll Back HDFS

You cannot roll back HDFS while high availability is enabled. The rollback procedure in this topic creates a temporary configuration without high availability. Regardless of whether high availability is enabled, follow the steps in this section.

Roll back all of the Journal Nodes. (Only required for clusters where high availability is enabled for HDFS). Use the JournalNode backup you created when you backed up HDFS before upgrading to Cloudera Private Cloud Base.
1. Log in to each Journal Node host and run the following commands:
```
rm -rf /dfs/jn/ns1/current/*
```
```
cp -rp <Journal_node_backup_directory>/ns1/current/* /dfs/jn/ns1/current/
```
2. Start the JournalNodes using Cloudera Manager:
  1. Go to the HDFS service.
  2. Select the Instances tab.
  3. Select all JournalNode roles from the list.
  4. Click Actions for Selected > Start.
Roll back all of the NameNodes. Use the NameNode backup directory you created before upgrading to Cloudera Private Cloud Base. (/etc/hadoop/conf.rollback.namenode) to perform the following steps on all NameNode hosts:
1. (Clusters with TLS enabled only) Edit the /etc/hadoop/conf.rollback.namenode/ssl-server.xml file on all NameNode hosts (located in the temporary rollback directory) and update the keystore passwords with the actual cleartext passwords. The passwords will have values that look like this:
```
<property>
 <name>ssl.server.keystore.password</name>
 <value>********</value>
 </property>
 <property>
 <name>ssl.server.keystore.keypassword</name>
 <value>********</value>
 </property> 
```
2. (TLS only) Edit the /etc/hadoop/conf.rollback.namenode/ssl-server.xml file and remove the hadoop.security.credential.provider.path property.
```
ssl.server.keystore.location to /etc/hadoop/conf.rollback.namenode/cm-auto-host_keystore.jks
```
3. Edit the /etc/hadoop/conf.rollback.namenode/core-site.xml and change the value of the net.topology.script.file.name property to /etc/hadoop/conf.rollback.namenode. For example:
```
# Original property
<property>
<name>net.topology.script.file.name</name>
<value>/var/run/cloudera-scm-agent/process/63-hdfs-NAMENODE/topology.py</value>
</property>
```
```
# New property
<property>
<name>net.topology.script.file.name</name>
<value>/etc/hadoop/conf.rollback.namenode/topology.py</value>
</property>
```
4. Edit the /etc/hadoop/conf.rollback.namenode/topology.py file and change the value of DATA_FILE_NAME to /etc/hadoop/conf.rollback.namenode. For example:
```
DATA_FILE_NAME = '/etc/hadoop/conf.rollback.namenode/topology.map'
```
5. (Kerberos enabled clusters only) Run the following command:
```
sudo -u hdfs kinit hdfs/<NameNode Host name> -l 7d -kt /etc/hadoop/conf.rollback.namenode/hdfs.keytab
```
6. Run the following command:
```
sudo -u hdfs hdfs --config /etc/hadoop/conf.rollback.namenode namenode -rollback
```
7. Restart the NameNodes and JournalNodes using Cloudera Manager:
  1. Go to the HDFS service.
  2. Select the Instances tab, and then select all Failover Controller, NameNode, and JournalNode roles from the list.
  3. Click Actions for Selected > Restart.
Rollback the DataNodes.
Use the DataNode rollback directory you created before upgrading to Cloudera Private Cloud Base (/etc/hadoop/conf.rollback.datanode) to perform the following steps on all DataNode hosts:
1. (Clusters with TLS enabled only) Edit the /etc/hadoop/conf.rollback.datanode/ssl-server.xml file on all DataNode hosts (Located in the temporary rollback directory.) and update the keystore passwords (ssl.server.keystore.password and ssl.server.keystore.keypassword) with the actual passwords.
  The passwords will have values that look like this:
```
<property>
<name>ssl.server.keystore.password</name>
<value>********</value>
</property>
<property>
<name>ssl.server.keystore.keypassword</name>
<value>********</value>
</property>
```
2. (TLS only) Edit the /etc/hadoop/conf.rollback.datanode/ssl-server.xml file and remove the hadoop.security.credential.provider.path property and change the value of property.
```
ssl.server.keystore.location to /etc/hadoop/conf.rollback.datanode/cm-auto-host_keystore.jks
```
3. Edit the /etc/hadoop/conf.rollback.datanode/hdfs-site.xml file and remove the dfs.datanode.max.locked.memory property.
4. If you kerberos enabled cluster then make sure change the value of hdfs.keytab to the absolute path of conf.rollback.datanode folder in core-site.xmland hdfs-site.xml
5. Run one of the following commands:
  - If the DataNode is running with privileged ports (usually 1004 and 1006):
```
cd /etc/hadoop/conf.rollback.datanode
export HADOOP_SECURE_DN_USER=hdfs
export JSVC_HOME=/opt/cloudera/parcels/<parcel_filename>/lib/bigtop-utils
hdfs --config /etc/hadoop/conf.rollback.datanode datanode -rollback
```
  - If the DataNode is not running on privileged ports:
```
sudo hdfs --config /etc/hadoop/conf.rollback.datanode datanode -rollback
```
  When the rolling back of the DataNodes is complete, terminate the console session by typing Control-C. Look for output from the command similar to the following that indicates when the DataNode rollback is complete:
```
Rollback of /dataroot/ycloud/dfs/dn/current/BP-<Block Group number> is complete
```
  You may see the following error after issuing these commands:
```
ERROR datanode.DataNode: Exception in secureMain java.io.IOException:
The path component: '/var/run/hdfs-sockets' in '/var/run/hdfs-sockets/dn' has permissions 0755 uid 39998 and gid 1006.
It is not protected because it is owned by a user who is not root and not the effective user: '0'.
```
  The error message will also include the following command to run:
```
chown root /var/run/hdfs-sockets 
```
  After running this command, the DataNode will restart successfully. Rerun the DataNode rollback command:
```
sudo hdfs --config /etc/hadoop/conf.rollback.datanode datanode -rollback
```
6. If High Availability for HDFS is enabled, restart the HDFS service. In the Cloudera Manager Admin Console, go to the HDFS service and select Actions > Restart.
7. If high availability is not enabled for HDFS, use the Cloudera Manager Admin Console to restart all NameNodes and DataNodes.
  1. Go to the HDFS service.
  2. Select the Instances tab
  3. Select all DataNode and NameNode roles from the list.
  4. Click Actions for Selected > Restart.
If high availability is not enabled for HDFS, roll back the Secondary NameNode.
1. (Clusters with TLS enabled only) Edit the /etc/hadoop/conf.rollback.secondarynamenode/ssl-server.xml file on all Secondary NameNode hosts (Located in the temporary rollback directory.) and update the keystore passwords with the actual cleartext passwords. The passwords will have values that look like this:
```
<property>
 <name>ssl.server.keystore.password</name>
 <value>********</value>
 </property>
 <property>
 <name>ssl.server.keystore.keypassword</name>
 <value>********</value>
 </property>
```
2. (TLS only) Edit the /etc/hadoop/conf.rollback.secondarynamenode/ssl-server.xml file and remove the hadoop.security.credential.provider.path property and change the value of property ssl.server.keystore.location to
```
/etc/hadoop/conf.rollback.secondarynamenode/cm-auto-host_keystore.jks 
```
3. Log in to the Secondary NameNode host and run the following commands:
```
rm -rf /dfs/snn/*
cd /etc/hadoop/conf.rollback.secondarynamenode/
sudo -u hdfs hdfs --config /etc/hadoop/conf.rollback.secondarynamenode secondarynamenode -format
            
```
  When the rolling back of the Secondary NameNode is complete, terminate the console session by typing Control-C. Look for output from the command similar to the following that indicates when the Secondary NameNode rollback is complete:
```
2020-12-21 17:09:36,239 INFO namenode.SecondaryNameNode: Web server init done
              
```
Restart the HDFS service. Open the Cloudera Manager Admin Console, go to the HDFS service page, and select Actions > Restart.
The Restart Command page displays the progress of the restart. Wait for the page to display the Successfully restarted service message before continuing.

Start the HBase Service

Restart the HBase Service. Open the Cloudera Manager Admin Console, go to the HBase service page, and select Actions > Start.

If you have configured any HBase coprocessors, you must revert them to the versions used before the upgrade.

If CDP 7.x HBase Master was started after the upgrade and there was any ongoing (or stuck) HBase Master Procedure present in the HBase Master before stopping the CDP 7 Cluster, it is expected for the CDP 7.1.7 SP1 HBase Master to fail with warnings and errors in the role log from the classes like 'ProcedureWALFormatReader' and 'WALProcedureStore' or 'TransitRegionStateProcedure'.

These errors mean that the HBase Master Write-Ahead Log files are incompatible with the CDP 7.1.7 SP1 HBase version. The only way to fix this problem is to sideline the log files (all the files placed under /hbase/MasterProcWALs by default), then restart the HBase Master. After the HBase Master has started, Use the HBCK command to find out if there are any inconsistencies that will need to be fixed manually.

You may encounter other errors when starting HBase (for example, replication-related problems, region assignment related issues, and meta region assignment problems). In this case you should delete the znode in ZooKeeper and then start HBase again. (This will delete replication peer information and you will need to re-configure your replication schedules.):

In Cloudera Manager, look up the value of the zookeeper.znode.parent property. The default value is /hbase.
Connect to the ZooKeeper ensemble by running the following command from any HBase gateway host:
```
zookeeper-client -server zookeeper_ensemble
```
To find the value to use for zookeeper_ensemble, open the /etc/hbase/conf.cloudera.<HBase service name>/hbase-site.xml file on any HBase gateway host. Use the value of the hbase.zookeeper.quorum property.
note
If you have deployed a secure cluster, you must connect to ZooKeeper using a client jaas.conf file. You can find such a file in an HBase process directory (/var/run/cloudera-scm-agent/process/). Specify the jaas.conf using the JVM flags by running the following commands in the ZooKeeper client:
```
CLIENT_JVMFLAGS=
                    "-Djava.security.auth.login.config=/var/run/cloudera-scm-agent/process/HBase_process_directory/jaas.conf"
                  
```
note
If you have deployed a secure cluster, you must connect to ZooKeeper using a client jaas.conf file. You can find such a file in an HBase process directory (/var/run/cloudera-scm-agent/process/). If the JAAS config file has "useTicketCache=false", make a copy of this file and replace it with "useTicketCache=true". Make sure the kerberos principal name matches with the name expected by the jaas.conf file. Specify the modified jaas.conf using the JVM flags by running the following commands in the ZooKeeper client:
```
CLIENT_JVMFLAGS=
                        "-Djava.security.auth.login.config=/var/run/cloudera-scm-agent/process/HBase_process_directory/<modified
                        jaas.conf file name>"
```
zookeeper-client -server <zookeeper_ensemble>
The ZooKeeper command-line interface opens.
Enter the following command:
```
rmr /hbase
```
note
If you have deployed a secure cluster, enter the following command:
deleteall /hbase
If you see the message “Node not empty: /hbase/tokenauth”, you must re-run the same command. Restart HBase service.
Restart the HBase service.
After HBase is healthy, make sure you restore the states of the Balancer and Normalizer (enable them if they were enabled before the rollback). Also re-enable the Merge and Split operations you disabled before the rollback to avoid the Master Procedure incompatibility problem. Run the following commands in HBase Shell:
```
balance_switch true
                normalizer_switch true
                splitormerge_switch 'SPLIT', true
                splitormerge_switch 'MERGE', true 
```

Fixing tableinfo file format

When you are rolling back from CDP Private Cloud Base 7.1.8 to CDH 6 if you encounter a change in the tableinfo file name format from the new tableinfo file name that was created during the 7.1.8 upgrade can prevent HBase from functioning normally.

After the rollback, if HDFS rollback was not successful and Hbase is unable to read the tableinfo files then use the HBCK2 tool to verify the list of tableinfo files that need to be fixed.

Follow these steps to execute the HBCK2 command on the HBCK2 tool to fix the tableinfo file format:

Contact Cloudera support to request the latest version of HBCK2 tool.
Use the following HBCK2 command and run the HBCK2 tool without the –fix option:
```
hbase --config /path/to/client/conf hbck -j
~/path/to/hbck/hbase-hbck2-1.0.0-<build>.jar shortenTableinfo 
```
For example:
```
hbase --config /etc/hbase/conf hbck -j
~/hbase-operator-tools/hbase-hbck2/target/hbase-hbck2-1.0.0-SNAPSHOT.jar shortenTableinfo
```
The command displays the following message and the list of files to be fixed:
Found the following tableinfo file names containing file size
If the list is empty, no additional steps are needed. Go to next step: Restore CDH Databases.

Use the following HBCK2 command and run the HBCK2 tool with the –fix option:

hbase --config /etc/hbase/conf hbck -j
~/hbase-operator-tools/hbase-hbck2/target/hbase-hbck2-1.0.0-SNAPSHOT.jar shortenTableinfo –fix

Check the output and verify whether all the tableinfo files are fixed.

Restore Databases

Restore the following databases from their 7.1.7 backups:

Hive Metastore
Hue
Oozie
Ranger
Ranger KMS
Schema Registry
Streams Messaging Manager

The rollback must use databases restored from the appropriate backed-up database. The steps for backing up and restoring databases differ depending on the database vendor and version you select for your cluster and are beyond the scope of this document.

See the following vendor resources for more information:

MariaDB 10.2, 10.3, 10.4 and 10.5:https://mariadb.com/kb/en/backup-and-restore-overview/
MySQL 5.7:https://dev.mysql.com/doc/refman/5.7/en/backup-and-recovery.html
MySQL 8:https://dev.mysql.com/doc/refman/8.0/en/backup-and-recovery.html
PostgreSQL 10:https://www.postgresql.org/docs/10/backup.html
PostgreSQL 11:https://www.postgresql.org/docs/11/backup.html
PostgreSQL 12:https://www.postgresql.org/docs/12/backup.html
PostgreSQL 13:https://www.postgresql.org/docs/13/backup.html
PostgreSQL 14:https://www.postgresql.org/docs/14/backup.html
Oracle 19c:https://docs.oracle.com/en/database/oracle/oracle-database/19/index.html

Roll Back Cloudera Search

Start the HDFS, Zookeeper and Ranger services.
Start the Solr service.
note
If the state of one or more Solr core is down and the Solr log contains an error message, it is necessary to clean up the HDFS locks in the index directories.
```
"org.apache.lucene.store.LockObtainFailedException: Lock obtain timed out:
 org.apache.solr.store.hdfs.HdfsLockFactory" 
```
For all the affected Solr nodes:
1. Stop the Solr node using Cloudera Manager.
2. Remove the HdfsDirectory<id>-write.lock file from the index directory.
  hdfs dfs -rm "/solr/<collection_name>/<core>/data/<index_directory_name>/HdfsDirectory@<hex_id> lockFactory=org.apache.solr.store.hdfs.HdfsLockFactory@<hex_id>-write.lock"
  For example:
  hdfs dfs -rm "/solr/testCollection/core_node1/data/index/HdfsDirectory@5d07feac lockFactory=org.apache.solr.store.hdfs.HdfsLockFactory@7df08aad-write.lock"
3. Start the Solr node using Cloudera Manager.
Restart Lily HBase Indexer (ks_indexer).

Roll Back Hue

Restore the file, app.reg, from your backup:

Parcel installations

rm -rf /opt/cloudera/parcels/CDH/lib/hue/app.reg
cp -rp app.reg_cm7_cdh6_backup /opt/cloudera/parcels/CDH/lib/hue/app.reg

Package Installations

rm -rf /usr/lib/hue/app.reg
cp -rp app.reg_cm7_cdh6_backup /usr/lib/hue/app.reg

Revert Cruise Control Goal

The following steps are applicable only if you downgrade from 7.1.8 to 7.1.7.

In Cruise Control, you must rename com.linkedin.kafka.cruisecontrol.analyzer.goals.RackAwareDistributionGoal to com.linkedin.kafka.cruisecontrol.analyzer.goals.RackAwareGoal in Cloudera Manager > Clusters > Cruise Control > Configurations tab in every occurrences as described below during rollback process.

In Cruise Control, from 7.1.8 and higher, com.linkedin.kafka.cruisecontrol.analyzer.goals.RackAwareGoal is renamed to com.linkedin.kafka.cruisecontrol.analyzer.goals.RackAwareDistributionGoal.

Perform the below steps:

Check the following goal sets if RackAwareDistributionGoal is present (Cloudera Manager > Clusters > Cruise Control > Configurations tab):
1. default.goals
2. goals
3. self.healing.goals
4. hard.goals
5. anomaly.detection.goals
Create a note for yourself about where RackAwareDistributionGoal were present
Remove RackAwareDistributionGoal from all of the goal lists
Perform the runtime rollback process
Insert the removed goal back to the relevant goal sets, but with the renamed goal name RackAwareGoal (Not RackAwareDistributionGoal)
Restart Cruise Control

Deploy the Client Configuration

On the Cloudera Manager Home page, click the Actions menu and select Deploy Client Configuration.
Click Deploy Client Configuration.

Restart the Cluster

On the Cloudera Manager Home page, click the Actions menu and select Restart.
Click Restart that appears in the next screen to confirm. If you have enabled high availability for HDFS, you can choose Rolling Restart instead to minimize cluster downtime. The Command Details window shows the progress of stopping services.
When All services successfully started appears, the task is complete and you can close the Command Details window.

(Optional) Cloudera Manager Rollback Steps

After you complete the rollback steps, your cluster is using Cloudera Manager 7 to manage your CDH 6 or CDH 6 cluster. You can continue to use Cloudera Manager 7 to manage your CDH 6 cluster, or you can downgrade to Cloudera Manager 6 by following these steps:

Stop Cloudera Manager

Stop the Cloudera Management Service.
1. Log in to the Cloudera Manager Admin Console.
2. Select Clusters > Cloudera Management Service.
3. Select Actions > Stop.
Stop the Cloudera Manager Server.
```
sudo systemctl stop cloudera-scm-server
```
Hard stop the Cloudera Manager agents. Run the following command on all hosts:
```
sudo systemctl stop cloudera-scm-supervisord.service
```
Back up the repository directory. You can create a top-level backup directory and an environment variable to reference the directory using the following commands. You can also substitute another directory path in the backup commands below:
```
export CM_BACKUP_DIR="`date +%F`-CM"
              mkdir -p $CM_BACKUP_DIR
```

Back up the existing repository directory.

RHEL / CentOS

sudo -E tar -cf $CM_BACKUP_DIR/repository.tar /etc/yum.repos.d

SLES

sudo -E tar -cf $CM_BACKUP_DIR/repository.tar /etc/zypp/repos.d

Ubuntu

sudo -E tar -cf $CM_BACKUP_DIR/repository.tar /etc/apt/sources.list.d

Restore the Cloudera Manager Repository Files

Copy the repository directory from the backup taken before upgrading to Cloudera Manager 7.x.

rm -rf /etc/yum.repos.d/*
tar -xf cm6cdh6_backedUp_dir/repositary.tar -C CM6CDH6/
cp -rp /etc/yum.repos.d_cm6cdh6/* /etc/yum.repos.d/

Restore Packages

Run the following commands on all hosts:

Operating System Command

RHEL

Operating System	Command
RHEL	`sudo yum remove cloudera-manager-daemons cloudera-manager-agent` `sudo yum clean all sudo yum install cloudera-manager-agent`
SLES	`sudo zypper remove cloudera-manager-daemons cloudera-manager-agent` `sudo zypper refresh -s sudo zypper install cloudera-manager-agent`
Ubuntu or Debian	`sudo apt-get purge cloudera-manager-daemons cloudera-manager-agent` `sudo apt-get update sudo apt-get install cloudera-manager-agent`

sudo yum remove cloudera-manager-daemons cloudera-manager-agent

sudo yum clean all
sudo yum install cloudera-manager-agent

SLES

sudo zypper remove cloudera-manager-daemons cloudera-manager-agent

sudo zypper refresh -s
sudo zypper install cloudera-manager-agent

Ubuntu or Debian

sudo apt-get purge cloudera-manager-daemons cloudera-manager-agent

sudo apt-get update
sudo apt-get install cloudera-manager-agent

Run the following commands on the Cloudera Manager server host:

Operating System Command

RHEL

Operating System	Command
RHEL	`sudo yum remove cloudera-manager-server` `sudo yum install cloudera-manager-server`
SLES	`sudo zypper remove cloudera-manager-server` `sudo zypper install cloudera-manager-server`
Ubuntu or Debian	`sudo apt-get purge cloudera-manager-server` `sudo apt-get install cloudera-manager-server`

sudo yum remove cloudera-manager-server

sudo yum install cloudera-manager-server

SLES

sudo zypper remove cloudera-manager-server

sudo zypper install cloudera-manager-server

Ubuntu or Debian

sudo apt-get purge cloudera-manager-server

sudo apt-get install cloudera-manager-server

Restore Cloudera Manager Databases

Restore the Cloudera Manager databases from the backup of Cloudera Manager that was taken before upgrading to Cloudera Manager 7. See the procedures provided by your database vendor.

These databases include the following:

Cloudera Manager Server
Reports Manager
Navigator Audit Server
Navigator Metadata Server
Activity Monitor (Only used for MapReduce 1 monitoring).

MariaDB 10.2, 10.3, 10.4 and 10.5:https://mariadb.com/kb/en/backup-and-restore-overview/
MySQL 5.7:https://dev.mysql.com/doc/refman/5.7/en/backup-and-recovery.html
MySQL 8:https://dev.mysql.com/doc/refman/8.0/en/backup-and-recovery.html
PostgreSQL 10:https://www.postgresql.org/docs/10/backup.html
PostgreSQL 11:https://www.postgresql.org/docs/11/backup.html
PostgreSQL 12:https://www.postgresql.org/docs/12/backup.html
PostgreSQL 13:https://www.postgresql.org/docs/13/backup.html
PostgreSQL 14:https://www.postgresql.org/docs/14/backup.html
Oracle 19c:https://docs.oracle.com/en/database/oracle/oracle-database/19/index.html

Here is an sample command to restore a MySQL database:

mysql -u username -ppassword --host=hostname cm < backup.sql

Restore Cloudera Manager Server

Use the backup of Cloudera Manager 6.x taken before upgrading to Cloudera Manager 7.x for the following steps:

If you used the backup commands provided in Step 2: Backing Up Cloudera Manager 7, extract the Cloudera Manager 6 backup archives you created:
```
tar -xf CM6CDH6/cloudera-scm-agent.tar -C CM6CDH6/
tar -xf CM6CDH6/cloudera-scm-server.tar -C CM6CDH6/
```

On the host where the Event Server role is configured to run, restore the Events Server directory from the Cloudera Manager 6 backup.

cp -rp /var/lib/cloudera-scm-eventserver /var/lib/cloudera-scm-eventserver-CM
rm -rf /var/lib/cloudera-scm-eventserver/*
cp -rp /var/lib/cloudera-scm-eventserver_cm6cdh6/* /var/lib/cloudera-scm-eventserver/

Remove the Agent runtime state. Run the following command on all hosts:
```
rm -rf /var/run/cloudera-scm-agent /var/lib/cloudera-scm-agent/response.avro
```

On the host where the Service Monitor is running, restore the Service Monitor directory:

rm -rf /var/lib/cloudera-service-monitor/*
cp -rp /var/lib/cloudera-service-monitor_cm6cdh6/* /var/lib/cloudera-service-monitor/

On the host where the Host Monitor is running, restore the Host Monitor directory:

rm -rf /var/lib/cloudera-host-monitor/*
cp -rp /var/lib/cloudera-host-monitor_cm6cdh6/* /var/lib/cloudera-host-monitor/

Restore the Cloudera Navigator Solr storage directory from the CM6/CDH6 backup.

rm -rf /var/lib/cloudera-scm-navigator/*
cp -rp /var/lib/cloudera-scm-navigator_cm6cdh6/* /var/lib/cloudera-scm-navigator/

On the Cloudera Manager Server, restore the /etc/cloudera-scm-server/db.properties file.

rm -rf /etc/cloudera-scm-server/db.properties
cp -rp cm6cdh6/etc/cloudera-scm-server/db.properties /etc/cloudera-scm-server/db.properties

On each host in the cluster, restore the /etc/cloudera-scm-agent/config.ini file from your backup.

rm -rf /etc/cloudera-scm-agent/config.ini
cp -rp cm6cdh6/etc/cloudera-scm-agent/config.ini /etc/cloudera-scm-agent/config.ini

Start the Cloudera Manager Server and Agents

Start the Cloudera Manager Server.
```
sudo systemctl start cloudera-scm-server
```
Stopping Agents - To stop or restart Agents while leaving the managed processes running, use one of the following commands: sudo systemctl stop cloudera-scm-agent
Starting Agents - To start Agents, the supervisor process, and all managed service processes, use the following command: sudo systemctl start cloudera-scm-agent
Start the Cloudera Management Service.
1. Log in to the Cloudera Manager Admin Console.
2. Select Clusters > Cloudera Management Service.
3. Select Actions > Start.