diff --git a/doc/source/development/automated.rst b/doc/source/development/automated.rst index ac2136062..c090fe77a 100644 --- a/doc/source/development/automated.rst +++ b/doc/source/development/automated.rst @@ -57,6 +57,21 @@ environment. If using Vagrant, follow the steps in :ref:`development-vagrant` to prepare your environment for use with Vagrant and bring up a Vagrant VM. +If not using Vagrant, the default development configuration expects the +presence of a bridge interface on the OpenStack controller host to carry +control plane traffic. The bridge should be named ``breth1`` with a single +port ``eth1``, and an IP address of ``192.168.33.3/24``. This can be modified +by editing +``config/src/kayobe-config/etc/kayobe/inventory/group_vars/controllers/network-interfaces``. +Alternatively, this can be added using the following commands:: + + sudo ip l add breth1 type bridge + sudo ip l set breth1 up + sudo ip a add 192.168.33.3/24 dev breth1 + sudo ip l add eth1 type dummy + sudo ip l set eth1 up + sudo ip l set eth1 master breth1 + Usage ----- @@ -65,6 +80,11 @@ If using Vagrant, SSH into the Vagrant VM and change to the shared directory:: vagrant ssh cd /vagrant +If not using Vagrant, run the ``dev/install.sh`` script to install kayobe and +its dependencies in a virtual environment:: + + ./dev/install.sh + Run the ``dev/overcloud-deploy.sh`` script to deploy the OpenStack control plane:: @@ -104,6 +124,11 @@ environment. Usage ----- +Run the ``dev/install.sh`` script to install kayobe and its dependencies in a +virtual environment:: + + ./dev/install.sh + Run the ``dev/seed-hypervisor-deploy.sh`` script to deploy the seed hypervisor:: @@ -142,6 +167,11 @@ environment. Usage ===== +Run the ``dev/install.sh`` script to install kayobe and its dependencies in a +virtual environment:: + + ./dev/install.sh + Run the ``dev/seed-deploy.sh`` script to deploy the seed VM:: ./dev/seed-deploy.sh