[MAPREDUCE-3839] Improve the single node setup docs for MR

• Type: Improvement
• Status: Resolved
• Priority: Trivial
• Resolution: Duplicate
• Affects Version/s: 0.23.1
• Component/s: documentation
• Assignee: Unassigned
• Reporter: Harsh J
• Created: 08/Feb/12 14:18
• Updated: 31/Jan/14 05:30
• Resolved: 31/Jan/14 04:52

Description

I'm gonna be recording all nits I can about the page at http://hadoop.apache.org/common/docs/r0.23.0/hadoop-yarn/hadoop-yarn-site/SingleCluster.html here:

• The section at http://hadoop.apache.org/common/docs/r0.23.0/hadoop-yarn/hadoop-yarn-site/SingleCluster.html#Mapreduce_Tarball is suitable to developers, not users. We should instead just point to releases page for tarball.
• On http://hadoop.apache.org/common/docs/r0.23.0/hadoop-yarn/hadoop-yarn-site/SingleCluster.html#Setting_up_the_environment since the tarball structure is definite, we could do better to either point to a link to configure HDFS and Common or provide instructions ourselves. Same applies to path the MR envs ought to be set to – none of these are mentioned.
• Under http://hadoop.apache.org/common/docs/r0.23.0/hadoop-yarn/hadoop-yarn-site/SingleCluster.html#Setting_up_Configuration. one of the "Add the following configs" text is defined as a heading, while other isn't.
• The "Create Symlinks" and "Running daemons" sections do not appear in the index on top.
• Remove the "Good luck." at the end – Users shouldn't need luck to setup good stuff

OT comment: The "Create Symlinks" part is curious. That we need symlinks to run MR looks very wrong to me.

Issue Links

• is part of: HADOOP-10139 Update and improve the Single Cluster Setup document