Nagios Network Analyzer - Offline Upgrade

Overview

This KB article will show you how to upgrade Nagios Network Analyzer in an offline environment.

An offline environment is described as one that does not have direct internet access. Normally the server you are installing Nagios Network Analyzer onto requires internet access to install packages from repositories.

This KB article shows you how to modify the installation so it does not require internet access. However you will still need to download some packages on a computer that has internet access and then transfer those packages to your offline server.

This KB article was written using Nagios Network Analyzer 2.3.2 and upgrading it to 2.4.0. Future versions may have additional components that are not addressed in this KB article and will need to be taken into consideration if the process does not work as expected.

Requirements

This method requires two servers.

• Internet facing computer

  • This computer is required for downloading specific files that are normally required by the installation package

  • Once these files have been downloaded, this computer will need to be able to transfer them to the offline server

• Offline Server

  • This is the server that you want to perform the offline upgrade on, it will already have Nagios Network Analyzer installed on it

  • The server will require access to offline repositories of:

    • Operating System Repositories

    • EPEL Repository [ CentOS | RHEL | Oracle Linux ]

    • If your server is running RHEL you also need the Optional Channel Repo

  • This guide will refer to this server as Offline Server

Download Required Files

On your internet facing computer you need to download the Nagios Network Analyzer tarball:

https://assets.nagios.com/downloads/nagios-network-analyzer/nagiosna-latest.tar.gz

All versions of Nagios Network Analyze can be located here:

https://assets.nagios.com/downloads/nagios-network-analyzer/versions.php

Once you have downloaded the Nagios Network Analyzer tarball you need to transfer it to your offline server into the /tmp/ location. Steps on how to do this are not provided here, however you can use a program like WinSCP to perform the transfer.

Offline Server

Establish a terminal session to the offline server as the root user.

As mentioned under the requirements section, the offline server will require access to offline repositories of:

• Operating System Repositories

• EPEL Repository [ CentOS | RHEL | Oracle Linux ]

• If your server is running RHEL you also need the Optional Channel Repo

Next step will be to modify the upgrade script so it doesn't require internet access. The required modifications will be explained first and underneath will be some commands that will automatically make these changes for you.

Comment out this line as EPEL is already available as an offline repository:

add_yum_repo "epel"

These commands will make the changes described above:

cd /tmp
rm -rf nagiosna*
tar xzf nagiosna-latest.tar.gz
cd /tmp/nagiosna
sed -i '/add_yum_repo "epel"/s/^/#/' upgrade

Now run this command to install Nagios Network Analyzer:

./upgrade

Wait for the install to complete. If it is successful it should end with:

Nagios Network Analyzer Upgrade Complete!

You can access the Nagios Network Analyzer web interface by visiting:
    http://xxx.xxx.xxx.xxx/nagiosna/

After the upgrade is complete a reboot is required, type the following command to reboot your Nagios Network Analyzer server:

reboot

Once the server has rebooted proceed to the URL provided in the output above to confirm the Nagios Network Analyzer upgrade was successful.

Additional Notes

Certain components of Nagios Network Analyzer require an internet connection. For example the Home page has the check for updates functionality. These will simply report errors like "An error occurred while trying to fetch the Nagios Core feed", which can be ignored.

Final Thoughts

For any support related questions please visit the Nagios Support Forums at:

http://support.nagios.com/forum/