Nagios Core Services Platform (CSP) Installation Guide

Nagios CSP installation guide

This document is intended to outline the steps required to download and install the Nagios Core
services Platform on its compatible Linux distributions and 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).

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 (page 2)
• Windows (page 5)
• macOS (Page 9)

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

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

Install Nagios CSP on Linux

This guide will detail how to obtain the Nagios CSP .iso or .zip file in supported Linux distributions,
using wget. Execute the following command in your terminal session:

wget https://assets.nagios.com/downloads/csp/CSP-latest.iso

wget https://assets.nagios.com/downloads/csp/CSP-latest.zip

Installing the .iso

1. Create a Mount Directory
First, create a directory where the ISO file will be mounted. This is just a location in the filesystem
where you will "view" the contents of the ISO.

sudo mkdir /mnt/iso

2. Mount the ISO

Assuming you have the ISO file in a certain path (e.g., /path/to/file.iso), you can use the mount
command to attach it to the /mnt/iso directory.

sudo mount -o loop /path/to/file.iso /mnt/iso

-o loop tells the system to treat the ISO file like a block device, which is necessary for mounting.

Replace /path/to/file.iso with the actual path to your ISO file.

3. Access the Mounted ISO

After the ISO is mounted, you can navigate to the mount point and access the files:

cd /mnt/iso
ll

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

Just like with an ISO, you'll want to extract the contents of the .zip file into a directory.

sudo mkdir /mnt/zipfile

1. Install the unzip Utility (if not already installed)

If you don't have the unzip utility installed, you can install it with the following command:

sudo dnf install unzip

2. Extract the ZIP File

Now, use the unzip command to extract the contents of the .zip file into your newly created directory:

sudo unzip /path/to/file.zip -d /mnt/zipfile

•/path/to/file.zip: Replace this with the path to your .zip file.

•/mnt/zipfile: This is the directory where the files will be extracted. You can change this to any
desired location.

3. Access the Extracted Files

Once the .zip file is extracted, you can navigate to the directory to view the contents:

cd /mnt/zipfile
ls

Additional Notes:
• Unlike .iso files, .zip files need to be extracted and are not mounted as filesystems.
• You can extract .zip files to any directory of your choice.
• If the .zip file is password-protected, you will be prompted to enter the password during
extraction.

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

Importing the .ova through VMware Workstation on Linux

1. Download and Install VMware Workstation
1. Visit the VMware Workstation Pro download page and select the latest Linux
version. You can obtain VMware Workstation Pro 17 free for personal use by
following this link. If you need help with downloading and installing VMware
Workstation, this link will be able to assist you with the process.
2. Install
• Open a terminal and navigate to your download directory.
• Run these two commands to make the .bundle file executable, and then
execute the installer:

sudo chmod +x VMware-Workstation-Full-*.bundle

sudo ./VMware-Workstation-Full-*.bundle

2. Launch VMware Workstation

1. Open VMware Workstation from your application menu or run the command:
‘vmware &’ in the terminal.
3. Import the .ova File
1. In the top left-hand corner, go to File > Open… then navigate to the folder in which
you extracted the .ova to and select it.
2. Click the green ‘Open’ button in the top right to import the .ova file.
3. Assign a name, and a storage location to the machine.
4. A progress bar will appear.
4. Power On the Machine
1. Before powering on the machine, navigate to the virtual machine’s settings.
2. In the hardware tab, click on ‘Processors’.
3. Make sure under Virtualization Engine that the ‘Virtualize Intel VT-x/EPT or AMD-
V/RVI’ option is selected and hit ‘Save’.
4. 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 manageme nt for
the operating system within these images. Users should treat and maintain these virtual instances as they would any other Li nux
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 va ry 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.

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 on Windows

1. Downloading the .iso

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

2. Mounting the .iso file

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

A security warning window will pop up,

click on ‘Open’. The contents of the mounted
image will now be accessible

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

While mounted, the contents of the file can

be accessed from the left-hand tray from the
DVD Drive.

3. Importing the .ova with VMware

Double-click on the Open

Virtualization Appliance file to import the
appliance into any installed hypervisor or
virtualization platform that supports .ova
file format.

Name the VM and assign its storage path.

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

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

Click the green play button, and

the virtual machine will begin to
power on. Finished!

Downloading the .zip

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

Extract the Contents of

the .ZIP Folder
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

A progress bar will appear:

Once extraction is complete, the

folder will no longer be a compressed
.zip folder and rather a regular file
folder with its contents accessible.

Click on the folder to reveal the contents:

3. Import the .ova

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

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 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. Use your preferred virtualization software (e.g., VMware Fusion or Parallels) to import and run
the OVA.
2. For additional support and detailed instructions, please visit the Nagios Community for
resources, forums, and help.
If you encounter any issues or need further assistance, our community experts are available to
help!

www.nagios.com

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