Hey! These docs are for version 6.3, which is no longer officially supported. Click here for the latest version, 6.7!

## Overview

This page describes how to investigate Opsview Monitor problems.

## Opsview Components

The first place you should go to when you are encountering issues with Opsview Monitor is the Configuration > My System > System Overview tab, as below:


If there are problems with a component, or some missing components, this page will highlight them.

## Diagnostics

On the 'Monitoring Engine' tab there is also a button labeled `Download Now`, which will download a _.tar.gz_ file with all the relevant syslogs, etc:


This diagnostic information will be useful when you raise issues with our support team.

## Web User Interface Not Working

If the web interface is the problem then you will not be able to access these web pages. If this is the case, run the command `/opt/opsview/watchdog/bin/opsview-monit summary` as the root user, as seen below:

If you have any issues with the processes above, i.e. opsview-web, then you can restart an individual process with the command:

You should also check to make sure your database is up, running and accessible.

You can also view detailed information about each process by running the following command as the root user:

If you encounter the error:

Then the opsview-watchdog service is not running. To start it, as root, run the commands:

This will kill any leftover processes, start the daemon, and then restart all the services which the watchdog is controlling.

If the watchdog process starts but the processes it is monitoring do not, check your sudo configuration (using the command `visudo`) does not have `Defaults requiretty` enabled. If it does, disable it (by commenting it out with a '#' character) and rerun the following:

Finally, if your watchdog services start (as per the 'summary' command), but suddenly shutdown after a minute, you may not have enough free disk space. Opsview Monitor requires a MINIMUM of 2GB free space. If this threshold is breached, Opsview Monitor will elegantly shutdown instead of crashing and leaving the system in a problematic state when the disk space issue is resolved.

To confirm you are encountering the disk space issue, run the command:

If you see these errors, you should check your free disk space using `df`:

## Logs

Logs are always a good place to start when it comes to troubleshooting. See the [Logging](🔗) section for information about how logs are generated.

## Databases

We have seen issues where a database has a bad schema and indexes are given the wrong name. This causes problems for the upgrade scripts as they expect specific names to exist when upgrading. Follow this process to reset the schema while retaining the existing data. You should not normally have to do this.

  • Stop all Opsview Components

  • Take a backup of the opsview database: /opt/opsview/coreutils/bin/db_opsview db_backup > /tmp/opsview.db

  • Take another backup, for comparing differences: mysqldump -u {user} -p{password} --skip-extended-insert opsview > /tmp/opsview.diff

  • Export just data from the database: mysqldump --skip-extended-insert -t -c -u {user} -p{password} opsview > /tmp/opsview.data

  • Create the database from scratch: /opt/opsview/coreutils/bin/db_opsview db_install

  • Export the schema information from a fresh install: mysqldump -d -u {user} -p{password} opsview > /tmp/opsview.schema

  • Delete and recreate just the database: echo 'drop database opsview; create database opsview' | mysql -u {user} -p{password}

  • Import the fresh schema information: mysql -u {user} -p{password} opsview < /tmp/opsview.schema

  • Import the data: mysql -u {user} -p{password} opsview < /tmp/opsview.data

  • Take a new backup: /opt/opsview/coreutils/bin/db_opsview db_backup > /tmp/opsview_post.db

  • Take another backup, for comparing: mysqldump -u {user} -p{password} --skip-extended-insert opsview > /tmp/opsview2.diff

  • Compare to check differences: diff -u /tmp/opsview.diff /tmp/opsview2.diff

  • Start all Opsview Components

## Other

Please see the below section for 'other' troubleshooting steps to look into, if the steps above do not resolve your problem.

## CentOS/RHEL - Automatic dependencies

`yum` should automatically resolve all dependencies when installing Opsview Monitor. However, in some instances during installation, if the Opsview Monitor packages don't include opsview-base, opsview-perl and so on, then ensure yum-updatesd-helper is not running and execute the following commands:

Finally, running the command shown below should show the correct dependencies and allow Opsview Monitor to install correctly:

## Access denied for some files within the repositories

If you replicate our public repository to a server on your own network, you may find you get 'Access Denied' errors when trying to copy some files.

This is expected behavior as some files within the repository are restricted to customers that purchase additional modules.