Welcome to docs.opsview.com

User guide


To assign a host to Rancid, edit the host. There should be a tab for Rancid.

If you click on the Use Rancid checkbox, you will be presented with additional options. You need to choose the vendor, the connection method and add a username and password. Help will appear when the vendor has been changed (for instance, Cisco devices do not require a username, but need a second password).

Note: On Solaris, there is a bug with using the Ellacoya vendor. This will be fixed in a future version of Opsview Rancid.

When you have filled in these details, click on the Check Connection button. This will attempt to login to the system. If there are no errors, then the connection details are correct and should be saved. You then need to reload Opsview so that the host is monitored and RANCID collections will begin.

Note: You need to have at least 1 service assigned to the host to see the host in Opsview.

If you get an error saying:

Cannot check rancid connection: permission denied: /opt/opsview/rancid/bin/check_rancid_connection 

Then the nagios user has not been added to the opsview group. Fix this so that id nagios returns the opsview group and restart Opsview Web.

Viewing the router configuration

For devices that have RANCID configured, you can select the host popup menu and the RANCID option will be available. Select that to go to the SVNweb interface to look at the current and historical configurations.

Performing a manual run

Collections are normally performed every 4 hours, but a manual run can be initiated as the nagios user by running the following on the relevant monitoring server (i.e. the master or slave).


This can take some time to complete, especially where there are significant numbers of devices (at most 3 devices are checked in parallel).

Sending emails of changes

To send emails when a change has occurred to any router, set the email address via the RANCID tab in System Preferences. Reload to take effect.

Overriding RANCID options

From Opsview 4.5 you can override rancid default options by editting /usr/local/nagios/etc/plugins/rancid/cloginrc_local. This file is distributed to all slaves (not just the one monitoring the device) which may have security implications where slaves can be accessed by 3rd parties.