How to Install OpenStack on Ubuntu 18.04 with DevStack

Openstack is a free and opensource IaaS cloud platform that handles cloud compute, storage and network resources. It comes with an intuitive dashboard that enables systems administrators to provide and monitor these resources.

You can seamlessly install OpenStack locally on your Ubuntu 18.04 instance for learning and testing purposes using Devstack.

Devstack is a set of extensible scripts that facilitate OpenStack deployment. In this guide, you will learn how to deploy OpenStack on Ubuntu 18.04 with devstack.

Table of Contents

1 Minimum Requirements
2 Step 1: Update and Upgrade the System
3 Step 2: Create Stack user and assign sudo priviledge
4 Step 3: Install git and download DevStack
5 Step 4: Create devstack configuration file
6 Step 5: Install OpenStack with Devstack
7 Step 6: Accessing OpenStack on a web browser

Minimum Requirements

Before we begin, ensure you have the following minimum prerequisites

A fresh Ubuntu 18.04 installation
User with sudo privileges
4 GB RAM
2 vCPUs
Hard disk capacity of 10 GB
Internet connection

With the minimum requirements satisfied, we can now proceed.

Step 1: Update and Upgrade the System

To start off, log into your Ubuntu 18.04 system using SSH protocol and update & upgrade system repositories using the following command.

apt update -y && apt upgrade -y

Sample Output

Update And Upgrade Ubuntu 18 04 Bionic Beaver

Next reboot the system using the command.

sudo reboot

init 6

Step 2: Create Stack user and assign sudo priviledge

Best practice demands that devstack should be run as a regular user with sudo privileges.

With that in mind, we are going to add a new user called “stack” and assign sudo privileges.

To create stack user execute

sudo adduser -s /bin/bash -d /opt/stack -m stack

Next, run the command below to assign sudo privileges to the user

echo "stack ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/stack

Sample Output

Add Stack User And Assign Sudo Privileges

Step 3: Install git and download DevStack

Once you have successfully created the user ‘stack’ and assigned sudo privileges, switch to the user using the command.

su - stack

In most Ubuntu 18.04 systems, git comes already installed. If by any chance git is missing, install it by running the following command.

sudo apt install git -y

Sample output

Switch To Stack User And Install Git

Using git, clone devstack’s git repository as shown.

git clone https://git.openstack.org/openstack-dev/devstack

Sample output

Deploy Devstack

Step 4: Create devstack configuration file

In this step, navigate to the devstack directory.

cd devstack

Then create a local.conf configuration file.

vim local.conf

Paste the following content


[[local|localrc]]

# Password for KeyStone, Database, RabbitMQ and Service
ADMIN_PASSWORD=StrongAdminSecret
DATABASE_PASSWORD=$ADMIN_PASSWORD
RABBIT_PASSWORD=$ADMIN_PASSWORD
SERVICE_PASSWORD=$ADMIN_PASSWORD

# Host IP - get your Server/VM IP address from ip addr command
HOST_IP=10.208.0.10

Save and exit the text editor.

NOTE:

The ADMIN_PASSWORD is the password that you will use to log in to the OpenStack login page. The default username is admin.
The HOST_IP is your system’s IP address that is obtained by running ifconfig or ip addr commands.

Step 5: Install OpenStack with Devstack

To commence the installation of OpenStack on Ubuntu 18.04, run the script below contained in devstack directory.

./stack.sh

The following features will be installed:

Horizon – OpenStack Dashboard
Nova – Compute Service
Glance – Image Service
Neutron – Network Service
Keystone – Identity Service
Cinder – Block Storage Service
Placement – Placement API

The deployment takes about 10 to 15 minutes depending on the speed of your system and internet connection. In our case, it took roughly 12 minutes.

At the very end, you should see output similar to what we have below.

Devstack Installed

This confirms that all went well and that we can proceed to access OpenStack via a web browser.

Step 6: Accessing OpenStack on a web browser

To access OpenStack via a web browser browse your Ubuntu’s IP address as shown.

https://server-ip/dashboard

This directs you to a login page as shown.

Openstack login page

Enter the credentials and hit “Sign In”

You should be able to see the Management console dashboard as shown below.

Openstack Admin Dashboard

For more on Devstack’s customization, check out their system configuration guide.

Additionally, check out the Openstack documentation for administration guide.

