OSM pingpong tutorial using ORANGE-NFV virtual machine (20/6/2019)
------------------------------------------------------------------

- Download and install virtual machine from:

https://idefix.dit.upm.es/download/orange/ORANGE-NFV-2019-v2.ova

- Start the VM and wait arong 90 secs till all OSM services have started.

- Check that the VIM emulator (vim-emu) has started correcty with:

osm-check-vimemu

  You should see something like:

upm@vnxlab:~$ osm-check-vimemu 
-- docker:
320c8a82ed29 vim-emu-img "/son-emu/utils/dock…"   23 seconds ago      Up 20 seconds            4000/tcp, 5000-5001/tcp, 6001/tcp, 8081/tcp, 9005/tcp, 9091/tcp, 9775/tcp, 10243/tcp, 10697/tcp   vim-emu
-- Address:
10.0.0.37

  If you get no information about vim-emu, just restart it by executing:

osm-restart-vimemu 

- Open a web browser and connect to http://localhost and login with admin/admin. 

- Check again that the VIM emulator is running by going ti "VIM accounts" option. You should see a line like:

emu-vim1	29445fe1-c099-467c-8180-9cf2fa994930	openstack	ENABLED

- Load the pingpong VNF descriptors using the GUI:
  + Open a linux file browser and navigate to /home/upm/osm/vim-emu/examples/vnfs directory 
  + Go to "VNF Packages" option in OSM GUI
  + Drag and drop the ping.tar.gz and pong.tar.gz files into the OSM GUI

- Alternatively, you can register the VNFs from the command line with:

osm vnfd-create /home/upm/osm/vim-emu/examples/vnfs/ping.tar.gz
osm vnfd-create /home/upm/osm/vim-emu/examples/vnfs/pong.tar.gz

- Load the pingpong network service in /home/upm/osm/vim-emu/examples/services/pingpong_nsd.tar.gz 
  by drag and droppping the file into the "NS Packages" OSM page. 

- Alternatively, you can register the NS from the command line with:

osm nsd-create /home/upm/osm/vim-emu/examples/services/pingpong_nsd.tar.gz

- Instantiate the pingpong network service from the OSM "NS instances" page by clicking on
  the "New NS" button. Name it "test"

- Alternatively, you can instantiate it from the command line with:

osm ns-create --nsd_name pingpong --ns_name test --vim_account emu-vim1

- Once started you can see the active NS and VNFs with.

osm ns-list
osm vnf-list

- Check that docker containers implementing the ping and pong VNFs are running with:

sudo docker ps -a | grep mn

- You can access them with:

sudo docker exec -it mn.dc1_pingpong-1-ubuntu-1 /bin/bash

- Once inside the containers you can check the interfaces and ping the other side:  
ifconfig
ping 192.168.100.3
ping 192.168.100.4

Troubleshooting
---------------



Other interesting commands
--------------------------

- Show ns and vnf descriptors registered:
osm nsd-list
osm vnfd-list

- Show ns and vnf active:
osm ns-list
osm vnf-list

- Chech vim-emu:
sudo docker exec vim-emu vim-emu datacenter list
sudo docker exec vim-emu vim-emu compute list

- Check OSM and vim-emu:
osm-check-osm
osm-check-vimemu


References
----------
- OSM Release FIVE. https://osm.etsi.org/wikipub/index.php/OSM_Release_SIX
- VIM emulator. https://osm.etsi.org/wikipub/index.php/VIM_emulator