In this section, we offer step-by-step instructions providing you with specific guidance to successfully install the NetAudit module. It’s important that you have reviewed the Prerequisites section first, to ensure that any software and hardware dependencies, along with any limitations are fully understood prior to installation.
In this section, we have split functionality subject to the function of your server. The Network Audit module comprises two components, namely the ‘NetAudit master’ and ‘NetAudit collector’. You should choose the section that is relevant to your installation, i.e. whether you are installing the Opsview Monitor master or a collector.
The NetAudit is the central RANCID repository which retains the configuration data (stored using Subversion) and includes code for easy integration with Opsview Monitor; this is installed on the Opsview Monitor master.
The opsview-netaudit component in 6.0 version has replaced the old opsview-rancid and opsview-rancid-master components.
- Opsview Web App
To install Netaudit, you need to edit
/opt/opsview/deploy/etc/user_vars.yml file and add or uncomment the following
## Uncomment below to activate these optional modules opsview_module_netaudit: True
For a Fresh install, follow the instructions in the Advanced Automated Installation page.
If, however, you are installing Netaudit on an existing system (including Virtual Appliances), run the following command as root after activating Opsview:
# install and configure Netaudit cd /opt/opsview/deploy ./bin/opsview-deploy lib/playbooks/setup-opsview.yml # setup self monitoring for Netaudit ./bin/opsview-deploy lib/playbooks/setup-monitoring.yml
In either case, ensure that the optional module is included in your Opsview license.
If you have installed NetAudit with Opsview-Deploy, you don’t need any manual configuration changes. The following configuration sections are just for information.
The user configuration options should be set in
/opt/opsview/netaudit/etc/netaudit.yaml. Default values are shown in
/opt/opsview/netaudit/etc/netaudit.defaults.yaml, but changes should not be made here since the file will get overwritten on package update.
The following options can be set:
path: Path of SVN repository. sandbox: Path of SVN sandbox. definition_file: Path of definition.xml file for hosts. (You shouldn't need to change this.) error_directory: Location to store any corrupt data retrieved from hosts.
The repository path needs to be aligned with WebSVN php configuration which is kept in the following file:
registry: Connection configuration for the Registry
<?php $config->setTemplatePath("./templates/calm/"); $config->addRepository("rancid", "file:///opt/opsview/netaudit/var/repository/rancid"); $config->useEnscript(); ?>
Opsview Monitor keeps configuration file change history in SVN and uses WebSVN to display them in web UI.
WebSVN uses PHP5 and Apache web server. WebSVN Apache configuration is kept either in /etc/httpd/conf.d/opsview.conf or /etc/apache2/sites-available/opsview.conf depending on your OS.
The Apache configuration for WebSVN is shown below:
# Enables websvn for Netaudit/RANCID integration Alias /websvn /opt/opsview/repository ProxyPass /websvn ! <Location /websvn> AuthType None TKTAuthLoginURL /login?app=websvn TKTAuthTimeout 86400s #TKTAuthIgnoreIP on require valid-user </Location>
You must not need to change this configuration.
Once logged in, go to Monitoring > NetAudit where you should see the WebSVN page indicating RANCID as the repository.
The Subversion (SVN) repository for NetAudit is located at /opt/opsview/netaudit/var/repository/rancid. It retains all the changes made to the router configuration over time and is sufficient to back up the Opsview NetAudit.
If you use a file system back up, then there is the possibility that the SVN repository will be in an indeterminate state, especially if changes occur while the backup is in progress. Alternatively, you can use ‘svnadmin dump’ to take a full snapshot of the repository or ‘svnadmin hotcopy’ to make a copy of the repository where you can then use that hot copy as the backup.
The NetAudit Collector is an application that is used to collect router configuration data and is typically installed on Opsview Monitor Collector nodes.
The opsview-netaudit-collector component in 6.0 version has replaced the old opsview-rancid and opsview-rancid-collector components.
If you have installed NetAudit with Opsview-Deploy, you don’t need any manual configuration changes. The following section is just for information.
The user configuration options can be set in
/opt/opsview/netauditcollector/etc/netauditcollector.yaml. Default configurations are shown in
/opt/opsview/netauditcollector/etc/netauditcollector.defaults.yaml, but changes should not be made here since the file will get overwritten on package update.
NetAudit Collector configurations should not be changed unless there is a good reason for it.
NetAudit Collector is triggered by a cronjob from opsview user account. The cronjob runs every 4 hours:
# OPSVIEW-NETAUDIT-COLLECTOR-START and OPSVIEW-NETAUDIT-COLLECTOR-END # will be automatically installed as part of an Opsview NetAudit Collector 22 2,6,10,14,18,22 * * * /opt/opsview/netauditcollector/bin/run_rancid_collect # OPSVIEW-NETAUDIT-COLLECTOR-END
No data is kept on NetAudit Collectors so there is no backup procedure for NetAudit Collector. The NetAudit backups need to be taken from NetAudit (master) module which is explained above.