This project defines a
Vagrantfile to set up a
Virtualbox virtual machine with all required dependencies to successfully build the latest OpenNMS
This should enable developers to easily get started without the hassle to worry about setting the environment up. It can also serve as a starting point if you want to setup a local development environment.
The following programs must be installed on your system.
Git The latest version of git must be installed.
Virtualbox The latest version of Virtualbox must be installed.
Vagrant The latest version of Vagrant must be installed.
Vagrant plugin vagrant-vbguest The plugin vagrant-vbguest must be installed.
Ports 8980, 8101 and 8001 must be available on your host machine. Please make sure no process is occupying these ports.
To verify if your system fulfills the requirements, the following commands should complete successful from your command line
git version vagrant version VBoxManage -version
vagrant plugin list should contain
Create a working directory
mkdir -p ~/dev
Check out this repository locally
git clone https://github.com/opennms-forge/vagrant-opennms-dev.git ~/dev/vagrant-opennms-dev
Check out the latest opennms code locally
git clone https://github.com/opennms/opennms.git ~/dev/opennms
Vagrantfileand define OpenNMS repository directory to mount
Spin up the virtual machine
cd ~/dev/vagrant-opennms-dev vagrant up
Verify that everything worked
In case you are asked for a username or password.
The default user is
vagrant ssh cd ~/dev/opennms time (./clean.pl && ./compile.pl -DskipTests && ./assemble.pl -DskipTests -p dir)
If the build was successfully, we have to setup OpenNMS
cd ~/dev/opennms/target/opennms-VERSION/ ./bin/runjava -s && sudo ./bin/install -dis
9, Start OpenNMS
cd ~/dev/opennms/target/opennms-VERSION/ sudo ./bin/opennms start # normal mode sudo ./bin/opennms start -t # debug mode