You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@bookkeeper.apache.org by "Flavio Junqueira (Created) (JIRA)" <ji...@apache.org> on 2011/11/25 17:11:40 UTC

[jira] [Created] (BOOKKEEPER-120) Review BookKeeper client documentation

Review BookKeeper client documentation
--------------------------------------

                 Key: BOOKKEEPER-120
                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
             Project: Bookkeeper
          Issue Type: Sub-task
            Reporter: Flavio Junqueira




--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (BOOKKEEPER-120) Review BookKeeper client documentation

Posted by "Ivan Kelly (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/BOOKKEEPER-120?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13158585#comment-13158585 ] 

Ivan Kelly commented on BOOKKEEPER-120:
---------------------------------------

Could you put the patch in review board? I have a few comments which would be easier to make there.
                
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Flavio Junqueira
>             Fix For: 4.0.0
>
>         Attachments: BOOKKEEPER-120-v2.patch, BOOKKEEPER-120.patch, BOOKKEEPER-120.patch
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (BOOKKEEPER-120) Review BookKeeper client documentation

Posted by "Sijie Guo (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/BOOKKEEPER-120?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13158457#comment-13158457 ] 

Sijie Guo commented on BOOKKEEPER-120:
--------------------------------------

Why there is two 'ledger_dirs' settings in 'Bookie configuraiton' section? Is it duplicated? 
{code}
+p. Directory Bookkeeper outputs its write ahead log, ideally in a dedicated device. The default value is "/tmp/bk-txn".
+
+* ledger_dirs
+
+p. Directory Bookkeeper outputs ledger snapshots could define multiple directories to store snapshots, comma separated. For example: /tmp/bk1-data,/tmp/bk2-data
+
+* ledger_dirs
+
+p. Ideally ledger dirs and journal dir are each in a differet device, which reduce the contention between random i/o and sequential write. It is possible to run with a single disk, but performance will be significantly lower.
+
{code}

BTW, BOOKKEEPER-119 is trying to standardize configuration keys in bookkeeper.
                
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Flavio Junqueira
>             Fix For: 4.0.0
>
>         Attachments: BOOKKEEPER-120.patch
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (BOOKKEEPER-120) Review BookKeeper client documentation

Posted by "Ivan Kelly (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/BOOKKEEPER-120?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ivan Kelly updated BOOKKEEPER-120:
----------------------------------

    Attachment: BOOKKEEPER-120.diff

Moved most of the changes to BK-122. Changed the programmer guide a lot. It used to read like apidoc. Now its more of a primer on the api, which will allow people to jump off into the apidoc.
                
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Flavio Junqueira
>             Fix For: 4.0.0
>
>         Attachments: BOOKKEEPER-120-v2.patch, BOOKKEEPER-120.diff, BOOKKEEPER-120.patch, BOOKKEEPER-120.patch
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (BOOKKEEPER-120) Review BookKeeper client documentation

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

Hudson commented on BOOKKEEPER-120:
-----------------------------------

Integrated in bookkeeper-trunk #250 (See [https://builds.apache.org/job/bookkeeper-trunk/250/])
    BOOKKEEPER-120: Review BookKeeper client documentation (ivank)

ivank : 
Files : 
* /zookeeper/bookkeeper/trunk/CHANGES.txt
* /zookeeper/bookkeeper/trunk/doc/bookkeeperProgrammer.textile

                
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Ivan Kelly
>             Fix For: 4.0.0
>
>         Attachments: BOOKKEEPER-120-v2.patch, BOOKKEEPER-120.diff, BOOKKEEPER-120.patch, BOOKKEEPER-120.patch
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (BOOKKEEPER-120) Review BookKeeper client documentation

Posted by "Flavio Junqueira (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/BOOKKEEPER-120?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Flavio Junqueira updated BOOKKEEPER-120:
----------------------------------------

    Attachment: BOOKKEEPER-120.patch

Thanks for pointing out the typo, Sijie. I'm uploading a new patch.

On the comment about BOOKKEEPER-119, are you suggesting that we wait for it to get in to have the modifications reflected in the documentation?

Btw, if you see anything in a patch that you believe needs to get fixed, just go ahead and cancel the patch. 
                
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Flavio Junqueira
>             Fix For: 4.0.0
>
>         Attachments: BOOKKEEPER-120.patch, BOOKKEEPER-120.patch
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (BOOKKEEPER-120) Review BookKeeper client documentation

Posted by "Flavio Junqueira (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/BOOKKEEPER-120?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Flavio Junqueira updated BOOKKEEPER-120:
----------------------------------------

    Attachment: BOOKKEEPER-120-v2.patch

I've rebased the patch to comply with the changes of BOOKKEEPER-119.
                
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Flavio Junqueira
>             Fix For: 4.0.0
>
>         Attachments: BOOKKEEPER-120-v2.patch, BOOKKEEPER-120.patch, BOOKKEEPER-120.patch
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (BOOKKEEPER-120) Review BookKeeper client documentation

Posted by "Benjamin Reed (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/BOOKKEEPER-120?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13159580#comment-13159580 ] 

Benjamin Reed commented on BOOKKEEPER-120:
------------------------------------------

+1 looks good
                
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Flavio Junqueira
>             Fix For: 4.0.0
>
>         Attachments: BOOKKEEPER-120-v2.patch, BOOKKEEPER-120.diff, BOOKKEEPER-120.patch, BOOKKEEPER-120.patch
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (BOOKKEEPER-120) Review BookKeeper client documentation

Posted by "Flavio Junqueira (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/BOOKKEEPER-120?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Flavio Junqueira updated BOOKKEEPER-120:
----------------------------------------

    Attachment: BOOKKEEPER-120.patch

I reviewed the documents and added text. Most of what I added is about parameters. I added a detailed description of parameters to bookkeeperConfig.
                
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Flavio Junqueira
>             Fix For: 4.0.0
>
>         Attachments: BOOKKEEPER-120.patch
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Assigned] (BOOKKEEPER-120) Review BookKeeper client documentation

Posted by "Flavio Junqueira (Assigned) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/BOOKKEEPER-120?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Flavio Junqueira reassigned BOOKKEEPER-120:
-------------------------------------------

    Assignee: Flavio Junqueira
    
> Review BookKeeper client documentation
> --------------------------------------
>
>                 Key: BOOKKEEPER-120
>                 URL: https://issues.apache.org/jira/browse/BOOKKEEPER-120
>             Project: Bookkeeper
>          Issue Type: Sub-task
>            Reporter: Flavio Junqueira
>            Assignee: Flavio Junqueira
>             Fix For: 4.0.0
>
>


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira