[jira] Updated: (HBASE-2328) Make important configurations more obvious to new users

["stack (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/HBASE-2328?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

stack updated HBASE-2328:
-------------------------

    Attachment: notsoquick.html

I just committed an edit that adds example config. for distributed hbase and that adds requirements section from overview with some extra fill.  Sill a bunch TODO.  I added what page currently looks like.

> Make important configurations more obvious to new users
> -------------------------------------------------------
>
>                 Key: HBASE-2328
>                 URL: https://issues.apache.org/jira/browse/HBASE-2328
>             Project: HBase
>          Issue Type: Improvement
>          Components: documentation
>            Reporter: Jean-Daniel Cryans
>             Fix For: 0.90.0
>
>         Attachments: notsoquick.html
>
>
> Over the last 2 weeks, I encountered many situations where people didn't set file descriptors and xcievers higher and that was causing a ton of problems that are hard to debug if you're not used to them. To improve that we should:
>  - Refuse to start HBase if ulimit -n returns some small number smaller than 2048, or at least print out in big red blinking letters that the current configuration is bad and then link to a simple troubleshooting entry on the wiki.
>  - Write a clearer Getting Started document where we don't give as much explanations but add more stuff like "this is what your hbase-site.xml/hdfs-site/xml should look like now" and give a complete file example. At this point we don't even give a number for xcievers and we expect new users to come up with one.
> Any other low hanging fruit others can think of?

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