# Create C++ dev environment on CentOS using VirtualBox and Vagrant

## Prerequisites
* [Install VirtualBox](https://www.virtualbox.org/wiki/Downloads)
* [Install Vagrant](https://www.vagrantup.com/downloads.html)

## Create dev environment

1. Change working directory to <vespa-source>/vagrant
    cd <vespa-source>/vagrant

1. Install Vagrant VirtualBox Guest Additions plugin
This is required for mounting shared folders and get mouse pointer integration and seamless windows in the virtual CentOS desktop.

    vagrant plugin install vagrant-vbguest

1. Start and provision the environment
    vagrant up

1. Connect to machine via SSH
SSH agent forwarding is enabled to ensure easy interaction with GitHub inside the machine.

    vagrant ssh

1. Checkout vespa source inside virtual machine
This is needed in order to compile and run tests fast on the local file system inside the virtual machine.

    git clone git@github.com:vespa-engine/vespa.git


## Build C++ modules
Please follow the build instructions described [here](../README.md#build-c-modules).
Skip these steps if doing development with CLion.


## Build and Develop using CLion
CLion is installed as part of the environment and is recommended for C++ development.

1. Bootstrap C++ building
Go to <vespa-source> directory and execute:

    ./bootstrap-cpp.sh . .

1. Start CLion
Open a terminal inside the virtual CentOS desktop and run:

    clion

1. Open the Vespa Project
Go to *File* -> *Open* and choose <vespa-source>/CMakeLists.txt.

1. Set compiler threads
Go to *File* -> *Settings* -> *Build, Execution, Deployment* -> *CMake*.
Under *Build Options* specify "-j 4" and click *Apply*.

1. Build all modules
Choose target **all_modules** from the set of build targets and click build.