Mirror/zeek
1
0
Fork 0
mirror of https://github.com/zeek/zeek.git synced 2025-10-02 14:48:21 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Improve the "How to Upgrade" page in the Bro docs

Browse source 
Added some text to clarify the procedure (it now reads more like
a step-by-step guide to upgrading).
This commit is contained in:
Daniel Thayer 2016-11-09 14:55:55 -06:00
parent 0db028ea91
commit 2347be3092
1 changed files with 33 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

53
doc/install/guidelines.rst
View file

@ -10,40 +10,53 @@ there's two suggested approaches: either install Bro using the same
installation prefix directory as before, or pick a new prefix and copy installation prefix directory as before, or pick a new prefix and copy
local customizations over. local customizations over.
Regardless of which approach you choose, if you are using BroControl, then
before doing the upgrade you should stop all running Bro processes with the
"broctl stop" command. After the upgrade is complete then you will need
to run "broctl deploy".
In the following we summarize general guidelines for upgrading, see In the following we summarize general guidelines for upgrading, see
the :ref:`release-notes` for version-specific information. the :ref:`release-notes` for version-specific information.
Reusing Previous Install Prefix Reusing Previous Install Prefix
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you choose to configure and install Bro with the same prefix If you choose to configure and install Bro with the same prefix
directory as before, local customization and configuration to files in directory as before, first stop all running Bro instances in your
``$prefix/share/bro/site`` and ``$prefix/etc`` won't be overwritten cluster (if using BroControl, issue the "broctl stop" command on the
(``$prefix`` indicating the root of where Bro was installed). Also, logs manager host). Next, make a backup of the Bro install prefix directory.
generated at run-time won't be touched by the upgrade. Backing up local
changes before upgrading is still recommended.
After upgrading, remember to check ``$prefix/share/bro/site`` and During the upgrade, any file in the install prefix may be
``$prefix/etc`` for ``.example`` files, which indicate that the overwritten or removed, except for local customization of
distribution's version of the file differs from the local one, and therefore, files in the ``$prefix/share/bro/site`` and ``$prefix/etc``
may include local changes. Review the differences and make adjustments directories (``$prefix`` indicating the root
as necessary. Use the new version for differences that aren't a result of of where Bro was installed). Also, logs generated at run-time
a local change. won't be touched by the upgrade.
After upgrading, remember to check the ``$prefix/share/bro/site`` and
``$prefix/etc`` directories for files with a file extension of ``.example``,
which indicate that the distribution's version of the file differs from the
local one, and therefore, may include local changes. Review the
differences and make adjustments as necessary. Use the new version
for differences that aren't a result of a local change.
Finally, if using BroControl, then issue the "broctl deploy" command. This
command will check for any policy script errors, install the new version
of Bro to all machines in your cluster, and then it will start Bro.
Using a New Install Prefix Using a New Install Prefix
~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~
To install the newer version in a different prefix directory than before, To install the newer version in a different prefix directory than before,
copy local customization and configuration files from ``$prefix/share/bro/site`` first stop all running Bro instances in your cluster (if using BroControl,
and ``$prefix/etc`` to the new location (``$prefix`` indicating the root of then issue a "broctl stop" command on the manager host). Next,
where Bro was originally installed). Review the files for differences install the new version of Bro in a new directory.
Next, copy local customization and configuration files
from the ``$prefix/share/bro/site`` and ``$prefix/etc`` directories to the
new location (``$prefix`` indicating the root of where Bro was originally
installed). Review the files for differences
before copying and make adjustments as necessary (use the new version for before copying and make adjustments as necessary (use the new version for
differences that aren't a result of a local change). Of particular note, differences that aren't a result of a local change). Of particular note,
the copied version of ``$prefix/etc/broctl.cfg`` is likely to need changes the copied version of ``$prefix/etc/broctl.cfg`` is likely to need changes
to any settings that specify a pathname. to any settings that specify a pathname.
Finally, if using BroControl, then issue the "broctl deploy" command. This
command will check for any policy script errors, install the new version
of Bro to all machines in your cluster, and then it will start Bro.