From e4455f902af668b15ccb6b4f7d0cf9c726c0dc5c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Ole=C5=9B?= <loles@mirantis.com>
Date: Thu, 11 Feb 2016 10:28:54 +0100
Subject: [PATCH] Add information about libvirt provider

Change-Id: I34b1632a78b38e05a32a56369ed422e1ea346fc0
Closes-bug: 1544280
---
 doc/source/development.rst | 34 ++++++++++++++++++++++++++++++++++
 doc/source/faq.rst         |  2 ++
 2 files changed, 36 insertions(+)

diff --git a/doc/source/development.rst b/doc/source/development.rst
index 9c4c2316..6f5b22e7 100644
--- a/doc/source/development.rst
+++ b/doc/source/development.rst
@@ -10,6 +10,7 @@ Additional software
 ~~~~~~~~~~~~~~~~~~~
 
 `VirtualBox <https://www.virtualbox.org/wiki/Downloads/>`_ 5.x,
+or `Libvirt <https://libvirt.org/>`_
 `Vagrant <http://www.vagrantup.com/downloads.html/>`_ 1.7.4 or higher
 
 Note: Make sure that `Vagrant VirtualBox Guest plugin
@@ -95,6 +96,39 @@ Image based provisioning with Solar
 
 To develop Solar we use Vagrant
 
+Using Libvirt instead of Virtualbox
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Virtualbox is a default provider for Vagrant, but it's also possible to use
+another providers. It should be possible to use any of Vagrant providers. As
+for today we support Libvirt provider. It can be used only on Linux systems.
+
+To use Libvirt with vagrant just run:
+
+.. code-block:: bash
+
+  vagrant up --provider libvirt
+
+This will download libvirt image for vagrant.
+
+In nodes definition we have hardcoded ssh keys paths, where we assume that
+Virtualbox is used. You need to copy keys to vagrant libvirt dir:
+
+.. code-block:: bash
+
+  cp /vagrant/.vagrant/machines/solar-dev1/libvirt/private_key /vagrant/.vagrant/machines/solar-dev1/virtualbox/private_key
+
+Or you can change path in node transport as described in
+:ref:`FAQ <faq_different_ssh_keys>`.
+
+do it for each solar-dev* machine.
+
+.. note::
+
+  Libvirt by default is using KVM. You cannot run KVM and Virtualbox
+  at the same time.
+
+
 Contribution
 ------------
 
diff --git a/doc/source/faq.rst b/doc/source/faq.rst
index 792e8c60..6d303ab1 100644
--- a/doc/source/faq.rst
+++ b/doc/source/faq.rst
@@ -12,6 +12,8 @@ Why nodes/transports have hardcoded keys, ips and other inputs ?
 
 This is temporary situation, we will improve it in near future.
 
+.. _faq_different_ssh_keys:
+
 I want to use different SSH keys
 ----------------------------