Nagios Core Services Platform (CSP) Installation Guide

Purpose
This document is intended to outline the steps required to download and install the Nagios Core
Services Platform on its compatible Linux distributions, Windows operating systems, and macOS.

Platform Support
See Nagios Software / OS Supported Versions
If you discover bugs or have fixes for installing Nagios XI on other platforms, please let us know. We
will do our best to incorporate your improvements to expand support for additional platforms in
future XI releases, which will make future installation processes smoother for you and your clients.

Terminal Access
For Linux installations these instructions require you to establish a terminal session to the server in
which you plan to install Nagios CSP on. You will need to login as the root user to perform the
installation (or a user with root privileges).

Additional Notes
The primary featured monitoring solution on the CSP distribution is Nagios XI. This guide will take you
through the steps involved in getting the Nagios XI virtual machine that is part of the CSP distribution
up and running on the following operating systems:
• Linux
• Windows
• macOS
If you run into problems with installation or configuration of Nagios XI or the CSP distribution, please
contact our team on the community support forum at: https://www.nagios.org/community

Don’t forget to use code CSP50 when licensing Nagios XI for your free 50 node license!

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.
Nagios Core Services Platform (CSP) Installation Guide

Using on Linux
This guide will detail how to obtain the Nagios CSP .iso or .zip file on supported Linux distributions

1. Setting up the filesystem for OVA/ZIP

a. There are two files you can use, one is the OVA and one is the ZIP file
b. Setting up the ISO
i. wget https://assets.nagios.com/downloads/csp/CSP-latest.iso
ii. Create a Mount Directory
1. sudo mkdir /mnt/iso
iii. Mount the ISO
1. Assuming you have the ISO file in /path/to/file.iso you can mount it to
/mnt/iso
a. sudo mount -o loop /path/to/file.iso /mnt/iso
b. Be sure to replace /path/to/file.iso with your actual path to the ISO
c. Setting up the ZIP
i. wget https://assets.nagios.com/downloads/csp/CSP-latest.zip
ii. Create a Directory for Extraction
1. sudo mkdir /mnt/zipfile
iii. Install unzip (If not already installed)
1. For RHEL/Centos Systems
a. sudo dnf install unzip
2. For Debian/Ubuntu based Systems
a. sudo apt install unzip
iv. Extract the ZIP
1. sudo unzip /path/to/file.zip -d /mnt/zipfile
d. You have now either mounted or unzipped the CSP
e. Time to either import and use the OVA or to install the tarball

2. Manual Installation using the tarball

a. Be sure you are using a supported version of linux first (Supported OS)
b. Also be sure that this machine has nothing else important installed on it, it should be a
fresh install of linux
c. Navigate into the parts folder
i. Assuming you have already navigated into the CSP folder after mounting or
unzipping
1. cd PARTS

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.
Nagios Core Services Platform (CSP) Installation Guide

2. scp xi-2024RX.X.X.tar.gz /tmp

a. Be sure to replace the X.X.X with the current version of XI
b. You can check the contents of the folder by doing
i. ls -halt
3. Extract the tarball
a. tar xzf xi-2024RX.X.X.tar.gz
4. Move into the nagiosxi folder and run the install script
a. cd nagiosxi
b. ./fullinstall

3. Importing the OVA through VMware Workstation on Linux

