aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBruce Ashfield <bruce.ashfield@windriver.com>2013-10-03 00:13:26 -0400
committerBruce Ashfield <bruce.ashfield@windriver.com>2013-10-03 01:16:44 -0400
commit718ecf27999c69acae27992123d2a7fe85d64c77 (patch)
treef370758756b2d1ea4d3ebff5016ca0f8dce06f7c
parente993ac074388eba8ebc96afbe5ae0e3a702921e2 (diff)
downloadmeta-cloud-services-718ecf27999c69acae27992123d2a7fe85d64c77.tar.gz
meta-cloud-services-718ecf27999c69acae27992123d2a7fe85d64c77.tar.bz2
meta-cloud-services-718ecf27999c69acae27992123d2a7fe85d64c77.zip
meta-openstack: documentation updates
syncing the documentation to match the current layers, configuration and launch. Signed-off-by: Bruce Ashfield <bruce.ashfield@windriver.com>
-rw-r--r--README16
-rw-r--r--meta-openstack/README7
-rw-r--r--meta-openstack/README.setup79
3 files changed, 76 insertions, 26 deletions
diff --git a/README b/README
index ca10870..a4fe714 100644
--- a/README
+++ b/README
@@ -17,6 +17,22 @@ branch: master
revision: HEAD
prio: default
+
+Layers
+------
+
+openstack layers
+----------------
+
+There are four openstack layers that are used to build a controller/compute
+node image pair. The dependencies of these layers are also required for a
+build, and are listed in the layers themselves.
+
+ - meta-cloud-services/meta-openstack
+ - meta-cloud-services/meta-openstack-compute-deploy
+ - meta-cloud-services/meta-openstack-controller-deploy
+ - meta-cloud-services/meta-openstack-qemu
+
Maintenance
-----------
diff --git a/meta-openstack/README b/meta-openstack/README
index ffbea6e..cb32482 100644
--- a/meta-openstack/README
+++ b/meta-openstack/README
@@ -49,10 +49,9 @@ in tree for individual recipes is under the LICENSE stated in each recipe
Target images
-------------
-There are target images: openstack-image-compute, openstack-image-network,
-openstack-image-controller.
+Target images: openstack-image-compute, openstack-image-network, openstack-image-controller.
They contain the packagegroups with the same name and can be used to create
-the ypes of targets. There are no extra configurations required to build
-these images.
+the types of targets. There are no extra configurations required to build
+these images. See README.setup for more details.
diff --git a/meta-openstack/README.setup b/meta-openstack/README.setup
index 2b2aeb9..f786735 100644
--- a/meta-openstack/README.setup
+++ b/meta-openstack/README.setup
@@ -4,10 +4,13 @@ Meta-OpenStack
Description
-----------
-The meta-openstack layer provides support for building the OpenStack
+The meta-openstack layers provide support for building the OpenStack
packages. It contains recipes for the nova, glance, keystone, cinder,
quantum, swift and horizon components and their dependencies.
+The main meta-openstack layer, works in conjunction with the meta-openstack*
+layers to configure and deploy a system.
+
Components
----------
@@ -53,7 +56,7 @@ Components
Dependencies
------------
-* This layers depends on components from the poky, meta-virtualization and
+* This layer depends on components from the poky, meta-virtualization and
meta-openembedded layers. You can find the exact URIs of the repos and the
necessary revisions in the README file.
@@ -69,9 +72,12 @@ Building an image
to the bblayers.conf file:
/meta-virtualization \
- /meta-cloud/meta-openstack \
+ /meta-cloud-services/meta-openstack-<node type>-deploy \
+ /meta-cloud-services/meta-openstack \
+ /meta-cloud-services/meta-openstack-qemu \ # optional, add if using qemu
+ /meta-cloud-services/meta-openstack \
/meta-openembedded/meta-oe \
- /meta-openembedded/meta-networking \
+ /meta-openembedded/meta-networking \
Package configurations
----------------------
@@ -81,35 +87,64 @@ for the Keystone identity system. If you want to customize the usernames or
passwords don't forget to change the information in the configuration files
for the services as well.
+The hosts.bbclass contains the IP addresses of the compute and controller
+nodes that will seed the system. It also contains the IP address of the
+node being built "MY_IP". Override this class in a layer to provide values
+that are specific to your configuration. The defaults are suitable for a
+2 node system launched via runqemu.
+
+If deploying to a simulated system, add the qemu deployment layer to the
+bblayers.conf file, after the node type deployment layer.
+
+* Sample Guest Image *
+
+If a sample guest image is desired on a control node, the following can
+be added to local.conf:
+
+ IMAGE_INSTALL_append = " cirros-guest-image"
+
Running an image
----------------
+To test the images, you can run them using the runqemu script (on a machine
+with appropriate accleration).
+
+In order to use the command line clients (nova, keystone, glance etc) some
+environmental variables have to be set. These are required by the openstack
+services to connect to the identity service and authenticate the user. These
+can be found in /root/.bashrc or /etc/nova/openrc.
+
* Controller node *
-To test the image, you can run it using the runqemu script. In order to use
-the command line clients (nova, keystone, glance etc) some environmental
-variables have to be set. These are required by the openstack services to
-connect to the identity service and authenticate the user. These can be found
-in /root/.bashrc. If you start a new bash session they are automatically
-loaded. All the installed OpenStack services nova(except compute), keystone,
-glance, cinder, quantum, swift horizon should be running after a successful
-boot.
+All the installed OpenStack services nova(except compute), keystone, glance,
+cinder, quantum, swift horizon should be running after a successful boot.
+
+ % bitbake openstack-image-controller
+ % runqemu qemux86-64 openstack-image-controller kvm nographic qemuparams="-m 4096"
The dashboard component is listening for new connections on port 8080. You can
connect to it using any browser.
-* Compute node *
+* Compute Node *
-The configuration files for the nova package are for a controller node so some
-options have to be changed for the compute service to properly work. You have
-to replace localhost to the controller node IP in the following files:
+All the installed OpenStack compute services nova, quantum, should be running
+after a successful boot.
- /etc/nova/nova.conf: sql_connection; rabbit_host;
- /etc/nova/api-paste.ini: auth_host;
- /root/.bashrc: SERVICE_ENDPOINT, OS_AUTH_URL;
+ % bitbake openstack-image-compute
+ % runqemu qemux86-64 openstack-image-compute kvm nographic qemuparams="-m 4096"
-Once the changes are done you have to restart the nova-compute service.
+* Image Launch *
+
+Assuing that the cirros-guest-image has been added to the control image, the
+following steps will validate a simple compute node guest launch:
+
+ % . /etc/nova/openrc
+ % glance image-create --name myFirstImage --is-public true \
+ --container-format bare --disk-format qcow2 --file images/cirros-0.3.0-x86_64-disk.img
+ % quantum net-create mynetwork
+ % nova boot --image myFirstImage --flavor 1 myinstance
!! Hint !!
-When using a multi-node setup it is recommended that each host have a different
-hostname and that every host knows the other hosts.
+
+ When using a multi-node setup it is recommended that each host have a different
+ hostname and that every host knows the other hosts.