mirror of
https://github.com/zeek/zeek.git
synced 2025-10-01 22:28:20 +00:00
3d2dc5f5fc
* origin/topic/script-reference: (50 commits) A few updates for the FAQ. Fixing some doc warnings. Forgot to add protocol identifier support for TLS 1.2 Finished SSL & syslog autodocs. Adding the draft SSL extension type next_protocol_negotiation. Fix some documentation errors. Tweaks. A set of script-reference polishing. fixed a couple typos in comments Add summary documentation to bif files. Add ssl and syslog script documentation Add Conn and DNS protocol script documentation. (fixes #731) Small updates to the default local.bro. Documentation updates for HTTP & IRC scripts. SSH&FTP Documentation updates. Fixing a warning from the documentation generation. This completes framework documentation package 4. Minor notice documentation tweaks. Fix some malformed Broxygen xref roles. Minor doc tweaks to init-bare.bro. ... Conflicts: aux/broccoli aux/broctl src/bro.bif src/strings.bif Includes: - Updated baselines for autodoc tests. - Now excluding stats.bro from external texts, it's not stable.
92 lines
2.8 KiB
Text
92 lines
2.8 KiB
Text
==============
|
|
Installing Bro
|
|
==============
|
|
|
|
Prerequisites
|
|
=============
|
|
|
|
Bro relies on the following libraries and tools, which need to be installed
|
|
before you begin:
|
|
|
|
* CMake 2.6 or greater http://www.cmake.org
|
|
|
|
* Libpcap (headers and libraries) http://www.tcpdump.org
|
|
|
|
* OpenSSL (headers and libraries) http://www.openssl.org
|
|
|
|
* SWIG http://www.swig.org
|
|
|
|
* Libmagic
|
|
|
|
* Libz
|
|
|
|
Bro can make uses of some optional libraries if they are found at
|
|
installation time:
|
|
|
|
* LibGeoIP For geo-locating IP addresses.
|
|
|
|
Bro also needs the following tools, but on most systems they will
|
|
already come preinstalled:
|
|
|
|
* Bash (For Bro Control).
|
|
* BIND8 (headers and libraries)
|
|
* Bison (GNU Parser Generator)
|
|
* Flex (Fast Lexical Analyzer)
|
|
* Perl (Used only during the Bro build process)
|
|
|
|
|
|
Installation
|
|
============
|
|
|
|
To build and install into ``/usr/local/bro``::
|
|
|
|
./configure
|
|
make
|
|
make install
|
|
|
|
This will first build Bro into a directory inside the distribution
|
|
called ``build/``, using default build options. It then installs all
|
|
required files into ``/usr/local/bro``, including the Bro binary in
|
|
``/usr/local/bro/bin/bro``.
|
|
|
|
You can specify a different installation directory with::
|
|
|
|
./configure --prefix=<dir>
|
|
|
|
Note that ``/usr`` and ``/opt/bro`` are the standard prefixes for
|
|
binary Bro packages to be installed, so those are typically not good
|
|
choices unless you are creating such a package.
|
|
|
|
Run ``./configure --help`` for more options.
|
|
|
|
Depending on the Bro package you downloaded, there may be auxiliary
|
|
tools and libraries available in the ``aux/`` directory. All of them
|
|
except for ``aux/bro-aux`` will also be built and installed by doing
|
|
``make install``. To install the programs that come in the
|
|
``aux/bro-aux`` directory, use ``make install-aux``. There are
|
|
``--disable-*`` options that can be given to the configure script to
|
|
turn off unwanted auxiliary projects.
|
|
|
|
OpenBSD users, please see our `FAQ
|
|
<http://www.bro-ids.org/documentation/faq.html>` if you are having
|
|
problems installing Bro.
|
|
|
|
Running Bro
|
|
===========
|
|
|
|
Bro is a complex program and it takes a bit of time to get familiar
|
|
with it. A good place for newcomers to start is the Quickstart Guide
|
|
at http://www.bro-ids.org/documentation/quickstart.bro.html.
|
|
|
|
For developers that wish to run Bro directly from the ``build/``
|
|
directory (i.e., without performing ``make install``), they will have
|
|
to first adjust ``BROPATH`` to look for scripts inside the build
|
|
directory. Sourcing either ``build/bro-path-dev.sh`` or
|
|
``build/bro-path-dev.csh`` as appropriate for the current shell
|
|
accomplishes this and also augments your ``PATH`` so you can use the
|
|
Bro binary directly::
|
|
|
|
./configure
|
|
make
|
|
source build/bro-path-dev.sh
|
|
bro <options>
|