Welcome to docs.opsview.com


Rancid collectors

On all rancid collectors (Opsview master and slaves), the nagios user should have opsview group access. If you make a change, you will need to restart opsview to pick up the new user permissions. If you make a change on the Opsview master, you will need to restart opsview-web.

Rancid master

Opsview master

If Rancid master is on the same server as Opsview master, edit the opsview proxy configuration file (either /etc/httpd/conf.d/opsview or /etc/apache2/sites-available/opsview) and uncomment the following section as appropriate (this required php5 to be installed, configured and working as well):

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

Restart Apache.

Check Apache is configured correctly by logging into Opsview and going to Modules → RANCID. You should see a websvn page with Rancid as the repository.

Run a send2slaves on Opsview master to sync software on slaves.

Opsview monitoring

Use the check_rancid_status plugin to monitor the status of the Rancid updates. This will alert if no updates have been sent. This works by looking in the master's svn directory which should hold a copy of the latest configurations. The plugin checks the timestamps to see how old these files are.


The SVN repository for rancid is stored at /var/opt/opsview/svnroot/rancid. As the SVN repository holds all the changes to the router configuration over time, this is sufficient to backup for Opsview Rancid.

If you use a filesystem backup, there is the possibility that the SVN repository will be in an indetermined state if changes occur while the backup is in progress. Alternatively, you can use svnadmin dump to take a full dump of the repository or svnadmin hotcopy to take a hot copy of the repository and then backup the resultant directory.

See the official SVN documentation for more information on backing up an SVN repository.