Checkpoint HDFS

You must perform additional steps before upgrading your HDP cluster if you have configured NameNode HA to create a checkpoint for HDFS.

  1. If you are configured for NameNode HA, then locate the Active NameNode from Ambari Web > Services > HDFS in the Summary area.
  2. Check the NameNode directory to ensure that there is no snapshot of any prior HDFS upgrade. Specifically, using Ambari Web, browse to Services > HDFS > Configs, and examine the in the NameNode Directories property. Make sure that only a /current directory exists and remove /previous directory on the NameNode host.
  3. Create the following log and other files. The commands below back up additional state from the file system in addition to what fsImage contains. This information can be used to validate the filesystem state after the upgrade by comparing the output before or after the upgrade. This can help but is not required for troubleshooting if issues arise during the upgrade.
    Authenticate as the HDFS user su -l [HDFS_USER]

    Run the following (where [HDFS_USER] is the HDFS Service user, for example, hdfs):

    • Run fsck with the following flags and send the results to a log. The resulting file contains a complete block map of the file system. You use this log later to confirm the upgrade.

      hdfs fsck / -files -blocks -locations > dfs-old-fsck-1.log
    • Create a list of all the DataNodes in the cluster.

      hdfs dfsadmin -report > dfs-old-report-1.log
    • Capture the complete namespace of the file system. The following command does a recursive listing of the root file system:

      hdfs dfs -ls -R / > dfs-old-lsr-1.log
    • Take a backup of the HDFS data to your local file system or the backup instance of your HDFS.
  4. Save the namespace. As the HDFS user, " su -l [HDFS_USER] ", you must put the cluster in Safe Mode.
    • hdfs dfsadmin -safemode enter
    • hdfs dfsadmin -saveNamespace
  5. Copy the checkpoint files located in $[]/current into a backup directory.
  6. Store the layout version for the NameNode located at $[]/current/VERSION into a backup directory where $[] is the value of the config parameter NameNode directories.
  7. This file will be used later to verify that the layout version is upgraded. As the HDFS user, su -l [HDFS_USER], take the NameNode out of Safe Mode. hdfs dfsadmin -safemode leave