Opsview Knowledge Center

Network Analyzer

Learn how to install Opsview Monitor Network Analyzer module

In this section, we offer step-by-step instructions providing you with specific guidance to successfully install the Opsview Monitor Network Analyzer; particularly the 'NetAudit' module. It's important that you have reviewed section Pre-requisites 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.

RANCID requires the Opsview Monitor messaging system to be installed, see this section for more information.

NetAudit Master

The NetAudit master 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.

Package Installation

Opsview Monitor packages are located in the same repository as the Opsview Monitor software. In this section, we provide step-by-step guidance, which assumes that the repository has been correctly set up as per this section.

Automated Installation Modules

You can choose to install Opsview Monitor modules individually or together by using the 'm flag in the command line, as shown in the example below. You will be prompted to install each module individually, if you have a subscription for them.

curl 'l http://install.opsview.com | sudo bash 's -- -m

Debian and Ubuntu Installation

In the example below, we show you the command used to install the NetAudit module for both a Debian and Ubuntu distribution. You need to run these commands as root.

apt-get install opsview-rancid opsview-rancid-master

Red Hat and CentOS Installation

In the example below, we show you the command used to install the NetAudit module for both a Red Hat and CentOS distribution. You need to run these commands as root.

yum install opsview-rancid opsview-rancid-master

SLES Installation

In the example below, we show you the command used to install the NetAudit module for the SLES distribution. You need to run these commands as root.

zypper install opsview-rancid opsview-rancid-master

Master Configuration

You must amend the Opsview Monitor proxy configuration file, either /etc/httpd/conf.d/opsview or /etc/apache2/sites-available/opsview (depending on your OS) and uncomment the section shown in the example below. Note: Ensure that PHP5 is installed, configured and operating as normal.

# Enables websvn for RANCID integration - requires php5 Alias /websvn /opt/opsview/repository 
ProxyPass /websvn !  See above section to set 'TKTAuthSecret' and other comments <Location /websvn> AuthType None TKTAuthLoginURL /login?app=websvn TKTAuthTimeout 86400s #TKTAuthIgnoreIP on  require valid-user </Location>

You will need to restart Apache and ensure that your configuration is correct by logging in to Opsview Monitor.

Once logged in, select "Modules \x{00E2}\x{0086}\x{0092} NetAudit", where you should see the websvn page indicating RANCID as the repository, as shown in the screenshot below:

Finally, run a send2slaves on the Opsview master to synchronize the software on all slaves.

Monitoring

Use the check_rancid_status plugin to monitor the status of the NetAudit updates. This will alert you if no updates have been picked up for a configured device within the last 24 hours. It works by simply looking in the master's svn directory, which holds a copy of the latest configuration. The plugin also checks the timestamp to determine how old the files are.

NetAudit Collector

The NetAudit collector is an application that is used to collect router configuration data and is typically installed on Opsview Monitor Master and Slave nodes.

To install the NetAudit collector, you need to install the following packages in the order that they are listed. You will need to ensure the nagios user has opsview group access:

  • opsview-perl
  • opsview-rancid-collector

Collector Configuration

On all NetAudit collectors whether installed on a Master or Slave node, the nagios user should have opsview group access. If you make a change on a slave, you will need to restart Opsview Monitor so that new permissions are picked up. However, if you have made changes to the Master, you will also need to restart opsview-web.

Backup

The Subversion (SVN) repository for NetAudit is located at /var/opt/opsview/svnroot/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.

Network Analyzer

Learn how to install Opsview Monitor Network Analyzer module