You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@hbase.apache.org by "Nicolas Spiegelberg (JIRA)" <ji...@apache.org> on 2011/08/23 21:10:29 UTC

[jira] [Created] (HBASE-4244) Make bin/hbase help more useful

Make bin/hbase help more useful
-------------------------------

                 Key: HBASE-4244
                 URL: https://issues.apache.org/jira/browse/HBASE-4244
             Project: HBase
          Issue Type: Improvement
    Affects Versions: 0.92.0
            Reporter: Nicolas Spiegelberg
            Assignee: Nicolas Spiegelberg
            Priority: Minor


Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (HBASE-4244) Make bin/hbase help more useful

Posted by "Nicolas Spiegelberg (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Nicolas Spiegelberg updated HBASE-4244:
---------------------------------------

    Resolution: Fixed
        Status: Resolved  (was: Patch Available)

> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (HBASE-4244) Make bin/hbase help more useful

Posted by "Todd Lipcon (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13089713#comment-13089713 ] 

Todd Lipcon commented on HBASE-4244:
------------------------------------

Maybe we should split off the "admin tools" into different binaries? Exposing HFile analyzer and such in the same shell wrapper as bin/hbase seems a little odd to me.

> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (HBASE-4244) Make bin/hbase help more useful

Posted by "Todd Lipcon (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13089776#comment-13089776 ] 

Todd Lipcon commented on HBASE-4244:
------------------------------------

Sure, seems fine to commit this as is and do the refactor separately. I could see something like:

sbin/hbase-regionserver
sbin/hbase-analyze-hlog
sbin/hbase-analyze-hfile
bin/hbase-shell

etc - stuff that normal users would use would go in bin, stuff for admins and daemons would go in sbin, and we'd have a separate shell script per command rather than funneling them all through "bin/hbase <foo>". Nicer tab completion :)


> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (HBASE-4244) Make bin/hbase help more useful

Posted by "Nicolas Spiegelberg (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Nicolas Spiegelberg updated HBASE-4244:
---------------------------------------

    Attachment: HBASE-4244.patch

New shell prompt shown below.  I'm open to alterations or we can always iterate after this patch.

{code}
Usage: hbase <command>
where <command> an option from one of these categories:

DBA TOOLS
  shell            run the HBase shell
  hbck             run the hbase 'fsck' tool
  hlog             write-ahead-log analyzer
  hfile            store file analyzer
  migrate          upgrade an hbase.rootdir
  zkcli            run the ZooKeeper shell

PROCESS MANAGEMENT
  master           run an HBase HMaster node
  regionserver     run an HBase HRegionServer node
  zookeeper        run a Zookeeper server
  rest             run an HBase REST server
  thrift           run an HBase Thrift server
  avro             run an HBase Avro server

PACKAGE MANAGEMENT
  classpath        dump hbase CLASSPATH
  version          print the version

 or
  CLASSNAME        run the class named CLASSNAME
Most commands print help when invoked w/o parameters.
{code}

> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (HBASE-4244) Make bin/hbase help more useful

Posted by "Nicolas Spiegelberg (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13089719#comment-13089719 ] 

Nicolas Spiegelberg commented on HBASE-4244:
--------------------------------------------

other possible utils we could include:
1. HBaseConfTool (conftool)
2. DFS FsShell (dfs)
3. DFS Client version (dfsversion)

We could be smart about #2 & #3 & only include those options if the client has configured HDFS as its default filesystem.

> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (HBASE-4244) Make bin/hbase help more useful

Posted by "stack (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13089744#comment-13089744 ] 

stack commented on HBASE-4244:
------------------------------

I like the new layout.  Refactor of our bin folder is probably well overdue (especially if done w/ usabillity in mind).  Maybe that should happen in diff issue though?

> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (HBASE-4244) Make bin/hbase help more useful

Posted by "Hudson (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13089913#comment-13089913 ] 

Hudson commented on HBASE-4244:
-------------------------------

Integrated in HBase-TRUNK #2134 (See [https://builds.apache.org/job/HBase-TRUNK/2134/])
    HBASE-4244 Refactor bin/hbase help

nspiegelberg : 
Files : 
* /hbase/trunk/src/main/java/org/apache/hadoop/hbase/regionserver/wal/HLogPrettyPrinter.java
* /hbase/trunk/bin/hbase
* /hbase/trunk/CHANGES.txt


> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (HBASE-4244) Make bin/hbase help more useful

Posted by "Nicolas Spiegelberg (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13089728#comment-13089728 ] 

Nicolas Spiegelberg commented on HBASE-4244:
--------------------------------------------

@Todd: Maybe this is a good place to bring up discussion about how we want to organize our administration tools.  It's kind of odd that 'bin/hbase' is basically useless other than the 'shell' and 'version' utilities right now.  Process management is not practically the point of this script.  You actually don't want users to directly issue:

{code}
bin/hbase regionserver start
{code}

they should instead issue:

{code}
bin/hbase-daemon.sh start regionserver
{code}

which is completely non-intuitive.

> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (HBASE-4244) Make bin/hbase help more useful

Posted by "stack (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13089781#comment-13089781 ] 

stack commented on HBASE-4244:
------------------------------

@Todd +1

@Nicolas +1 on patch.

> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (HBASE-4244) Make bin/hbase help more useful

Posted by "Nicolas Spiegelberg (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/HBASE-4244?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Nicolas Spiegelberg updated HBASE-4244:
---------------------------------------

    Status: Patch Available  (was: Open)

> Make bin/hbase help more useful
> -------------------------------
>
>                 Key: HBASE-4244
>                 URL: https://issues.apache.org/jira/browse/HBASE-4244
>             Project: HBase
>          Issue Type: Improvement
>    Affects Versions: 0.92.0
>            Reporter: Nicolas Spiegelberg
>            Assignee: Nicolas Spiegelberg
>            Priority: Minor
>         Attachments: HBASE-4244.patch
>
>
> Talking with Doug Meil yesterday, I found out he didn't know we had an HLog or HFile analyzer.  We should add these quick links to the bin/hbase help prompt.  Additionally, we should reword the help so it's very clear what tools DBAs have at their disposal vs package/process management.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira