[ 
https://issues.apache.org/jira/browse/HBASE-14236?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14701600#comment-14701600
 ] 

kramerli commented on HBASE-14236:
----------------------------------

Thanks for the reply.

Yes, quick start should has minimal required config.
However the advanced section is also part of the quick start. 
http://hbase.apache.org/book.html#quickstart_fully_distributed

Newbee who follow the instruction to setup the env and find there is fatal 
error will feel very frustrated.

My suggestion is to add some text like this:

"""
Please be noted that in current Hbase version, the master or backup master 
server is also a type of region server. So when you decide to start the region 
server and backup master on the same node for example node-b.example.com. It 
will hit error as the port can be used for only one of them.

To resolve this issue you can edit config/hbase-site.xml add below config

        <property>
                <name>
                        hbase.regionserver.port
                </name>
                <value>
                        18020
                </value>
                <source>
                        hbase-default.xml
                </source>
        </property>

This will force the region server to use some different port to avoid the 
conflict.  
"""

I think the text can be added at the "Procedure: Prepare node-b and node-c".  :)

> A bug in Reference Guide, Quick Start section
> ---------------------------------------------
>
>                 Key: HBASE-14236
>                 URL: https://issues.apache.org/jira/browse/HBASE-14236
>             Project: HBase
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 1.0.1.1
>         Environment: CentOS Linux release 7.1.1503 (Core) 
>            Reporter: kramerli
>             Fix For: 1.0.1.1
>
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> This is an error on online documation.  
> (http://hbase.apache.org/book.html#_get_started_with_hbase ).
> To locate the error you can go to 
> 2.2. Get Started with HBase
> Example 2. Example hbase-site.xml for Standalone HBase
> The config example here do not specify a port for the region server. So When 
> you go to the 2.4 Advanced - Fully Distributed 
> (http://hbase.apache.org/book.html#quickstart_fully_distributed). You will 
> hit error.
> Because the region server will conflict with backup master or master. As they 
> use the same port.
> People who read this section are always newbee, this will confuse them.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to