Facebook Twitter WhatsApp Reddit LinkedIn Email

Pankaj

I love Open Source technologies and writing about my experience about them is my passion.

Follow Author

Comments

Preeth says:
August 14, 2020 at 1:27 am
Hi,
Could you please help me out with this. I tried to install Openstack on Ubuntu 20.04 LTS, after the last step ./stack.sh it started running for about an hour. And finally got below message:-
wget –progress=dot:giga –2020-08-14 13:01:45– Resolving download.cirros-cloud.net Connecting to download.ci Connecting to download.ci +functions:upload_image:1 +./stack.sh:exit_trap:489 ++./stack.sh:exit_trap:490 +./stack.sh:exit_trap:490 +./stack.sh:exit_trap:493 +./stack.sh:exit_trap:499 +./stack.sh:exit_trap:500 +./stack.sh:exit_trap:504 +./stack.sh:kill_spinner:399 +./stack.sh:exit_trap:506 +./stack.sh:exit_trap:507 Error on exit
+./stack.sh:exit_trap:509 +./stack.sh:exit_trap:510 +./stack.sh:exit_trap:512 +./stack.sh:exit_trap:515 World dumping… ebtables v1.8.4 -c http://download.cirros-cloud.net/0.5.1/cirros-0.5.1-x86_64-disk.img -O /opt/stack/devstac k/files/cirros-0.5.1-x86_64-disk.img
http://download.cirros-cloud.net/0.5.1/cirros-0.5.1-x86 _64-disk.img
(download.cirros-cloud.net)… 64.90.42.85, 2607:f298:6:a036::bd6:a72a
rros-cloud.net (download.cirros-cloud.net)|64.90.42.85| :80… failed: Connection timed out.
rros-cloud.net (download.cirros-cloud.net)|2607:f298:6: a036::bd6:a72a|:80… failed: Network is unreachable.
exit_trap
local r=4
jobs -p
jobs=
[[ -n ” ]]
‘[‘ -f /tmp/tmp.i4cMoIoHkQ ‘]’
rm /tmp/tmp.i4cMoIoHkQ
kill_spinner
‘[‘ ‘!’ -z ” ‘]’
[[ 4 -ne 0 ]]
echo ‘Error on exit’
type -p generate-subunit
generate-subunit 1597386249 4186 fail
[[ -z /opt/stack/logs ]]
/usr/bin/python3.8 /opt/stack/devstac k/tools/worlddump.py -d /opt/stack/logs
see /opt/stack/logs/worlddump-2020-08-14-073355.txt for details
(nf_tables): table `broute’ is incompatible, use ‘nft’ tool.
+./stack.sh:exit_trap:524 exit 4
Please help me out in this. I have given user sudo powers – Without password also, but still error in installation.
Reply
1. SuraHeGoes says:
  August 22, 2020 at 8:38 am
  pip version is the issue in Ubuntu 20.04 LTS. It’s working fine on Ubuntu 18.04
  Reply
Md. Newas says:
June 21, 2020 at 4:43 am
hi ! I am working on ubuntu 18.04 lts an detecting below log:
Package python3-venv is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source
E: Package ‘python3-venv’ has no installation candidate
+functions-common:apt_get:1 exit_trap
+./stack.sh:exit_trap:489 local r=100
++./stack.sh:exit_trap:490 jobs -p
+./stack.sh:exit_trap:490 jobs=
+./stack.sh:exit_trap:493 [[ -n ” ]]
+./stack.sh:exit_trap:499 ‘[‘ -f ” ‘]’
+./stack.sh:exit_trap:504 kill_spinner
+./stack.sh:kill_spinner:399 ‘[‘ ‘!’ -z ” ‘]’
+./stack.sh:exit_trap:506 [[ 100 -ne 0 ]]
+./stack.sh:exit_trap:507 echo ‘Error on exit’
Error on exit
+./stack.sh:exit_trap:509 type -p generate-subunit
+./stack.sh:exit_trap:512 [[ -z /opt/stack/logs ]]
+./stack.sh:exit_trap:515 /usr/local/bin/python3.7 /devstack/tools/worldd ump.py -d /opt/stack/logs
World dumping… see /opt/stack/logs/worlddump-2020-06-21-113238.txt for details
+./stack.sh:exit_trap:524 exit 100
Reply
Mujtaba Bashir says:
May 28, 2020 at 6:50 am
Dear
Greetings!
I tried to install with respective instruction installation goes for around 25 to 35 mins at the end it give exhibit below error and stop. Please guide accordingly
ERROR: Cannot uninstall ‘simplejson’. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.
+inc/python:pip_install:1 exit_trap
+./stack.sh:exit_trap:489 local r=1
++./stack.sh:exit_trap:490 jobs -p
+./stack.sh:exit_trap:490 jobs=
+./stack.sh:exit_trap:493 [[ -n ” ]]
+./stack.sh:exit_trap:499 ‘[‘ -f ” ‘]’
+./stack.sh:exit_trap:504 kill_spinner
+./stack.sh:kill_spinner:399 ‘[‘ ‘!’ -z ” ‘]’
+./stack.sh:exit_trap:506 [[ 1 -ne 0 ]]
+./stack.sh:exit_trap:507 echo ‘Error on exit’
Error on exit
+./stack.sh:exit_trap:509 type -p generate-subunit
+./stack.sh:exit_trap:510 generate-subunit 1590671485 1360 fail
+./stack.sh:exit_trap:512 [[ -z /opt/stack/logs ]]
+./stack.sh:exit_trap:515 /usr/bin/python3.8 /home/stack01/devstack/tools/worlddump.py -d /opt/stack/logs
World dumping… see /opt/stack/logs/worlddump-2020-05-28-133405.txt for details
ebtables v1.8.4 (nf_tables): table `broute’ is incompatible, use ‘nft’ tool.
+./stack.sh:exit_trap:524 exit 1
Thanks.
Best Regards
Reply
1. Rafael says:
  June 3, 2020 at 1:26 pm
  While installing openstack on Ubuntu 18.04, I am stuck at error: cannot uninstall ‘simplejson’
  The problem is with the pip install command. Make the following change to the devstack code:
  Navigate to the devstack folder.
  Edit the inc/python file
  Change line 198:
  from: $cmd_pip $upgrade $install_test_reqs \
  to: $cmd_pip $upgrade $install_test_reqs –ignore-installed \
  Reply
