[Bro-Dev] [JIRA] (BIT-1160) Update cluster documentation

[Daniel Thayer (JIRA)]

    [ https://bro-tracker.atlassian.net/browse/BIT-1160?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15806#comment-15806 ] 

Daniel Thayer commented on BIT-1160:
------------------------------------

I believe that the cluster doc that exists currently was not intended to provide
details like which config files to edit, but rather to explain the components that
make up the bro cluster architecture and provide a high-level discussion of related
topics such as load balancing.  It's the type of document someone should read
before installing Bro, because it provides background information that could help
to guess what hardware might be needed to deploy a Bro cluster, and which type of
load-balancing to use.

I think the title of the page is misleading (rather than "setting up a bro cluster", it
should probably be something like "bro cluster architecture").  Similarly, it would
make more sense if the document were moved up, between the introduction section
and the installing bro section.

Adding more links to other documents (for example, Justin wrote some useful documentation
on configuring Bro with PF_RING) will help avoid duplicating information.

The existing instructions on configuring a Bro cluster could be improved, as well.


> Update cluster documentation
> ----------------------------
>
>                 Key: BIT-1160
>                 URL: https://bro-tracker.atlassian.net/browse/BIT-1160
>             Project: Bro Issue Tracker
>          Issue Type: Problem
>          Components: Bro
>    Affects Versions: git/master
>            Reporter: Bernhard Amann
>            Assignee: Daniel Thayer
>              Labels: documentation
>             Fix For: 2.3
>
>         Attachments: signature.asc
>
>
> We should update the Cluster documentation, if possible before releasing 2.3.
> I set up a Bro cluster for the first time yesterday - and when you look at the current state at the documentation it is not very useful...
> ...for example it contains things like (link to an example for the config) in the text. Furthermore it does not really mention how to actually configure Bro for a cluster, there is no mention of node.cfg, etc.



--
This message was sent by Atlassian JIRA
(v6.2-OD-10-004-WN#6253)