a. Download and install VMware Workstation
i. Visit the VMware Workstation Pro download page and select the latest Linux
version
1. You can obtain VMware Workstation Pro 17 free for personal use by using
this link.
2. If you need help with downloading and installing VMware Workstation, this
link will be able to assist you with the process
ii. Install
1. Open a terminal and navigate to your download directory
2. Run these commands to run and make the bundle files executable
a. sudo chmod +x VMware-Workstation-Full-*.bundle
b. sudo ./VMware-Workstation-Full-*.bundle
b. Launch VMWare Workstation
i. Open VMware workstation
c. Import the OVA
i. In the top left-hand corner, go to File > Open
1. Navigate to the folder where you had either mounted or extracted the OVA
ii. Click the green ‘Open’ button in the top right to import the OVA
1. Assign a name and storage location
iii. A progress bar will appear, once gone the OVA is ready for use
4. Use the machine
a. Before powering on there are some things to check/change
b. Right click on the machine and click settings
c. Change the network adapter to bridged
i. Click the network adapter
ii. Under network connection, select Bridged
d. Ensure Virtualize Intel VT-x/EPT or AMD-V/RVI is off

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.
Nagios Core Services Platform (CSP) Installation Guide

i. Click the Processors

ii. Under Virtualization Engine, ensure the box next to Virtualize Intel VT-x/EPT or
AMD-V/RVI is unchecked
e. Start the machine
i. You can either click the green play button at the top or select the ‘Start up this
guest operating system’ option.

Important Note on Virtual Image Management

Please be aware that the virtual images provided are designed for initial deployment only. We do not provide ongoing
management for the operating system within these images. Users should treat and maintain these virtual instances as
they would any other Linux distribution, taking responsibility for updates, security patches, and system management.
Additionally, regarding platform compatibility, while we strive to support a wide range of environments, compatibility may
vary based on the specific platform used. Successfully installing the software on a platform does not guarantee full
functionality or support. For the best experience, we recommend using the software on platforms specified within our
official support guidelines.

Installing on Windows

Installing the .iso

1. Downloading the .iso

Go to nagios.org downloads page and scroll down to locate the .iso file available for download.

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.
Nagios Core Services Platform (CSP) Installation Guide

2. Mounting the .iso file

1. Once installed, right click on the file and then click on the option to ‘Mount”.

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.
Nagios Core Services Platform (CSP) Installation Guide

2. A security warning window will pop up, click on ‘Open’. The contents of the mounted image will
now be accessible.

3. While mounted, the contents of the file can be accessed from the left-hand tray from the DVD
Drive.

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.
Nagios Core Services Platform (CSP) Installation Guide

3. Importing the .ova with VMware

1. Double-click on the Open Virtualization Appliance file to import the appliance into any installed
hypervisor or virtualization platform that supports .ova file format.

2. Name the VM and assign its storage path.

3. Click ‘Import’, and the appliance will begin to do so.

4. Click the green play button, and the virtual machine will begin to power on. Finished!

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.
Nagios Core Services Platform (CSP) Installation Guide

Installing the .zip

1. Downloading the .zip

Head over to nagios.org downloads page and locate the .iso file available for download.

2. Extract the Contents of the .ZIP Folder

1. Right click on the .zip folder to reveal options and click on ‘Extract All…’ select a destination to
extract the files to and click ‘Extract’

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.
Nagios Core Services Platform (CSP) Installation Guide

2. Once extraction is complete, the folder will no longer be a compressed .zip folder and rather a
regular file folder with its contents accessible

3. Click on the folder to reveal the contents:

3. Importing the .ova with VMware

Please refer back to the previous steps for importing the .ova with the .iso file as they are the same
for the .zip.

Installing on macOS
For macOS users, you can easily run the OVA by using virtualization software such as VMware
Fusion, Parallels, or a similar tool. Follow these steps:
1. Copy the OVA file to your local hard drive.
2. Use your preferred virtualization software (e.g., VMware Fusion or Parallels) to import and run
the OVA.

Finishing Up
This completes the documentation on Nagios CSP Installation Guide. For additional resources,
forums, and help, please visit the Nagios Community. If you encounter any issues or need further
assistance, our community experts are available to help!

Unlock the full potential of your Nagios CSP installation!

Remember to use CSP50 during licensing to activate your free 50-node Nagios XI license.

www.nagios.com

Copyright © 2024 Nagios Enterprises, LLC. All rights reserved. Trademarks are the property of their respective owner.