diff --git a/doc/training-guides/basic-install-guide/lab_control-node.xml b/doc/training-guides/basic-install-guide/lab_control-node.xml index 36f90c2e..cc5ef005 100644 --- a/doc/training-guides/basic-install-guide/lab_control-node.xml +++ b/doc/training-guides/basic-install-guide/lab_control-node.xml @@ -3,8 +3,8 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="lab_control-node.xml"> - Control Node - Network Diagram : + Controller node + Network Diagram:
Network Diagram @@ -15,21 +15,19 @@
Publicly editable image source at https://docs.google.com/drawings/d/1GX3FXmkz3c_tUDpZXUVMpyIxicWuHs5fNsHvYNjwNNk/edit?usp=sharing + xlink:href="https://docs.google.com/drawings/d/1GX3FXmkz3c_tUDpZXUVMpyIxicWuHs5fNsHvYNjwNNk/edit?usp=sharing" + >https://docs.google.com/drawings/d/1GX3FXmkz3c_tUDpZXUVMpyIxicWuHs5fNsHvYNjwNNk/edit?usp=sharing Vboxnet0, Vboxnet1, Vboxnet2 - are virtual networks setup up by virtual box with your host machine. This is the way your host can communicate with the virtual machines. These networks are in turn - used by VirtualBox virtual machines for OpenStack networks, so + used by VirtualBox VMs for OpenStack networks, so that OpenStack’s services can communicate with each other. - When you reboot the controller node on the VirtualBox - virtual machine, you might lose Internet and network - connectivity. Restart the networking service and use the - ping command to check whether the network - interfaces can communicate over the given networks. + On reboot the node VM may lose internet and network connectivity. + Restart the networking service and use the ping + command to verify the network connectivity for the given VM. To avoid issues on the VirtualBox virtual machine @@ -38,48 +36,45 @@ shut down. - It is advised to take regular snapshots of the Virtual Box - Virtual Machines (controller node) after each section. This will - help you save your session and revert back to it in case you - break something while deploying OpenStack. + Take regular snapshots of the VirtualBox virtual machines after + each section. In case the VM is broken, you may revert back to the + snapshot to save time and effort. - controller node - Start your controller node the one you setup in the previous - section. - Preparing Ubuntu - 13.04/12.04 + Controller node + + Start the controller node which was set up in a previous section. + + Preparing Ubuntu 14.04 Networking : - Configure your network by editing + Configure your network by editing the /etc/network/interfaces file Open /etc/network/interfaces and edit the file as mentioned: -# This file describes the network interfaces available on your system -# and how to activate them. For more information, see interfaces(5). -# This file is configured for OpenStack Control Node by dguitarbite. -# Note: Selection of the IP addresses is important, changing them may break some of OpenStack Related services, -# As these IP addresses are essential for communication between them. +# This file is for the OpenStack controller node for OpenStack training project. +# Note: Selection of the IP addresses is important. +# Any changes to the IP addresses may break OpenStack related services. -# The loopback network interface - for Host-Onlyroot +# The loopback network interface auto lo iface lo inet loopback # The primary network interface - Virtual Box NAT connection -# (Virtual Box Network Adapter 3) +# (Virtual Box Network Adapter 1) auto eth0 iface eth0 inet dhcp -# Virtual Box vboxnet0 - OpenStack Management Network -# (Virtual Box Network Adapter 1) +# Virtual Box vboxnet0 - OpenStack management network +# (Virtual Box Network Adapter 2) auto eth1 iface eth1 inet static address 10.10.10.51 netmask 255.255.255.0 -# Virtual Box vboxnet2 - for exposing OpenStack API over external network -# (Virtual Box Network Adapter 2) +# VirtualBox vboxnet2 - OpenStack API network +# (Virtual Box Network Adapter 3) auto eth2 iface eth2 inet static address 192.168.100.51 @@ -93,20 +88,15 @@ netmask 255.255.255.0 # ifconfig - You should see the expected network interface cards with - the required IP Addresses. + Verify if the network interfaces have the given IP addresses as + configured above. - SSH from HOST + SSH from host - Create an SSH key pair for your Control Node. Follow the - same steps as you did in the begin of the article - for your host machine. - - - To SSH into the Control Node from the Host Machine, type - the below command. + To SSH into the controller node from the host machine, type + the following command. $ ssh control@10.10.10.51 $ sudo su @@ -118,7 +108,7 @@ netmask 255.255.255.0 #apt-get update -To use the Ubuntu Cloud Archive for Icehouse +Update Ubuntu Cloud Archive for Icehouse The Install the Ubuntu Cloud Archive for Icehouse - #apt-get install ubuntu-cloud-keyring software-properties-common python-software-properties + #apt-get install ubuntu-cloud-keyring software-properties-common \ + python-software-properties #add-apt-repository cloud-archive:icehouse @@ -187,12 +178,7 @@ netmask 255.255.255.0 mysql> quit; - Other - Keystone - Keystone is an OpenStack project that provides Identity, - Token, Catalog and Policy services for use specifically by - projects in the OpenStack family. It implements OpenStack’s - Identity API. + Installing Keystone Install the Keystone packages: