From 1f4f541e923dbf987fbb81334053b234bcc0fda2 Mon Sep 17 00:00:00 2001 From: Tom Fifield Date: Fri, 11 Oct 2013 21:19:57 +1100 Subject: [PATCH] Fix install guide based on testing under ubuntu This patch fixes the install guide based on real testing under ubuntu Currently verified to the end of "Enabling KVM on the Compute node" Change-Id: I2832a5cbb66e3b6602f9b6f4f9b2ddbcc897cdcf --- doc/install-guide/section_nova-compute.xml | 56 ++++++++++++++----- doc/install-guide/section_nova-controller.xml | 36 ++++++++++-- doc/install-guide/section_nova-kvm.xml | 3 +- 3 files changed, 75 insertions(+), 20 deletions(-) diff --git a/doc/install-guide/section_nova-compute.xml b/doc/install-guide/section_nova-compute.xml index 713e431fa2..619bf449fc 100644 --- a/doc/install-guide/section_nova-compute.xml +++ b/doc/install-guide/section_nova-compute.xml @@ -21,8 +21,8 @@ controller node: - Use different IP addresses when editing the files ifcfg-eth0 - and ifcfg-eth1. This guide uses 192.168.0.11 for + Use different IP addresses when configuring eth0 + and eth1. This guide uses 192.168.0.11 for the internal network and 10.0.0.11 for the external network. @@ -31,7 +31,7 @@ /etc/hosts file on each system. - Do not run the NTP server. Follow the instructions in + Follow the instructions in to synchronize from the controller node. @@ -39,8 +39,8 @@ server or start the MySQL service. - You do not need to install a messaging queue server. - + + After configuring the operating system, install the appropriate packages for the compute service. # apt-get install nova-compute-kvm @@ -49,24 +49,55 @@ Either copy the file /etc/nova/nova.conf from the controller node, or run the same configuration commands. - # openstack-config --set /etc/nova/nova.conf \ + # openstack-config --set /etc/nova/nova.conf \ database connection mysql://nova:NOVA_DBPASS@controller/nova # openstack-config --set /etc/nova/nova.conf DEFAULT auth_strategy keystone # openstack-config --set /etc/nova/nova.conf DEFAULT auth_host controller # openstack-config --set /etc/nova/nova.conf DEFAULT admin_user nova # openstack-config --set /etc/nova/nova.conf DEFAULT admin_tenant_name service # openstack-config --set /etc/nova/nova.conf DEFAULT admin_password NOVA_PASS - + Edit /etc/nova/nova.conf and add to the [DEFAULT] section. + +... +[DEFAULT] +... +auth_strategy=keystone +auth_host=controller +admin_user=nova +admin_tenant_name=service +admin_password=NOVA_PASS + + # openstack-config --set /etc/nova/nova.conf \ DEFAULT rpc_backend nova.openstack.common.rpc.impl_qpid -# openstack-config --set /etc/nova/nova.conf DEFAULT qpid_hostname controller +# openstack-config --set /etc/nova/nova.conf DEFAULT qpid_hostname controller + + + Configure the Compute Service to use the RabbitMQ + message broker by setting the following configuration keys. They are found in + the DEFAULT configuration group of the + /etc/nova/nova.conf file. + rpc_backend = nova.rpc.impl_kombu +rabbit_host = controller + + Set the configuration keys my_ip, vncserver_listen, and vncserver_proxyclient_address to the IP address of the compute node on the internal network. - # openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.11 + # openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.11 # openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_listen 192.168.0.11 -# openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 192.168.0.11 +# openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 192.168.0.11 + Edit /etc/nova/nova.conf and add to the [DEFAULT] section. + +[DEFAULT] +... +my_ip=192.168.0.11 +vncserver_listen=192.168.0.11 +vncserver_proxyclient_address=192.168.0.11 + + + Copy the file /etc/nova/api-paste.ini from the controller node, or edit the file to add the credentials in the [filter:authtoken] section. @@ -77,12 +108,11 @@ admin_user=nova admin_tenant_name=service admin_password=NOVA_PASS - Ensure that api_paste_config=/etc/nova/api-paste.ini is set in + Ensure that api_paste_config=/etc/nova/api-paste.ini is set in /etc/nova/nova.conf. Start the Compute service and configure it to start when the system boots. - # service nova-compute start -# chkconfig nova-compute on + # service nova-compute start # service openstack-nova-compute start # chkconfig openstack-nova-compute on # systemctl start openstack-nova-compute diff --git a/doc/install-guide/section_nova-controller.xml b/doc/install-guide/section_nova-controller.xml index bd10f582ab..74a35ddab3 100644 --- a/doc/install-guide/section_nova-controller.xml +++ b/doc/install-guide/section_nova-controller.xml @@ -73,9 +73,19 @@ IDENTIFIED BY 'NOVA_DBPASS'; vncserver_proxyclient_address to the IP address of the controller node. - # openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.10 + # openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.10 # openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_listen 192.168.0.10 # openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 192.168.0.10 + Edit /etc/nova/nova.conf and add to the [DEFAULT] section. + +... +[DEFAULT] +... +my_ip=192.168.0.10 +vncserver_listen=192.168.0.10 +vncserver_proxyclient_address=192.168.0.10 + + @@ -91,11 +101,25 @@ IDENTIFIED BY 'NOVA_DBPASS'; For the Compute Service to use these credentials, you must add them to the nova.conf configuration file. - # openstack-config --set /etc/nova/nova.conf DEFAULT auth_strategy keystone + # openstack-config --set /etc/nova/nova.conf DEFAULT auth_strategy keystone # openstack-config --set /etc/nova/nova.conf DEFAULT auth_host controller # openstack-config --set /etc/nova/nova.conf DEFAULT admin_user nova # openstack-config --set /etc/nova/nova.conf DEFAULT admin_tenant_name service # openstack-config --set /etc/nova/nova.conf DEFAULT admin_password NOVA_PASS + Edit /etc/nova/nova.conf and add to the [DEFAULT] section. + +... +[DEFAULT] +... +auth_strategy=keystone +auth_host=controller +admin_user=nova +admin_tenant_name=service +admin_password=NOVA_PASS + + + + @@ -111,7 +135,7 @@ admin_user=nova admin_tenant_name=service admin_password=NOVA_PASS - Ensure that api_paste_config=/etc/nova/api-paste.ini + Ensure that api_paste_config=/etc/nova/api-paste.ini is set in /etc/nova/nova.conf. @@ -128,9 +152,9 @@ admin_password=NOVA_PASS creating the endpoint. # keystone endpoint-create \ --service-id=the_service_id_above \ - --publicurl=http://controller:8774/v2/%(tenant_id)s \ - --internalurl=http://controller:8774/v2/%(tenant_id)s \ - --adminurl=http://controller:8774/v2/%(tenant_id)s + --publicurl=http://controller:8774/v2/%\(tenant_id\)s \ + --internalurl=http://controller:8774/v2/%\(tenant_id\)s \ + --adminurl=http://controller:8774/v2/%\(tenant_id\)s diff --git a/doc/install-guide/section_nova-kvm.xml b/doc/install-guide/section_nova-kvm.xml index 1137af00a3..00e3c7c289 100644 --- a/doc/install-guide/section_nova-kvm.xml +++ b/doc/install-guide/section_nova-kvm.xml @@ -8,7 +8,8 @@ The OpenStack Compute Service requires hardware virtualization support and certain kernel modules. Follow this procedure to determine whether your system has hardware virtualization support and the correct kernel - modules available. + modules available. In many cases, this is installed for you by your + distribution and you do not need to perform any additional action. All steps listed must be performed while logged into the system as the