Changes between Version 58 and Version 59 of Tutorials/Cloud/OSM


Ignore:
Timestamp:
Aug 21, 2020, 2:15:10 PM (4 years ago)
Author:
msherman
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • Tutorials/Cloud/OSM

    v58 v59  
    1 === Open Source MANO (OSM)
    2 
     1[[TOC]]
     2=== Open Source MANO (OSM) Tutorial
     3==== Changelog
     4`08/20/2020 Updated to OSM release EIGHT, Openstack release Train`
     5
     6==== Overview
    37A full deployment consists of 3 components:
    48* OSM as the NFV Orchestrator
    5 * OpenVIM or Openstack as the virtual infrastructure manager (VIM)
    6 * some number of compute nodes, where the VIM will run VMs under OSM's instruction
     9* Openstack, OpenVIM, OpenNebula, or similar as the virtual infrastructure manager (VIM)
     10* Some number of compute nodes, where the VIM will run VMs under OSM's instruction
    711
    812We will use the following components:
    913* OSM on ubuntu 18.04
    1014* Devstack on ubuntu 18.04, in a single node configuration (this can easily be extended following devstack guides)
    11 
     15* This Devstack configuration combines the VIM node and the compute node on one machine. OSM communicates with the Openstack identity service to discover the rest of the configuration.
    1216
    1317This tutorial implements the getting started from: [https://osm.etsi.org/docs/user-guide/01-quickstart.html#installing-osm here], and adds support for ORBIT hardware, with the image based on Ubuntu 18.04.
    … …  
    1519To save time, run the OSM and VIM steps in separate ssh terminals, as they can be done at the same time.
    1620
    17 ==== OSM Node
    18 
    19 
    20 ===== Pre-set-up:
    21 1. Create a reservation
    22 1. Log into the console
    23 1. Load image: {{{ omf load -t srv1-lg1.sb1.cosmos-lab.org -i tutorial-osm.ndz -r 60}}}
    24   1. You should see: {{{ INFO exp:  1 node successfully imaged ... }}}
     21==== Prerequisites:
     221. SSH keys set up for the testbed
     231. Ability to set up ssh tunneling to access the web interface pages
     241. A reservation for a domain with at least two compute resources
     251. For convenience, 3 terminal windows.
     26
     27==== OSM Node Set Up
     28
     291. Log into the console with your first terminal
     301. Load the `tutorial-osm.ndz` onto the first node, and resize to >= 60gb:
     31  * Example: {{{ omf load -t srv1-lg1.sb1.cosmos-lab.org -i tutorial-osm.ndz -r 60}}}
     32  * Wait for imaging process to complete. Work on the other terminals in the meantime
     33  * You should see: {{{ INFO exp:  1 node successfully imaged ... }}}
    25341. Turn the node on: {{{ omf tell -a on -t srv1-lg1.sb1.cosmos-lab.org }}}
    26351. Wait for the node to come up, (up to ~3 minutes)
    27  1. You can ping the node, it will respond once booted
     36  * You can ping the node, it will respond once booted
    2837
    2938
    … …  
    7079 
    7180[[CollapsibleEnd]]
    72 ==== VIM Node
     81
     82==== VIM Node Set up:
    7383OSM must have a Virtual Infrastructure Manager (VIM) to control. We will use openstack on single node devstack for this tutorial, following [https://docs.openstack.org/devstack/train/guides/single-machine.html this guide].
    7484
    7585
    76 
    77 ===== Pre-Set up:
    78 1. {{{ omf load -t srv2-lg1.sb1.cosmos-lab.org -i tutorial-devstack.ndz -r 60}}}
    79  1. You should see: {{{ INFO exp:  1 node successfully imaged ... }}}
    80 1. {{{ omf tell -a on -t srv2-lg1.sb1.cosmos-lab.org }}}
     861. Log into the console with your second terminal
     871. Load the `tutorial-devstack.ndz` onto the second node, and resize to >= 60gb:
     88  * Example: {{{ omf load -t srv2-lg1.sb1.cosmos-lab.org -i tutorial-devstack.ndz -r 60}}}
     89  * Wait for imaging process to complete. Work on the other terminals in the meantime
     90  * You should see: {{{ INFO exp:  1 node successfully imaged ... }}}
     911. Turn the node on: {{{ omf tell -a on -t srv2-lg1.sb1.cosmos-lab.org }}}
    81921. Wait for the node to come up  (up to ~3 minutes)
    8293 1. You can ping the node, it will respond once booted
    83 1. {{{ ssh native@srv2-lg1.sb1.cosmos-lab.org }}}
    84 1. {{{ cd ~/devstack }}}
    85 1. {{{ ./stack.sh }}}
     941. SSH into the node {{{ ssh native@srv2-lg1.sb1.cosmos-lab.org }}}
     951. Change to the Devstack directory: {{{ cd ~/devstack }}}
     961. Run the installation script: {{{ ./stack.sh }}}
     97
     98Note, we use `username: native, password: native` , because Openstack needs a non-root user.
     99
    86100
    87101Commands will run for a while (about 10 minutes). If successful, it will output the credentials and address to login via the webui, and will look like the following:
    … …  
    114128}}}
    115129
    116 You will need the ip address, keystone url, user and password in the following steps.
    117 
     130You will need the Host IP address, Horizon and Keystone URLs, and user and password in the following steps.
    118131
    119132[[CollapsibleStart(From Scratch)]]
    … …  
    156169[[CollapsibleEnd]]
    157170
    158 ==== Accessing the OSM WebUI
    159 Both nodes are listening on port 80.
    160 
    161 Redirect two ports over ssh, following [wiki:UserGuide/RemoteAccess/SshTunnel This Guide]
    162 
    163 For example, forward 9901 -> srv1-lg1:80 , 9902 -> srv2-lg1:80
    164 
    165 Or Linux example, commands run on your local machine:
     171==== Connecting to the Web Interfaces
     172
     173Use your third terminal, or whatever ssh program you are using, to forward a different local port to port 80 on each of the OSM and VIM machines.
     174
     175For more information, follow [wiki:UserGuide/RemoteAccess/SshTunnel This Guide]
     176
     177For example, using a linux shell, and forwarding: 9901 -> srv1-lg1:80 , 9902 -> srv2-lg1:80
     178
    166179{{{ #!shell
    167180ssh testbeduser@sb1.cosmos-lab.org -N \
    … …  
    170183}}}
    171184
    172 The web credentials are: admin / admin, running at the ip address of the first node.
    173 
    174 If the webui doesn't come up:
    175 1. SSH to the node with the ssh credentials: native / native
    176 1. Check to see that all containers are running {{{ docker stack ps osm }}}
    177 1. Try re-installing OSM by running {{{./install_osm.sh}}}
     185
     186The OSM Web UI will likely be ready much sooner than the Openstack UI, due to the time taken for installation.
     187
     188* OSM Web UI
     189  * Credentials are: `admin / admin`
     190  * Use your browser to navigate to the first forwarded port, here `localhost:9980`
     191* If the webui doesn't come up:
     192  1. SSH to the node with the ssh credentials: native / native
     193  1. Check to see that all containers are running {{{ docker stack ps osm }}}
     194  1. Try re-installing OSM by running {{{./install_osm.sh}}}
     195* Openstack Web UI
     196  * Credentials are: `admin / native`, unless different in the stack.sh output.
     197  * Use your browser to navigate to the second forwarded port, here `localhost:9981`
     198  * The web UI won't be ready until stack.sh completes successfully
     199* The following steps are executed in the respective web interfaces
    178200
    179201
    … …  
    1952171. in a new window, go to the openstack webui
    1962181. click images
    197 1. click create image
     2191. click create image, and use the following properties (important)
    198220 * name: {{{cirros034}}}
    199  * image source: browse for the file you downloaded
    200  * format: qcow2
     221 * image source: browse for the file you downloaded from the wiki
     222 * format: `qcow2`
    2012231. click create image
    202224