DevStack Installation Guide

Downloading VMware Workstation

To download VMware Workstation:

1. Navigate to the VMware Workstation Download Center.

2. Based on your requirements, click Go to Downloads for VMware Workstation for
Windows or VMware Workstation for Linux.
3. Click Download Now.
4. If prompted, log in to your My VMware profile. If you do not have a profile, create
one. For more information, see How to create a My VMware profile (2007005).
5. Ensure that your profile is complete and enter all mandatory fields. For more
information, see How to update your My VMware profile (2086266).
6. Review the End User License Agreement and click Yes.
7. Click Download Now.

Installing VMware Workstation

Notes:

 You must have only one VMware Workstation installed at a time. You must uninstall
previous version of VMware Workstation before installing a new version.
 If the installer reports an error when you run it, you must verify the download. For
more information, see Verifying the integrity of downloaded installer files (1537).

To install VMware Workstation on a Windows host:

1. Log in to the Windows host system as the Administrator user or as a user who is a
member of the local Administrators group.
2. Open the folder where the VMware Workstation installer was downloaded. The
default location is the Downloads folder for the user account on the Windows host.

Note: The installer file name is similar to VMware-workstation-full-xxxx-xxxx.exe,

where xxxx-xxxx is the version and build numbers.

3. Right-click the installer and click Run as Administrator.

4. Select a setup option:
o Typical: Installs typical Workstation features. If the Integrated Virtual Debugger for
Visual Studio or Eclipse is present on the host system, the associated Workstation
plug-ins are installed.
o Custom: Lets you select which Workstation features to install and specify where to
install them. Select this option if you need to change the shared virtual machines
directory, modify the VMware Workstation Server port, or install the enhanced virtual
keyboard driver. The enhanced virtual keyboard driver provides better handling of
international keyboards and keyboards that have extra keys.

5. Follow the on-screen instructions to finish the installation.

6. Restart the host machine.

To install VMware Workstation on a Linux host:

Note: VMware Workstation for Linux is available as a .bundle download in the

VMware Download Center. The Linux bundle installer starts a GUI wizard on most
Linux distributions. In some Linux distributions, the bundle installer starts a
command-line wizard instead of a GUI wizard.

1. Log in to the Linux host with the user account that you plan to use with VMware
Workstation.
2. Open a terminal interface. For more information, see Opening a command or shell
prompt (1003892).
3. Change to root. For example:

su root

Note: The command that you use depends on your Linux distribution and
configuration.

4. Change directories to the directory that contains the VMware Workstation bundle
installer file. The default location is the Download directory.
5. Run the appropriate Workstation installer file for the host system.

For example:

sh VMware-workstation-Full-xxxx-xxxx.architecture.bundle [--option]

Where:
o xxxx-xxxx is the version and build numbers
o architecture is i386 or x86_64
o option is a command line option.

This table describes the command line options:

Option Description

Opens the GUI-based VMware installer, which is the

--gtk
default option.

--console Use the terminal for installation.

Use this option to customize the locations of the

--custom installation directories and set the hard limit for the
number of open file descriptors.

Shows installation questions that have not answered

--regular
before or are required. This is the default option.

--ignore-errors Allows the installation to continue even if there is an

error in one of the installer scripts. Because the
or section that has an error does not complete, the
component might not be properly configured.
-I

Shows the license agreement only and then proceeds

--required
to install Workstation

6. Accept the license agreement.

Note: If you are using the --console option or installing VMware Workstation on a
Linux host that does not support the GUI wizard, press Enter to scroll through and
read the license agreement or type q to skip to the yes/no prompt.

7. Follow the on-screen instructions or prompts to finish the installation.

8. Restart the Linux host.
 After installation
On Windows host systems:

 The installer creates a desktop shortcut, a quick launch shortcut, or a combination of

these options in addition to a Start Menu item.
 To start VMware Workstation on a Windows host system, select Start > Programs >
VMware Workstation.

On Linux host systems:

 VMware Workstation can be started from the command line on all Linux distributions.
 On some Linux distributions, VMware Workstation can be started in the GUI from the
System Tools menu under Applications.
 To start VMware Workstation on a Linux host system from the command line, run the
vmware & command in a terminal window. For more information, see Opening a
command or shell prompt (1003892).

For example:

/usr/bin/vmware &

When you start the Workstation for the first time, Workstation prompts you to accept
the End User License Agreement. After you start Workstation, the Workstation
window opens.

DevStack Installation

DevStack is a series of extensible scripts used to quickly bring up a complete

OpenStack environment based on the latest versions of everything from git master. It
is used interactively as a development environment and as the basis for much of the
OpenStack project’s functional testing.

The source is available at https://opendev.org/openstack/devstack

Warning
DevStack will make substantial changes to your system during installation. Only run
DevStack on servers or virtual machines that are dedicated to this purpose.
Install Linux:
Start with a clean and minimal install of a Linux system. DevStack attempts to support
the two latest LTS releases of Ubuntu, the latest/current Fedora version,
CentOS/RHEL 8 and OpenSUSE.
If you do not have a preference, Ubuntu 18.04 (Bionic Beaver) is the most tested, and
will probably go the smoothest.
To download Ubuntu 18.04:
https://releases.ubuntu.com/18.04/
Add Stack User (optional)
DevStack should be run as a non-root user with sudo enabled (standard logins to cloud
images such as “ubuntu” or “cloud-user” are usually fine).
If you are not using a cloud image, you can create a separate stack user to run
DevStack with

$ sudo useradd -s /bin/bash -d /opt/stack -m stack

Since this user will be making many changes to your system, it should have sudo
privileges:

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

$ sudo su - stack

Download DevStack

$ git clone https://opendev.org/openstack/devstack

$ cd devstack

The devstack repo contains a script that installs OpenStack and templates for
configuration files.
Create a local.conf
Create a local.conf file with four passwords preset at the root of the devstack git repo.

[[local|localrc]]
ADMIN_PASSWORD=secret
DATABASE_PASSWORD=$ADMIN_PASSWORD
RABBIT_PASSWORD=$ADMIN_PASSWORD
SERVICE_PASSWORD=$ADMIN_PASSWORD
This is the minimum required config to get started with DevStack.
$ vim local.conf
If vim is not installed, you can install it via:
Sudo apt install vim
Note
There is a sample local.conf file under the samples directory in the devstack
repository.

Start the install

$ ./stack.sh
This will take a 15 - 20 minutes, largely depending on the speed of your internet
connection. Many git trees and packages will be installed during this process.
 Troubleshooting Errors!!!
1- Permissionerror: Permission denied

To resolve this issue

Execute this command
$ sudo chown –R stack:stack /opt/stack
2- ERROR: cannot uninstall ‘simplejason’

To resolve this issue

Execute this command
$ sudo apt purge python3-simplejson
3- KeyError: ‘XDG_SESSION_TYPE’

To resolve this issue

Execute this command
$ export XDG_SESSION_TYPE=wayland
Installation Succeeded:
If the installation succeed you will get this message:

To access to Devstack dashboard you will open the horizon web link via your browser
and use the credentials previously configured:admin/your password

Profit!
You now have a working DevStack! Congrats!
Your devstack will have installed keystone, glance, nova, placement, cinder, neutron,
and horizon. Floating IPs will be available, guests have access to the external world.
You can access horizon to experience the web interface to OpenStack, and manage
vms, networks, volumes, and images from there.
You can source openrc in your shell, and then use the openstack command line tool to
manage your devstack.
You can cd /opt/stack/tempest and run tempest tests that have been configured to work
with your devstack.

You can make code changes to OpenStack and validate them.