Installation

To install a devstack, we require a Desktop/Laptop/VM with below requirements,

Requirements

Recommended Hardware

 8GB RAM
 2 Core Processors
 1 Ethernet (Virtual Ethernet in case of VM)
 Internet access

Recommended OS

 Ubuntu 14.04 or Ubuntu 16.04

Devstack can be installed on other Linux flavors also, such as CentOS. But Ubuntu has a native
support. Hence I prefer Ubuntu. Also I prefer to install it in a VM, as we have many advantages
in it.

Note : I am using a VM(8GB Ram) and Ubuntu 14.04 OS to install devstack. Throughout the
book, all the examples, exercise,screenshot are executed/captured in the VM.

Decide on Openstack release

Openstack has many releases(icehouse,kilo,juno,liberty,mitaka,newton,ocata), and new release is

happening every year. The preferred release for installation is the latest stable one. The latest
stable release is OCATA.

Keystone,Glance,Nova,Neutron are minimum projects required to run devstack. Other projects

include cinder,swift,heat,etc can be added.

If you like to install older eol version(ex: Mitaka), you have to specifiy the branch details in the
local.conf file.

Installation Procedure

Note : Devstack can not be installed with root user. So the following steps needs to be done with
normal user with sudo access.

Update the Ubuntu Packages

Once your Ubuntu 14.04 OS is ready, Make sure you update it as below.
 sudo apt-get update
sudo apt-get upgrade
sudo apt-get install git

Download the devstack

In your home folder, Clone the devstack from the openstack git repository and change it to the
ocata release

cd
git clone https://github.com/openstack-dev/devstack
cd devstack
git checkout stable/ocata

create local.conf file

create a local.conf file in your devstack folder with below contents

For Ocata openstack Release:

[[local|localrc]]
RECLONE=True
HOST_IP=10.0.1.6
SERVICE_TOKEN=mytoken123
ADMIN_PASSWORD=openstack123
MYSQL_PASSWORD=mysql123
RABBIT_PASSWORD=rabbit123
SERVICE_PASSWORD=$ADMIN_PASSWORD
LOGFILE=$DEST/logs/stack.sh.log
LOGDAYS=2
enable_plugin neutron-lbaas https://github.com/openstack/neutron-lbaas.git
stable/ocata
disable_service n-net c-api c-sch c-vol
enable_service q-svc q-agt q-dhcp q-l3 q-meta q-lbaasv2

Note:

local.conf file is a configuration file for devstack installation. All passwords, openstack services
details, openstack services configuration, are configured here. Devstack uses this configuration
file for installing and configuring the openstack components.

we are configuring the passwords as below,

```
SERVICE_TOKEN=mytoken123
ADMIN_PASSWORD=openstack123
MYSQL_PASSWORD=mysql123
RABBIT_PASSWORD=rabbit123
SERVICE_PASSWORD=$ADMIN_PASSWORD```
And, we are enabling neutron networking instead of nova networking(old) using the below
commands.

```
disable_service n-net
enable_service q-svc q-agt q-dhcp q-l3 q-meta ```

Specify the system IP in HOST_IP=10.0.1.6 field.

Also, disabled the cinder services, as i dont require. if you need, you can enable that.

Starts the installation

cd
cd devstack
./stack.sh

Thats all. Installation may take 1 Hour+ to complete it. On Successful installation, you will see
this message.

=======================
DevStack Components Timed
========================

run_process - 57 secs
test_with_retry - 2 secs
apt-get-update - 3 secs
pip_install - 277 secs
restart_apache_server - 10 secs
wait_for_service - 10 secs
git_timed - 156 secs
apt-get - 70 secs

This is your host IP address: 10.10.10.5

This is your host IPv6 address: ::1
Horizon is now available at http://10.10.10.5/dashboard
Keystone is serving at http://10.10.10.5:5000/
The default users are: admin and demo
The password: openstack123

The installation log file is located in /opt/stack/log/stack.sh.log

Devstack downloads the required repositories from git in the /opt/stack folder.

cloud@devstack1:/opt/stack$ pwd
/opt/stack
cloud@devstack1:/opt/stack$ ls -lrt
total 52
drwxr-xr-x 13 cloud cloud 4096 Jul 30 14:32 keystone
drwxr-xr-x 10 cloud cloud 4096 Jul 30 14:34 glance
drwxr-xr-x 10 cloud cloud 4096 Jul 30 14:34 cinder
drwxr-xr-x 12 cloud cloud 4096 Jul 30 14:35 neutron
drwxr-xr-x 8 cloud cloud 4096 Jul 30 14:36 noVNC
drwxr-xr-x 13 cloud cloud 4096 Jul 30 14:37 nova
drwxr-xr-x 3 cloud cloud 4096 Jul 30 14:38 status
drwxr-xr-x 7 cloud cloud 4096 Jul 30 14:41 requirements
drwxr-xr-x 11 cloud cloud 4096 Jul 30 14:42 horizon
drwxr-xr-x 7 cloud root 4096 Jul 30 14:45 data
drwxr-xr-x 11 cloud cloud 4096 Jul 30 14:45 tempest
-rw-r--r-- 1 cloud cloud 44 Jul 30 14:45 devstack.subunit
drwxr-xr-x 2 cloud cloud 4096 Jul 31 05:40 logs
cloud@devstack1:/opt/stack$

Now let us explore the openstack components etc

Installing the older openstack versions:

