Home > admin > install > Installing OneOps with Vagrant

Installing OneOps with Vagrant

Introduction

OneOps installation with Vagrant is a convenient, automated process. Vagrant can be used to install OneOps on a variety of virtual machine runtime environments. The following instructions detail the process for an installation with VirtualBox on your local machine.

Prerequisites

  • VirtualBox 5 or newer
  • Vagrant 1.7.4 or newer
  • Git
  • Modern operating system as required for VirtualBox and Vagrant
  • Minimum of 12Gb memory, 16Gb or more recommended
  • Minimum of 40Gb disk storage
  • Minimum of 4 CPU cores, 8 core or more recommended
  • Internet connection that allows access to GitHub and a number of repositories

Installation Process

After you have installed the prerequisites, you can proceed with the installation process:

Clone the OneOps setup repository from GitHub:

git clone https://github.com/oneops/setup

or

git clone git@github.com:oneops/setup.git

Alternatively you can download the repository as a zip file from the repository on GitHub and extract it.

Start the installation process with vagrant

cd setup/vagrant-centos7
vagrant up

The setup process takes at least 20 minutes and preforms numerous steps including:

  • Install all required components.
  • Set up minimal data set.
  • Bootstrap circuits from circuit-oneops

A successful installation ends with a message similar to

==> default: OneOps installation completed."
==> default: The user interface is ...."
==> default: All done at : 15:28:54

At this stage the OneOps web application is up and running on the VM with the web apllication available on port 3000. It is mapped to port 9090 on the host machine.

Go to http://localhost:9090 to access the user interface and start by signing up for an account.

Next Steps

Managing the OneOps VM

Vagrant can be used to manage the OneOps VM after the installation with executing commands in the setup/vagrant-centos7 directory.

Suspend the VM

vagrant suspend

and subsequently start it again with

vagrant resume

Alternatively you can use halt and up for a clean shutdown:

vagrant halt

and later a reboot:

vagrant up

In order to inspect the VM content itself, you can connect via SSH with vagrant. The following example connects and then checks the status of the inductor component of OneOps.

vagrant ssh
sudo su
cd /opt/oneops/inductor
inductor status
inductor tail

Find further information about the vagrant command with vagrant help as well as in the Vagrant documentation.

Demo

The video below showcases a quick installation and initial configuration of OneOps: