=== Open Source MANO (OSM)

A full deployment consists of 3 components:
* OSM as the NFV Orchestrator
* OpenVIM or Openstack as the virtual infrastructure manager (VIM)
* some number of compute nodes, where the VIM will run VMs under OSM's instruction

We will use the following components:
* OSM on ubuntu 18.04
* Devstack on ubuntu 18.04, in a single node configuration (this can easily be extended following devstack guides)


==== OSM Node
This tutorial implements the getting started from:
https://osm.etsi.org/wikipub/index.php/OSM_Release_SIX

and adds support for ORBIT hardware.

The previous tutorial targeted Ubuntu 14.04 and 16.04, this is updated for Ubuntu 18.04.

===== Pre-set-up:
{{{ omf load -t srv1-lg1.sb1.cosmos-lab.org -i opensourcemano_1804.ndz }}}



ssh Credentials: native / native

Web Credentials admin / admin

[[CollapsibleStart(From Scratch)]]
Dependencies:
* 40Gb disk space
* user:
 * non-root user,
 * with non-empty password
 * member of sudo, docker, lxd groups
* Packages:
 * net-tools
* ipv6 disabled

1. Prepare the node
 1. Load the image: {{{ omf load -t srv3-lg1.sb1.cosmos-lab.org -i baseline_1804.ndz -r 60 }}}
 1. Turn the node on: {{{ omf tell -a on -t srv3-lg1.sb1.cosmos-lab.org }}}
 1. Log in as root: {{{ ssh native@srv3-lg1.sb1.cosmos-lab.org }}}
 1. set up non-root user {{{  echo native:native | chpasswd }}}
 1. Add user to groups: {{{ sudo groupadd lxd && sudo groupadd docker && sudo usermod -a -G lxd,docker native }}}
 1. logout: {{{ exit }}}
 1. Log in as the user "native": {{{ ssh native@srv3-lg1.sb1.cosmos-lab.org }}}
1. Set up OSM
 1. Install "net-tools" {{{ sudo apt install net-tools }}}
 1. Download script: {{{ wget https://osm-download.etsi.org/ftp/osm-6.0-six/install_osm.sh }}}
 1. Make it executable: {{{ chmod +x install_osm.sh }}}
 1. Run it: {{{ ./install_osm.sh 2>&1 | tee osm_install_log.txt }}}
 1. enter "y"
  1. if it crashes, run {{{ lxd init }}}
 1. choose all defaults, except {{{none}}} for ipv6
 1. if failed, rerun install_osm.sh
1. Connect browser
 1. Via ssh tunnel
 1. via VPN (TODO)
 1. navigate browser to node control ip, enter admin/admin as credentials


Run these commands to clean up the old configuration:

docker stack rm osm && sleep 60 # The sleep is for making sure the stack removal finishes before redeploying
docker stack deploy -c /etc/osm/docker/docker-compose.yaml osm

Save image
 
[[CollapsibleEnd]]
==== VIM Node
OSM 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/latest/guides/single-machine.html



===== Pre-Set up:
1. {{{ omf load -t srv2-lg1.sb1.cosmos-lab.org -i devstack_1804.ndz -r 60}}}
1. {{{ omf tell -a on -t srv2-lg1.sb1.cosmos-lab.org }}}
1. {{{ ssh root@srv2-lg1.sb1.cosmos-lab.org }}}
1. {{{ su stack && cd ~/devstack }}}
1. {{{ ./stack.sh }}}



[[CollapsibleStart(From Scratch)]]
Follow https://docs.openstack.org/devstack/latest/guides/single-machine.html

https://docs.openstack.org/devstack/latest/networking.html


If you don’t specify any configuration you will get the following:

neutron (including l3 with openvswitch)

private project networks for each openstack project

a floating ip range of 172.24.4.0/24 with the gateway of 172.24.4.1

the demo project configured with fixed ips on a subnet allocated from the 10.0.0.0/22 range

a br-ex interface controlled by neutron for all its networking (this is not connected to any physical interfaces).

DNS resolution for guests based on the resolv.conf for your host

an ip masq rule that allows created guests to route out

PUBLIC_INTERFACE=eth1 (this connects to the br-ex bridge)

https://docs.openstack.org/devstack/latest/_sources/guides/neutron.rst.txt


[[CollapsibleEnd]]


==== Connecting OSM to the VIM
* URL {{{ http://openstackip/identity/v3 }}}
* User {{{ admin }}}
* password {{{ nomoresecret }}}
* tenant {{{ admin }}}
* name {{{ openstack-site }}}

==== Creating a VNF
* upload vnf description
* upload nf descrtiption

* instantiate nf

* use openstack ui to load console and ping