Assume, i would like to install openstack Mitaka version, Mitaka is End of Life version. So In
Openstack Repositories(Neutron, nova etc),it is moved out from stable branch.

cd
git clone https://github.com/openstack-dev/devstack
cd devstack
git checkout mitaka-eol

Local.conf

[[local|localrc]]
RECLONE=True
SERVICE_TOKEN=mytoken123
ADMIN_PASSWORD=openstack123
MYSQL_PASSWORD=mysql123
RABBIT_PASSWORD=rabbit123
SERVICE_PASSWORD=$ADMIN_PASSWORD
LOGFILE=$DEST/logs/stack.sh.log
LOGDAYS=2
GLANCE_BRANCH=mitaka-eol
NOVA_BRANCH=mitaka-eol
NEUTRON_BRANCH=mitaka-eol
KEYSTONE_BRANCH=mitaka-eol
CINDER_BRANCH=mitaka-eol
HORIZON_BRANCH=mitaka-eol
REQUIREMENTS_BRANCH=mitaka-eol
disable_service n-net c-api c-sch c-vol tempest
enable_service q-svc q-agt q-dhcp q-l3 q-meta

Openstack Screens
devstack creates a screen named 'stack' with x windows. Each window represents the
process/logs of the openstack components
If you are not familiar with screen Screen is a full-screen window manager that multiplexes a
physical terminal between several processes, typically interactive shells.
Reference :

1. List the available screens

stack@sureshdev:~$ screen -ls

There is a screen on:

8146.stack (07/12/16 20:00:04) (Detached)
1 Socket in /var/run/screen/S-stack.

1. Attach with devstack screen

stack@sureshdev:~$ screen -x stack

You will see the below(similar) screen

Some Important Screen Shortcuts

 CTRL + A + " To list all screen windows and select the screen with UP/DOWN ARROW
 CTRL + A + n Move to next screen window
 CTRL + A + p Move to previous screen window
 CTRL + D Detach(exit) from screen
The below picture lists all screen windows (CTRL+A+" output)
  key,key-access are for keystone component, which displays the keystone log files
 g-reg,g-api are glance component windows. glance registry process runs on g-reg
window and glance api process runs on g-api window.
 n-api,n-cond,n-sch,n-novnc,n-cauth,n-cpu are nova component window. n-api window
run nova-api process, n-cond window runs nova-conductor process,n-sch window runs
with nova-scheduler,n-novnc runs with nova-vnc console process,n-cauth window runs
with nova auth module,n-cpu window runs with nova compute.
 q-svc,q-agt,q-dhcp,q-l3,q-meta are neutron compoents.
 c-api,c-vol,c-sch are cinder components
 horizon is horizon(webui) component.

Debugging the Failure installation

Devstack installation may fail, due to the following reasons.

 Failure related to third party software/services/dependent libraries

 openstack software error(untested patches),
 Wrong configuration and credentials in the openstack services etc.
 Dependent Services are not running/misconfigured(such as mysql,rabbitmq etc)
 Uncleaned Installation (Previous devstack was not cleaned properly)

The log file is present in /opt/stack/log/stack.log file. First we need to check the log file to
understand the reason for failure, and correct it.

Most of the times,simply restart the installation will work.

Restart the installation using below commands.

./unstack.sh
./stack.sh

You may get in to the situation, that you want to cleanly uninstall the devstack with no foot
prints.

cd
cd devstack
./unstack.sh
./clean.sh
cd .. && rm -rf devstack
rm -rf /opt/stack

How to use Use

we can use the openstack via Web UI(Horizon) or Openstack CLI.

By default demo project is created with "demo" user. The default admistrative username is
admin. we have specified the password in local.conf file. In my example, it is "openstack123".
Horizon

1. Access with UI http://

CLI

To access via openstack CLI, openrc script needs to be executed first with the project name and
username as a parameter.

source openrc
cd
cd devstack
source openrc admin admin

Now client is ready to use, execute some sample operations as below,

cloud@devstack1:~/devstack$ openstack server list

cloud@devstack1:~/devstack$ openstack image list

+--------------------------------------+---------------------------------
+--------+
| ID | Name |
Status |
+--------------------------------------+---------------------------------
+--------+
| 32d7cb58-aadc-4853-a888-2b56556c914e | cirros-0.3.4-x86_64-uec |
active |
| 7ca2ec87-ad98-4149-92d5-4c7bf02ea2b0 | cirros-0.3.4-x86_64-uec-ramdisk |
active |
| c8595f74-2318-454e-a012-99322bb5589d | cirros-0.3.4-x86_64-uec-kernel |
active |
+--------------------------------------+---------------------------------
+--------+
cloud@devstack1:~/devstack$ openstack flavor list
+----+-----------+-------+------+-----------+-------+-----------+
| ID | Name | RAM | Disk | Ephemeral | VCPUs | Is Public |
+----+-----------+-------+------+-----------+-------+-----------+
| 1 | m1.tiny | 512 | 1 | 0 | 1 | True |
| 2 | m1.small | 2048 | 20 | 0 | 1 | True |
| 3 | m1.medium | 4096 | 40 | 0 | 2 | True |
| 4 | m1.large | 8192 | 80 | 0 | 4 | True |
| 42 | m1.nano | 64 | 0 | 0 | 1 | True |
| 5 | m1.xlarge | 16384 | 160 | 0 | 8 | True |
| 84 | m1.micro | 128 | 0 | 0 | 1 | True |
+----+-----------+-------+------+-----------+-------+-----------+
cloud@devstack1:~/devstack$