Welcome to docs.opsview.com

Opsview Community is deprecated - read more here. Showing the most current documentation for Opsview Core

Installation Guide - Sun Solaris 10

Before you start

Solaris is no longer supported for new versions of Opsview. These instructions are for historical purposes

For supported Sun Solaris releases please refer to platforms.

Planning

Planning your system should take into account how many hosts you plan on monitoring - large numbers of hosts being monitored may best be served by using a distributed system - see our design notes for further information.

Partitioning

Opsview System

One large / partition is fine, but we recommend a partitioning schema of at least / and /var

  • / - Sufficient space for Operating System and upgrades
  • /boot - Recommend separate boot partition of 256MB
  • /usr/local - Opsview software is installed here. Recommend > 10GB

Database System

The databases are stored on the master server. Check file systems:

  • /var - Opsview database and backups are stored here

Security settings

Opsview servers should be located in a secure area of your network. If you allow Opsview to on a public network, we recommend a firewall to restrict access to various ports. See this page for ports used by Opsview.

Prerequisites

Package Dependencies

This installation is based on base Solaris 10 install using 'Default Install' (If 'Custom Install', choose 'End User' installation cluster (SUNWCuser), 'Developer' is also fine, but 'Core' will be too minimal and require additional packages).

Note: Be aware of which zone some of the packages need to be installed in if using containers.

Note: Remember to download the required architecture type (i386/SPARC/AMD64).

To install a package use the command:

pkgadd -d . [packagename].pkg

Prior to Opsview 3.13.1 additional packages were required from SunFreeware. This requirement has now changed to use OpenCSW packages instead.

Amend the default PATH for all users by amending /etc/default/login and /etc/default/su to include

PATH=/opt/csw/mysql5/bin:/opt/csw/bin:/usr/bin:/usr/local/bin:/usr/sfw/bin:/opt/sfw/bin
SUPATH=/opt/csw/sbin:/opt/csw/mysql5/bin:/opt/csw/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin:/usr/sfw/sbin:/usr/sfw/bin:/opt/sfw/sbin:/opt/sfw/bin

and log out and back in again.

Install the OpenCSW package utility by running

pkgadd -d http://get.opencsw.org/now all

and amend /etc/opt/csw/pkgutil.conf to include

mirror=http://mirror.opencsw.org/opencsw/dublin

Update the local copy of the available package catalog using

pkgutil --catalog

The following command will install required packages

pkgutil -i sudo perl mysql5 mysql5client coreutils \
  gtar rrdtool CSWlibmcrypt apache2 ap2_modphp5 \
  php5_gettext php5_mbstring php5_gd php5_mysql \
  graphviz pm_snmpsession pm_rrdtool mrtg \
  CSWpmlibwww CSWpmiosocketssl CSWlibgif4 

specifying auto to install the packages as required.

Then run the following commands to make some gnu utilities available using standard names, and also put the OpenCSW perl package into place

cd /opt/csw/bin
for i in tar  id    ; do
  test -L g$i || ln -s g$i $i
done

cd /usr/bin
for i in perl perldoc   ;do
  test -e $i.sun || mv $i $i.sun
  test -e $i || ln -s /opt/csw/bin/$i $i
done

Installation

Please download all the files from http://downloads.opsview.com/opsview-core/latest/solaris for the appropriate bit level of your system (use isainfo -b to check).

1. Uncompress the files

2. Set up OS requirements for library linking

crle -l /lib:/usr/lib:/opt/csw/lib:/opt/csw/mysql5/lib:/opt/csw/mysql5/lib/mysql

3. Allow 'nagios' user to use cron. Run vi /etc/cron.d/cron.allow and enter:

nagios

4. Install the 6 Opsview packages in the following order:

apache2-modauthtkt-opsview
opsview-compatibility-check
opsview-perl
opsview-base
opsview-core
opsview-web

After the installation is complete

  • The rest of the steps should be performed as the nagios user
su - nagios
  • Set the MySQL root password to a different value (the default is blank)”
mysqladmin -u root password [changeme]
  • Confirm that the nagios user is using the bash shell:
echo $SHELL
  • Edit the opsview configuration file and amend the password as you see fit to secure the system (those passwords that should be changed as set to changeme by default). Note that any service checks for MySQL systems will also require the default password of changeme to be amended.

Note: Do not use any 'funny' shell characters in the password, such as $ or !.

vi /usr/local/nagios/etc/opsview.conf   # change passwords in this file
  • Set up the Opsview mysql database users with the necessary permissions
/usr/local/nagios/bin/db_mysql -u root -pchangeme
  • Install the required databases
/usr/local/nagios/bin/db_opsview db_install
/usr/local/nagios/bin/db_runtime db_install
  • Generate all the necessary configuration files for Opsview and Nagios® Core to run
/usr/local/nagios/bin/rc.opsview gen_config
  • You can now start up the web application server and the agent:
/etc/init.d/opsview-web start
/etc/init.d/opsview-agent start

The Opsview server is now listening on port 3000, i.e. http://your.server:3000/

Optional Further Configuration

Mail Notifications

Opsview is set up to use /usr/bin/Mail as its mail command for sending notifications. To get this to work on Solaris, you can create a symlink to the 'mailx' command in /usr/bin:

ln -s /usr/bin/mailx /usr/bin/Mail

Using Apache as a Proxy Server

The performance of Opsview will be significantly improved by using Apache at the front end.

To use Apache, do the following as root:

usermod -G nagcmd nobody
perl -p -i -e 's/^;date.timezone.*/date.timezone = UTC/' /opt/csw/php5/lib/php.ini
svcadm disable cswapache2
cp /usr/local/nagios/installer/apache_proxy.conf /opt/csw/apache2/etc/extra/opsview.conf

echo 'Include /opt/csw/apache2/etc/extra/opsview.conf' >> /opt/csw/apache2/etc/httpd.conf
svcadm enable cswapache2

For Opsview 4.0, you can also add this line:

echo 'LoadModule auth_tkt_module libexec/mod_auth_tkt.so' >> /opt/csw/apache2/etc/httpd.conf

You can now access Opsview at http://your.server/

Logging in

Once Opsview has been installed, a single administrative user will have been created. The credentials for this user are:

username: admin
password: initial

You should change this password to prevent unauthorised access to Opsview - this can be done from the 'Preferences' screen under 'Users' in the left navigation bar.

Navigation
Print/export
Toolbox