Mujtaba Bashir says:
May 28, 2020 at 6:21 am
Hi Pankaj,
Greetings!
First of all thanks for tutorial. I have one question. How we can login to Openstack CLI mode to practice CLI configuration commands?
Thanks
Reply
Dalton says:
May 8, 2020 at 2:03 pm
Even following all the instructions regarding the user stack, I am receiving the error below.
Exception:
Traceback (most recent call last):
File “/opt/stack/requirements/.venv/lib/python3.6/site-packages/pip/basecommand.py”, line 215, in main
status = self.run(options, args)
File “/opt/stack/requirements/.venv/lib/python3.6/site-packages/pip/commands/install.py”, line 342, in run
requirement_set.prepare_files(finder)
File “/opt/stack/requirements/.venv/lib/python3.6/site-packages/pip/req/req_set.py”, line 380, in prepare_files
ignore_dependencies=self.ignore_dependencies))
File “/opt/stack/requirements/.venv/lib/python3.6/site-packages/pip/req/req_set.py”, line 554, in _prepare_file
require_hashes
File “/opt/stack/requirements/.venv/lib/python3.6/site-packages/pip/req/req_install.py”, line 281, in populate_link
self.link = self._wheel_cache.cached_wheel(self.link, self.name)
File “/opt/stack/requirements/.venv/lib/python3.6/site-packages/pip/wheel.py”, line 68, in cached_wheel
self._cache_dir, link, self._format_control, package_name)
File “/opt/stack/requirements/.venv/lib/python3.6/site-packages/pip/wheel.py”, line 129, in cached_wheel
wheel_names = os.listdir(root)
PermissionError: [Errno 13] Permission denied: ‘/opt/stack/.cache/pip/wheels/a7/c1/ea/cf5bd31012e735dc1dfea3131a2d5eae7978b251083d6247bd’
Reply
1. Wafaa says:
  October 21, 2020 at 3:03 am
  Did you solve this? How? I’m having the same problem 🙁 Help please.
  Reply
2. Arjun says:
  October 29, 2020 at 10:43 pm
  The directories under /opt/stack should be owned by the user stack. Try running sudo chown -R stack:stack /opt/stack.
  Reply
