[HDFS-6800] Support Datanode layout changes with rolling upgrade

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.0.0-alpha1
• Fix Version/s: 2.6.0
• Component/s: datanode
• Hadoop Flags: Reviewed
• Assignee: James Thomas
• Reporter: Colin McCabe
• Created: 01/Aug/14 04:28
• Updated: 12/May/16 21:14
• Resolved: 29/Aug/14 11:29

Description

We need to handle attempts to rolling-upgrade the DataNode to a new storage directory layout.

One approach is to disallow such upgrades. If we choose this approach, we should make sure that the system administrator gets a helpful error message and a clean failure when trying to use rolling upgrade to a version that doesn't support it. Based on the compatibility guarantees described in HDFS-5535, this would mean that any future DataNode layout changes would require a major version upgrade.

Another approach would be to support rolling upgrade from an old DN storage layout to a new layout. This approach requires us to change our documentation to explain to users that they should supply the -rollback command on the command-line when re-starting the DataNodes during rolling rollback. Currently the documentation just says to restart the DataNode normally.

Another issue here is that the DataNode's usage message describes rollback options that no longer exist. The help text says that the DN supports -rollingupgrade rollback, but this option was removed by HDFS-6005.

Issue Links

• is related to: HDFS-6005 Simplify Datanode rollback and downgrade
• is related to: HDFS-5535 Umbrella jira for improved HDFS rolling upgrades
• is required by: HDFS-6981 Fix DN upgrade with layout version change
• is required by: HDFS-6581 Write to single replica in memory
• relates to: HDFS-6482 Use block ID-based block layout on datanodes