From ec5aab41b280d719c14e1c5d88d09e7b38168bb3 Mon Sep 17 00:00:00 2001 From: Bruce Ashfield Date: Sun, 25 Aug 2013 23:47:42 -0400 Subject: docs: clarify docs names and roles Signed-off-by: Bruce Ashfield --- meta-openstack/DOC | 99 ------------------------------------------------------ 1 file changed, 99 deletions(-) delete mode 100644 meta-openstack/DOC (limited to 'meta-openstack/DOC') diff --git a/meta-openstack/DOC b/meta-openstack/DOC deleted file mode 100644 index 160e67a..0000000 --- a/meta-openstack/DOC +++ /dev/null @@ -1,99 +0,0 @@ -Meta-OpenStack -============== - -Description ------------ -The meta-openstack layer provides support for building the OpenStack packages. -It contains recipes for the nova, glance, keystone, cinder, quantum, swift and -horizon components and their dependencies. - -Components ----------- -* All the openstack packages are python packages. They can be found in the -recipes-devtools/python folder. Each component has been split into multiple -packages similar to the system used by other Linux distributions. - -* The configuration files for each package can be found in the files folder -for each package. The debug and verbose options have been enabled for capturing -meaningful information in the logs. The packages have been configured -following the model used by devstack. Each package has to initialize a database -before it is used for the first time. This is done using a postinstall script -that is run the first time the image is booted. This is why the image boot -time is longer the first time. - -* System-V initscripts are also provided in order to start the services at boot time. - -* We used postgresql (package) for the database backend. The layer contains -an initscript that starts the DB server at boot time. Tests were done -using sqlite3 and MySQL and there were no errors. - -* The RabbitMQ server is used for the AMQP message queues. The server starts -at boot time with the default configuration. - -* The layer also contains three packagegroups: -** packagegroup-cloud-controller - required packages for building a controller -node. This provides all functionality except the actual hosting of the virtual -machines or network services. This includes the database server, AMQP server -and all the openstack services except nova-compute. -** packagegroup-cloud-compute - packages for a processing node. This node runs -the compute service as well as the network service agent (in our case, the -Open vSwitch plugin agent). This server also manages the KVM hypervisor. -** packagegroup-cloud-network: this provides networking services like DHCP, -layer 2 switching, layer 3 routing and metadata connectivity. - -* When creating an image, multiple packagegroups can be used to obtain a target -that has the functionality of both a controller and compute node. - -Dependencies ------------- -* This layers 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. - -Building an image ------------------ - -* There are three new target images: openstack-image-compute, -openstack-image-network and openstack-image-controller that contain the -packagegroups with the same name, that have been described in the previous -section. - -* Once a buildir has been initialized you have to append the necessary layers -to the bblayers.conf file: - /meta-virtualization \ - /meta-cloud/meta-openstack \ - /meta-openembedded/meta-oe \ - /meta-openembedded/meta-networking \ - -Package configurations ----------------------- -The identity.sh script creates the necessary users, services and endpoints -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. - -Running an image ----------------- -* 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. - -The dashboard component is listening for new connections on port 8080. You can -connect to it using any browser. - -* 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: - /etc/nova/nova.conf: sql_connection; rabbit_host; - /etc/nova/api-paste.ini: auth_host; - /root/.bashrc: SERVICE_ENDPOINT, OS_AUTH_URL; -Once the changes are done you have to restart the nova-compute service. -!! 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. -- cgit v1.2.3-54-g00ecf