Sam says:
April 5, 2020 at 6:28 pm
is not
sudo adduser -s /bin/bash -d /opt/stack -m stack,
it is :
sudo useradd -s /bin/bash -d /opt/stack -m stack
Reply
Sathish says:
February 15, 2020 at 3:22 am
I got this error in installation time Ubutnu 18.04, please help me anybody
env http_proxy= https_proxy= no_proxy= PIP_FIND_LINKS= SETUPTOOLS_SYS_PATH_TECHNIQUE=rewrite /opt/stack/requirements/.venv/bin/pip install -c /opt/stack/requirements/upper-constraints.txt -U pbr
env: ‘/opt/stack/requirements/.venv/bin/pip’: No such file or directory
+inc/python:pip_install:1 exit_trap
+./stack.sh:exit_trap:535 local r=127
++./stack.sh:exit_trap:536 jobs -p
+./stack.sh:exit_trap:536 jobs=
+./stack.sh:exit_trap:539 [[ -n ” ]]
+./stack.sh:exit_trap:545 ‘[‘ -f ” ‘]’
+./stack.sh:exit_trap:550 kill_spinner
+./stack.sh:kill_spinner:445 ‘[‘ ‘!’ -z ” ‘]’
+./stack.sh:exit_trap:552 [[ 127 -ne 0 ]]
+./stack.sh:exit_trap:553 echo ‘Error on exit’
Error on exit
+./stack.sh:exit_trap:555 type -p generate-subunit
+./stack.sh:exit_trap:556 generate-subunit 1581765591 41 fail
+./stack.sh:exit_trap:558 [[ -z /opt/stack/logs ]]
+./stack.sh:exit_trap:561 /opt/stack/devstack/tools/worlddump.py -d /opt/stack/logs
World dumping… see /opt/stack/logs/worlddump-2020-02-15-112032.txt for details
+./stack.sh:exit_trap:570 exit 127
Reply
1. Sathish says:
  March 19, 2020 at 3:18 am
  Its Working Properly, Thank You so much
  Reply
2. Eric Maye says:
  April 7, 2020 at 6:57 pm
  i have the same erro what is the fix
  Reply
