SysOrb Network Monitoring System Administrator's Guide: For version 3.6.0 | ||
---|---|---|
Prev | Chapter 5. SysOrb Server Configuration | Next |
The SysOrb Servers SSL support uses the OpenSSL libraries. On all platforms except Windows, it uses the version of OpenSSL that ships with the operating system. This chapter describes how to troubleshoot SSL check problems on the Unix-like platforms.
The most common problem is that the check shows "No Connection" even though the service is accessible. It usually happens because the OpenSSL library is not installed on the host OS. If this is the case, you will be seeing "No connection" errors in the SysOrb Web Interface, and the server log will contain the following message:
Could not load SSL-library. Please check the administrators guide for information about how to fix this problem
The first thing to check is that the OpenSSL library is installed on the host OS. How to ensure this can be seen in the list below:
On the platforms that aren't mentioned below, the SysOrb Server package depends on the OpenSSL package being installed. So if the SysOrb Server package can be installed, the OpenSSL library is also installed.
On Mandrake/Mandriva one of libopenssl0, libopenssl0.9.7 or libopenssl0.9.8 should be installed.
Please consult the Mandrake/Mandriva documentation for information about how to install one of these packages.
On solaris there are two options for providing OpenSSL. On Solaris 10, an OpenSSL library package is included in the operating system. This package is called SUNWopenssl-libraries. On Solaris 8 and 9 OpenSSL is not a part of the operating system. However an OpenSSL package can be downloaded from http://www.sunfreeware.com.
To check if one of these packages are installed you should execute the following commands:
pkginfo -l SUNWopenssl-libraries
pkginfo -l SMCossl
If one of these commands succeeds in printing out informaiton about the package, the OpenSSL library is installed.
If none of these packages are installed, you should install one of them. For Solaris 10, please consult the Solaris documentation for information about how to install the SUNWopenssl-libraries package. For Solaris 8 and 9, follow the instructions available from http://www.sunfreeware.com.
It is not necessary to restart the SysOrb Server, if the OpenSSL library was installed while the SysOrb Server was running.
If the OpenSSL library is installed, and SysOrb still cannot
find the OpenSSL library, you can specify the exact location of
libssl.so (or similar named), by using the libssl
server configuration option. See Section 5.3.4 for information about
this option.
If you instead get a message stating
Error loading libraryor
Error dynamically loading functionit means that your version of OpenSSL is incompatible with SysOrb. In this case you should either upgrade to a newer version provided by your OS provider, or download the source code from http://openssl.org and compile it by hand. Instructions on how to do this can be found on the OpenSSL homepage. Note that after the installation, it might be necessary to use the
libssl
to get the
SysOrb Server to use the correct version of openssl.