This chapter shows how to set up and use our Icinga Vagrant boxes that we’ve created for development, tests and demo cases.
- Vagrant >= version 1.5
- VirtualBox or Parallels Desktop
Note: The deployment of the virtual machine is tested against Vagrant starting with version 1.5. Unfortunately older versions will not work.
Parallels requires the additional provider plugin vagrant-paralells to be installed:
$ vagrant plugin install vagrant-parallels
The Icinga Web 2 project ships with a Vagrant virtual machine that integrates the source code with various services and example data in a controlled environment. This enables developers and users to test Livestatus, MySQL and PostgreSQL backends as well as the LDAP authentication. All you have to do is install Vagrant and run:
Note: The first boot of the vm takes a fairly long time because you’ll download a plain CentOS base box and Vagrant will automatically provision the environment on the first go.
After you should be able to browse localhost:8080/icingaweb2.
Log into Icinga Web 2¶
Both LDAP and a MySQL are configured as authentication backend. Please use one of the following login credentials:
Testing the Source Code¶
All software required to run tests is installed in the virtual machine. In order to run all tests you have to execute the following command:
vagrant ssh -c "icingacli test php unit"