[[TOC(Documentation/f*, depth=3)]]

== Tutorial: OpenStack Setup==
Requirements:

1. [https://www.orbit-lab.org/wiki/Documentation/CGettingStarted Setup/Practice] of Orbit Nodes. 

2. Any available Orbit Sandbox Node

3. Ubuntu 20.04.5 LTS or Ubuntu 22.04.5 LTS (Choice is up to you)

----

In this tutorial, we will be using one of the sb9 nodes for setting up OpenStack. However, sb(1-10) should also be capable for OpenStack setup.  

Make sure you have Ubuntu 20.04.5 (**baseline20.04.ndz**) or 22.04.5 (**ubuntu2204-beta.ndz**) LTS. To get the Ubuntu Version, follow these steps after ssh'ing into your console. Substitute for the image and node you want.

The below steps illustrate loading Ubuntu 20.04.5 LTS for node1-2 of sb9. On your sb9 console,

{{{omf tell -t node1-2 -a offh }}}

{{{omf load -t node1-2 -i baseline20.04.ndz}}}

{{{omf tell -t node1-2 -a on}}}

To verify if you have loaded your Ubuntu version properly, use this command after ssh into the node1-2 

{{{lsb_release -a}}} 

This will list the current version of Ubuntu loaded.

=== Set up an OpenStack development environment via DevStack ===
After loading the Ubuntu 20.04 image is complete, you can follow below steps to install OpenStack

1. Update and Upgrade Packages:
{{{sudo apt-get update && sudo apt-get upgrade}}}
2. Install Git:
{{{sudo apt-get install git}}}
3. Clone the DevStack Repository:
{{{git clone https://github.com/openstack/devstack.git}}}
4. Create a Stack User:
{{{sudo ./devstack/tools/create-stack-user.sh}}}
5. Switch to the Stack User:
{{{sudo su stack}}} 


{{{cd ~}}}
6. Clone the DevStack Repository (as the Stack User):
{{{git clone https://git.openstack.org/openstack-dev/devstack}}}
7. Remove the Existing Python 3 Pip Package (if present) and Download and Install the Latest Python 3 Pip Package:
{{{sudo apt remove python3-pip}}}


{{{wget https://bootstrap.pypa.io/get-pip.py}}} 


{{{sudo python3 get-pip.py}}}

8. Install a Specific Version of the Cryptography Package(there is version conflict with the OpenSSL package automatically installed by dev stack, install the below version to prevent this issue) :
{{{pip install cryptography==38.0.4}}}
9. Configure and setup local.conf in dev stack folder according to requirement (either the controller or compute node):

{{{cd devstack/samples }}}


{{{cp local.conf ../}}}


{{{cd ../}}}

after copying local.conf to the devstack folder, uncomment and change the HOST_IP to the IP of the current node(so here in this case 10.19.1.2) and

10. Fireup the Stack:
{{{FORCE=yes ./stack.sh}}}

For more details related to installation process: https://docs.openstack.org/watcher/newton/dev/devstack.html




This will take around 15-20 minutes. In this process, you might be asked to set up passwords for Horizon, MYSQL, etc. 
Once installation is done, it provides information related to Horizon, Keystone which will look something like this. 

This is your host IP address: 10.19.1.2

This is your host IPv6 address: ::1

Horizon is now available at http://10.19.1.2/dashboard

Keystone is serving at http://10.19.1.2/identity/

The default users are: admin and demo
The password: *****(Password set by you during installation process)


You can log in to view the Horizon dashboard(http://10.19.1.2/dashboard) using below default credentials