gouthami says:
February 12, 2020 at 10:31 pm
Error on exit
World dumping… see /opt/stack/logs/worlddump-2020-02-06-154209.txt for details
ebtables v1.8.3 (nf_tables): table `broute’ is incompatible, use ‘nft’ tool.
—
stack@HP-Z210-Workstation:~/devstack/tools$ cat /opt/stack/logs/worlddump-2020-02-06-154209.txt|grep broute
sudo ebtables -t broute -L
*** Failed to run ‘sudo ebtables -t broute -L’: Command ‘sudo ebtables -t broute -L’ returned non-zero exit status 1
Reply
1. Gyan says:
  April 17, 2020 at 1:42 pm
  Try Switching to iptable-legacy
  apt-get update
  apt-get upgrade
  apt-get install iptable
  apt-get install arptables
  apt-get install ebtables
  update-alternatives –set iptables /usr/sbin/iptables-legacy || true
  update-alternatives –set ip6tables /usr/sbin/ip6tables-legacy || true
  update-alternatives –set arptables /usr/sbin/arptables-legacy || true
  update-alternatives –set ebtables /usr/sbin/ebtables-legacy || true
  for me it worked with debian Buster
  Reply
Mario says:
February 6, 2020 at 7:53 am
hello,
Distro ubuntu 19.10
problem is :
ack.sh failed
Error on exit
World dumping… see /opt/stack/logs/worlddump-2020-02-06-154209.txt for details
ebtables v1.8.3 (nf_tables): table `broute’ is incompatible, use ‘nft’ tool.
—
stack@HP-Z210-Workstation:~/devstack/tools$ cat /opt/stack/logs/worlddump-2020-02-06-154209.txt|grep broute
sudo ebtables -t broute -L
*** Failed to run ‘sudo ebtables -t broute -L’: Command ‘sudo ebtables -t broute -L’ returned non-zero exit status 1
help me ?
NB: apt update -y && apt upgrade -y : executed upgrade , i start directely ubuntu 19.10 desktop
Reply
amar says:
January 28, 2020 at 3:49 am
+./stack.sh:main:791 echo_summary ‘Installing package prerequisites’
+./stack.sh:echo_summary:452 [[ -t 3 ]]
+./stack.sh:echo_summary:452 [[ True != \T\r\u\e ]]
+./stack.sh:echo_summary:458 echo -e Installing package prerequisites
++./stack.sh:echo_summary:1 exit_trap
++./stack.sh:exit_trap:533 local r=1
+++./stack.sh:exit_trap:534 jobs -p
++./stack.sh:exit_trap:534 jobs=
++./stack.sh:exit_trap:537 [[ -n ” ]]
++./stack.sh:exit_trap:543 ‘[‘ -f ” ‘]’
++./stack.sh:exit_trap:548 kill_spinner
++./stack.sh:kill_spinner:443 ‘[‘ ‘!’ -z ” ‘]’
++./stack.sh:exit_trap:550 [[ 1 -ne 0 ]]
++./stack.sh:exit_trap:551 echo ‘Error on exit’
./stack.sh: line 551: echo: write error: Broken pipe
Reply
Ricardo Mejias says:
January 25, 2020 at 9:42 pm
Hello, I am installing openstack on ubuntu 18.04 and this command that su recommend do not work — sudo adduser -s /bin/bash -d /opt/stack -m stack
Reply
1. Pankaj says:
  January 26, 2020 at 4:59 am
  what’s the error you are getting?
  Reply
  1. matumona says:
    April 15, 2020 at 1:40 pm
    good evening master ,please help me ! I´m trying to install devstack ,almost everything install well but at the end i receive this erros message
    =============================================================================== log end ================================================================================
    ERROR: could not install deps [-chttps://releases.openstack.org/constraints/upper/master, -r/opt/stack/tempest/requirements.txt, -r/opt/stack/tempest/doc/requirements.txt]; v = InvocationError(‘/opt/stack/tempest/.tox/venv/bin/pip install -chttps://releases.openstack.org/constraints/upper/master -r/opt/stack/tempest/requirements.txt -r/opt/stack/tempest/doc/requirements.txt’, 1)
    _______________________________________________________________________________ summary ________________________________________________________________________________
    ERROR: venv: could not install deps [-chttps://releases.openstack.org/constraints/upper/master, -r/opt/stack/tempest/requirements.txt, -r/opt/stack/tempest/doc/requirements.txt]; v = InvocationError(‘/opt/stack/tempest/.tox/venv/bin/pip install -chttps://releases.openstack.org/constraints/upper/master -r/opt/stack/tempest/requirements.txt -r/opt/stack/tempest/doc/requirements.txt’, 1)
    +lib/tempest:configure_tempest:1 exit_trap
    +./stack.sh:exit_trap:533 local r=1
    ++./stack.sh:exit_trap:534 jobs -p
    +./stack.sh:exit_trap:534 jobs=
    +./stack.sh:exit_trap:537 [[ -n ” ]]
    +./stack.sh:exit_trap:543 ‘[‘ -f /tmp/tmp.1Bomg5c4aS ‘]’
    +./stack.sh:exit_trap:544 rm /tmp/tmp.1Bomg5c4aS
    +./stack.sh:exit_trap:548 kill_spinner
    +./stack.sh:kill_spinner:443 ‘[‘ ‘!’ -z ” ‘]’
    +./stack.sh:exit_trap:550 [[ 1 -ne 0 ]]
    +./stack.sh:exit_trap:551 echo ‘Error on exit’
    Error on exit
    +./stack.sh:exit_trap:553 type -p generate-subunit
    +./stack.sh:exit_trap:554 generate-subunit 1586976290 6458 fail
    +./stack.sh:exit_trap:556 [[ -z /opt/stack/logs ]]
    +./stack.sh:exit_trap:559 /usr/bin/python3.6 /home/stack/devstack/tools/worlddump.py -d /opt/stack/logs
    World dumping… see /opt/stack/logs/worlddump-2020-04-15-203231.txt for details
    nova-compute: no process found
    neutron-dhcp-agent: no process found
    neutron-l3-agent: no process found
    neutron-metadata-agent: no process found
    neutron-openvswitch-agent: no process found
    +./stack.sh:exit_trap:568 exit 1
    stack@ubuntu:~/devstack$
    I really do not know what else I can do !!!! plz help me, thanks for the attentions.
    Reply
Lester Carrejo says:
December 31, 2019 at 9:50 am
Step 2 should be useradd instead of adduser.
Reply