- Home /
- Resources /
- Learning center /
- OpenStack DevStack
OpenStack DevStack
Use DevStack to install and test OpenStack on an Equinix Metal server.
On this page
With some technical skills, DevStack is a great option to install and test OpenStack on your laptop or on an Equinix Metal server. DevStack is ideal for users who want to see what the Dashboard looks like from an admin or user perspective, and OpenStack contributors wanting to test against a complete local environment.
By default DevStack is run with all the services as systemd unit files. Systemd is now the default init system for nearly every Linux distro, and systemd encodes and solves many of the problems related to poorly running processes.
The reason why DevStack cannot be used for production purposes, is because after a reboot, it is almost impossible to bring it up on the last known good state.
DevStack attempts to support Ubuntu 16.04/17.04, Fedora 24/25, CentOS/RHEL 7, as well as Debian and OpenSUSE. Equinix Metal supports any of these operating systems by default.
If you do not have a preference, Ubuntu 16.04 is the most tested, and will probably go the smoothest.
Warning: DevStack will make substantial changes to your system during installation. Only run DevStack on servers that are dedicated testing purposes.
Getting Started
For this guide, I will be using the official DevStack documentation, but we will do some modifications on the local.conf file.
I have deployed a Type1 server with a custom /29 subnet running Ubuntu 16.04.
You should specify the larger custom subnet so that you can give Public IPs to some test VMs, making them easily reach them from the public internet.
IP Address Usage
We have requested 8 total IPs from Equinix Metal during provisioning. Here is how the 8 IPs will be used on the custom /29 subnet:
- 147.75.x.0 - Network address
- 147.75.x.1 - Gateway
- 147.75.x.2 - Host IP
- 147.75.x.3 - .6 - Usable IPs for VMs
- 147.75.x.7 - Broadcast
If you need more IPs, you can choose to go with a /28 subnet.
Once the server is provisioned, please run the following command to ensure your system is fully up to date:
apt-get update && apt-get upgrade -y
I would suggest a server reboot here, so it picks up the new kernel, if one is installed.
Installing and Configuring DevStack
Create a new user named stack and switch to that user:
useradd -s /bin/bash -d /opt/stack -m stack
echo "stack ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers
su - stack
Then get the latest Devstack from its Github repository:
sudo apt-get install git -y
git clone https://git.openstack.org/openstack-dev/devstack
Once that finishes, you will see a devstack directory created. Navigate to that directory and create a new file named local.conf with the following details:
- Note! I am using the IPs I mentioned above, make sure to change the four (4) passwords as well.
Warning! This setup will hijack the configuration of the default bond0 and create a new br-ex bridge. It will also modify the routes of the server. If you reboot, the server will not have network, since the changes on the network side are not permanent.
[[local|localrc]]
PUBLIC_INTERFACE=bond0
HOST_IP=147.75.x.2
FLOATING_RANGE=147.75.x.0/28
PUBLIC_NETWORK_GATEWAY=147.75.x.1
Q_FLOATING_ALLOCATION_POOL=start=147.75.x.3,end=147.75.x.6
ADMIN_PASSWORD=supersecret
DATABASE_PASSWORD=iheartdatabases
RABBIT_PASSWORD=flopsymopsy
SERVICE_PASSWORD=iheartksl
VOLUME_BACKING_FILE_SIZE=25000M
Save and close the file. Now run the DevStack installer:
./stack
This is quite a long script, and will take minutes on a c1.small. Once the script finishes, you will see the following messages:
This is your host IP address: 147.75.x.2
Horizon is now available at http://147.75.x.2/dashboard
The default users are: admin and demo
The password: supersecret
Well done! Now we have an OpenStack environment ready to play with.
Creating Your First VM
There are a few different ways to create VMs, from creating a Bootable Volume using an ISO image to using a Cloud qcow2 Image. For the sake of simplicity, we'll create a Bootable Volume with a CentOS 7 NetInstall ISO.
Security Groups
First, you need to add some security group rules. Make sure you are in the admin area of the UI, then add the following rules under Project > Network > Security Groups > Manage Rules:
- All ICMP - Ingress - CIDR - 0.0.0.0/0
- SSH - CIDR - 0.0.0.0/0
You'll also want to specify your DNS server and enable DHCP under Project > Network > Networks > Public > Subnets > Edit Subnet > Subnet Details > Enable DHCP. Add the Nameservers of your choice.
Install the Image
Now you can add a CentOS Streams 9 Image (available here) by going to Project > Images > Create Image.
- Give it a name, select your Image, select ISO option, and then click Create Image.
- Depending on your network connection, you might have to wait a moment.
Create a Temporary Instance
Next, we will create a temporary instance. Navigate to Project > Compute > Instances > Launch Instance
- Give your instance a name, select Image on the Boot Source
- Select "No" on Create New Volume, and then click the arrow on the image that was just created from the list.
- Finally, select one of the available flavors (I’m going with m1.small) and click Launch Instance.
Create an Empty Volume
The next step is to create an empty volume (where we will install CentOS later) via Project > Volumes > Volumes > Create Volume
- Give the volume a name, make sure to select the empty volume option, and the size 20Gb.
- Next, select Manage Attachments on the Actions, and choose the instance that was just created.
Install CentOS
Now, go back to the instance, reboot it, and you should be able to get on its console.
- When asked, you can install a minimal by using the Centos Mirror
- Enable Eth0 and check to see if the IPs are correct.
- Wait for the Installation to complete.
- After completing the installation, go ahead and shutdown the instance.
Bootable Volume
The final step is to make your volume bootable, this will allow you to attach other instances and boot from them directly.
- Navigate to Project > Compute > Volumes > Actions
- First you will have to detach it, and then Edit Volume to select the Bootable option.
Conclusion
You now have a CentOS 7 Volume ready, which you can use for VMs. I suggest creating a snapshot at this point, which you can use to duplicate Volumes later.
If everything was done correctly, then launching a new instance with a CentOS volume will be smooth sailing, and it will have network so you can access via ssh.
You may also like
Dig deeper into similar topics in our archivesConfiguring BGP with BIRD 2 on Equinix Metal
Set up BGP on your Equinix Metal server using BIRD 2, including IP configuration, installation, and neighbor setup to ensure robust routing capabilities between your server and the Equinix M...
Configuring BGP with FRR on an Equinix Metal Server
Establish a robust BGP configuration on your Equinix Metal server using FRR, including setting up network interfaces, installing and configuring FRR software, and ensuring secure and efficie...
Crosscloud VPN with WireGuard
Learn to establish secure VPN connections across cloud environments using WireGuard, including detailed setups for site-to-site tunnels and VPN gateways with NAT on Equinix Metal, enhancing...
Deploy Your First Server
Learn the essentials of deploying your first server with Equinix Metal. Set up your project & SSH keys, provision a server and connect it to the internet.
Ready to kick the tires?
Use code DEPLOYNOW for $300 credit