WhatsAppRedditLinkedIn

How to Install OpenStack on Ubuntu 18.04 with DevStack

Pankaj - 17 Comments
Filed Under: Ubuntu

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.

Minimum Requirements

Before we begin, ensure you have the following minimum prerequisites

  1. A fresh Ubuntu 18.04 installation
  2. User with sudo privileges
  3. 4 GB RAM
  4. 2 vCPUs
  5. Hard disk capacity of 10 GB
  6. 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

OR

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:

  1. The ADMIN_PASSWORD is the password that you will use to log in to the OpenStack login page. The default username is admin.
  2. 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.

WhatsAppRedditLinkedIn
Pankaj

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

Comments

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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
  6. 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
  7. 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
  8. 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
  9. 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
  10. 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
  11. Lester Carrejo says:
    December 31, 2019 at 9:50 am

    Step 2 should be useradd instead of adduser.

    Reply

Leave a Reply

Your email address will not be published. Required fields are marked *

close
Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages