[ganeti/ganeti_webmgr] 4fda8aa Merge branch 'enhancement/15273' into develop (245 commits)

[g...@osuosl.org]

The branch, develop has been updated

Old revision: 52a1f46832d9b517fe4b55e39e3b7eea56fdbf68, new revision: 4fda8aa53f2bfce6c5801614e0b864c9c1df4fa3.
via 4fda8aa53f2bfce6c5801614e0b864c9c1df4fa3 (commit)
via 37f193250023dababfb529e90bf582608a31d9c7 (commit)
via d21239efd36feda8940c2cf7c49612b1d31c2522 (commit)
via 6ded666362346acc53e8c9b754b242b2e6ba079b (commit)
via bbe7199788fc4c15cf9985b72e3c98d67e40f1bf (commit)
via 7ce78c0d47bf2777f27bbca1e16e8e7472a86a40 (commit)
from 52a1f46832d9b517fe4b55e39e3b7eea56fdbf68 (commit)

- Log -----------------------------------------------------------------
commit 4fda8aa53f2bfce6c5801614e0b864c9c1df4fa3
Merge: 52a1f46 37f1932
Author: Chance Zibolski <chance....@gmail.com>
Date: Mon Dec 16 12:46:23 2013 -0800

Merge branch 'enhancement/15273' into develop

* enhancement/15273:
Docs (test_cluster): Fix spelling, and grammar.
Docs (test_cluster): Add information on updating
Docs: Emphasize node names
Docs: Update test_cluster usage
Docs: Add information on vagrant-ganeti test cluster

commit 37f193250023dababfb529e90bf582608a31d9c7
Author: Chance Zibolski <chance....@gmail.com>
Date: Tue Nov 12 11:09:03 2013 -0800

Docs (test_cluster): Fix spelling, and grammar.

commit d21239efd36feda8940c2cf7c49612b1d31c2522
Author: Chance Zibolski <chance....@gmail.com>
Date: Fri Nov 8 14:08:25 2013 -0800

Docs (test_cluster): Add information on updating

commit 6ded666362346acc53e8c9b754b242b2e6ba079b
Author: Chance Zibolski <chance....@gmail.com>
Date: Fri Nov 8 14:00:03 2013 -0800

Docs: Emphasize node names

commit bbe7199788fc4c15cf9985b72e3c98d67e40f1bf
Author: Chance Zibolski <chance....@gmail.com>
Date: Fri Nov 8 12:16:13 2013 -0800

Docs: Update test_cluster usage

commit 7ce78c0d47bf2777f27bbca1e16e8e7472a86a40
Author: Chance Zibolski <chance....@gmail.com>
Date: Thu Nov 7 18:12:55 2013 -0800

Docs: Add information on vagrant-ganeti test cluster

refs #15273


Summary of changes:
docs/source/dev/test_cluster.rst | 62 ++++++++++++++++++++++++++++++++++++++
docs/source/index.rst | 1 +
2 files changed, 63 insertions(+), 0 deletions(-)
create mode 100644 docs/source/dev/test_cluster.rst

diff --git a/docs/source/dev/test_cluster.rst b/docs/source/dev/test_cluster.rst
new file mode 100644
index 0000000..d95794a
--- /dev/null
+++ b/docs/source/dev/test_cluster.rst
@@ -0,0 +1,62 @@
+.. test_cluster:
+
+Vagrant Test Cluster
+====================
+
+For development we use Vagrant to set up a Ganeti Cluster to test on.
+
+Setup
+~~~~~
+
+The Vagrant Test cluster is not included with |gwm| and is a separate
+repository, that must be cloned::
+
+ git clone https://github.com/osuosl/vagrant-ganeti
+
+Once you've cloned the repository you can refer to its `README
+<https://github.com/osuosl/vagrant-ganeti>`_ for more details on how to use it.
+
+Updating
+~~~~~~~~
+
+If you already have the repository, you should also always make sure you are
+running the most up to date version of the code. There are two ways to do this::
+
+ git pull
+ git submodule update --init
+
+Or you can simply use the update script in the repo which does the previous
+two commands::
+
+ ./update
+
+Either way will work, but make sure that both the repository **and** the
+submodules are updated.
+
+Basic Usage
+~~~~~~~~~~~
+
+The vagrant-ganeti project comes with 3 Ganeti nodes which can be used for
+testing deployment of VMs. You typically only need **1 node** unless you are
+testing multi-node operations.
+
+- You can bring up the first node by typing ``vagrant up node1``.
+
+- The other nodes can be brought up the same way, just swap out ``node1`` with
+ ``node2`` or ``node3``.
+
+You can also bring up every node by using just ``vagrant up``, however if you
+do not have much RAM or you are already running memory intensive programs, this
+should be avoided.
+
+
+Using with |gwm|
+~~~~~~~~~~~~~~~~
+
+Once you have ``node1`` running, you can add it to |gwm| by using the `add
+cluster` button on the cluster page.
+
+The hostname field should be filled in with the IP Address for the given
+node, which can be found in the Vagrantfile. The *username* and *password* are
+both **vagrant**, which will let you communicate with the cluster.
+

diff --git a/docs/source/index.rst b/docs/source/index.rst
index cb19d10..8b3e66b 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -93,6 +93,7 @@ Development

dev/installation
dev/vagrant
+ dev/test_cluster
dev/schedule
dev/process
dev/issues