hadoop-common-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Doug Cutting (JIRA)" <j...@apache.org>
Subject [jira] Commented: (HADOOP-1917) Need configuration guides for Hadoop
Date Wed, 07 Nov 2007 21:19:51 GMT

    [ https://issues.apache.org/jira/browse/HADOOP-1917?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12540897
] 

Doug Cutting commented on HADOOP-1917:
--------------------------------------

quickstart.html:

We must, for legal reasons, distinguish between developer documentation and end-user documentation.
 End users should not be encouraged to use subversion or nightly releases, since software
obtained that way is not distributed under the Apache license as a release is.  So it's best
to keep mention of subversion and nightly releases in developer-specific documentation.

We don't document the use of 'rsync' to automatically update Hadoop software on slave nodes
at startup, so perhaps we should remove mention of the dependency on rsync from the docs?
 (Does anyone use this feature anymore?  If not, perhaps we should remove it.)

setup.html:

The page linked to by the "Install & Configure" menu item is titled "Hadoop Cluster -
Setup".  Perhaps both should be replaced with something like "Cluster Configuration", and
the file should be called "cluster-config.html"?  In general, the menu items don't need to
use the term "Hadoop", while the page titles probably should.

The documentation of mapred.map.tasks and mapred.reduce.tasks here should link to the more
detailed description in the mapred tutorial.

mapred_tutorial.html:

The menu entry for this should be just "Map/Reduce Tutorial", without "Hadoop".

> Need configuration guides for Hadoop
> ------------------------------------
>
>                 Key: HADOOP-1917
>                 URL: https://issues.apache.org/jira/browse/HADOOP-1917
>             Project: Hadoop
>          Issue Type: Improvement
>          Components: conf
>    Affects Versions: 0.14.1
>            Reporter: Sameer Paranjpye
>            Assignee: Arun C Murthy
>            Priority: Critical
>             Fix For: 0.16.0
>
>         Attachments: HADOOP-1917_1_20071025.patch, HADOOP-1917_2_20071031.patch, HADOOP-1917_3_20071031.patch,
HADOOP-1917_4_20071105.patch, HADOOP-1917_5_20071106.patch, HADOOP-1917_6_20071106.patch
>
>
> We've recently had a spate of questions on the users list regarding features such as
rack-awareness, the trash can etc. which are not clearly documented from a user/admins perspective.
There is some Javadoc present but most of the "documentation" exists either in JIRA or in
the default config files themselves.
> We should generate top down configuration and use guides for map/reduce and HDFS. These
should probably be in forest and accessible from the project website (Javadoc isn't always
approachable to our non-programmer audience). Committers should look for user documentation
before accepting patches.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message