1st OSM Hackfest: Difference between revisions

From OSM Public Wiki
Jump to: navigation, search
No edit summary
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[File:Hack.png|400px|right|top|link=https://portal.etsi.org/webapp/MeetingCalendar/MeetingDetails.asp?m_id=33758]]


= Overview =
= Overview =
ETSI's Centre for Testing and Interoperability and the OSM community are organising the 1st OSM Hackfest on 15-19 January 2018.  
[[File:hackdate.png|400px|right|top|link=https://portal.etsi.org/webapp/MeetingCalendar/MeetingDetails.asp?m_id=33758]]
ETSI's Centre for Testing and Interoperability and the OSM community organised the 1st OSM Hackfest on 15-19 January 2018. The event was hosted in '''[http://www.etsi.org/about/getting-to-etsi ETSI]''''s headquarters in Sophia Antipolis, France and co-located with the '''[http://www.etsi.org/news-events/events/1207-2nd-nfv-plugtests Second NFV Plugtests event]'''


The event will be hosted in '''[http://www.etsi.org/about/getting-to-etsi ETSI]''''s headquarters in Sophia Antipolis, France and co-located with the '''[http://www.etsi.org/news-events/events/1207-2nd-nfv-plugtests Second NFV Plugtests event]'''
Participation to OSM Hackfests is free and open to all.


Participation is free and open to all. '''[https://portal.etsi.org/webapp/MeetingCalendar/MeetingDetails.asp?m_id=33758 Registration]'''  deadline is 5th January 2018
[[File:OSM_community.jpg|800px|center]]
 
The hackfest will start on monday the 15th at 2pm and end friday the 19th at 1pm.


= Scope =
= Scope =
The 1st OSM Hackfest will concentrate on VNF on-boarding activities covering Day 0/1/2 operations.
The 1st OSM Hackfest concentrated on VNF on-boarding activities covering Day 0/1/2 operations.


It will address complex descriptor development to leverage the full suite of capabilities offered by '''[https://osm.etsi.org/images/OSM-Whitepaper-TechContent-ReleaseTHREE-FINAL.PDF OSM Release THREE]''', from service and resource orchestration to VNF configuration with charm development.
It addressed complex descriptor development to leverage the full suite of capabilities offered by '''[https://osm.etsi.org/images/OSM-Whitepaper-TechContent-ReleaseTHREE-FINAL.PDF OSM Release THREE]''', from service and resource orchestration to VNF configuration with charm development.


= Objectives =
= Objectives =
[[File:OSM_hands_on.jpg|500px|right|top]]
* Install OSM and run some examples
* Install OSM and run some examples
* Get familiar with OSM's GUI and CLI
* Get familiar with OSM's GUI and CLI
Line 24: Line 20:
* Learn how to add dynamic LCM with Day-1 and Day-2 actions with charms
* Learn how to add dynamic LCM with Day-1 and Day-2 actions with charms
* Basic troubleshooting
* Basic troubleshooting
** Special attention will be paid to troubleshoot real cases from co-located NFV Plugtests.
** Special attention to be paid to troubleshoot real cases from co-located NFV Plugtests.
 
Do you have some specific topics that you would like to see covered during the Hackfest? Please reach us at [mailto:OSM_TECH@list.etsi.org OSM_TECH@list.etsi.org]


= Who should attend =
= Who attended =
* VNF vendors, who want to onboard their VNF in OSM following best practices
* VNF vendors, who want to onboard their VNF in OSM following best practices
* System Integrators, who want to get used with OSM
* System Integrators, who want to get used with OSM
Line 34: Line 28:
* Academia and Universities, who are considering OSM as platform for their research activities in networking
* Academia and Universities, who are considering OSM as platform for their research activities in networking


And, of course, participants in 2nd NFV Plugtests who might have specific demands of troubleshooting for their VNF descriptors or Infrastructure
And, of course, participants in 2nd NFV Plugtests who had specific demands of troubleshooting for their VNF descriptors or Infrastructure
 
[[File:OSM_hack.jpg|800px|center]]


= Prerequisites =
= Prerequisites =


'''ABSOLUTELY NEEDED:'''
'''ABSOLUTELY NEEDED:'''
[[File:OSM_workshop.jpg|500px|right|top]]
 
* Please, '''[https://portal.etsi.org/webapp/MeetingCalendar/MeetingDetails.asp?m_id=33758 register in advance]''' to help us size the event properly.
* Please, '''register in advance''' to help us size the event properly.
* Laptop / VM in laptop
* Laptop / VM in laptop
** Linux installed (preferred, Ubuntu 16.04)
** Linux installed (preferred, Ubuntu 16.04)
Line 62: Line 58:


= Agenda =
= Agenda =
[[File:schema.png|500px|right|top]]
[[File:schema.png|450px|right|top]]
 
===Monday, 15th Jan 2018 (afternoon)===
===Monday, 15th Jan 2018 (afternoon)===
* '''OSM 101'''
* '''OSM 101'''
** OSM introduction   
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180115%20OSM%20Hackfest%20-%20Welcome.pdf Welcome]
** OSM installation (Release THREE)  
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180115%20OSM%20Hackfest%20-%20Introduction%20to%20OSM.pdf Introduction to OSM]
** OSM user experience from the UI     
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180115%20OSM%20Hackfest%20-%20Installation%20and%20first%20use.pdf Installation and first use]
** OSM user experience from the client     
*** OSM installation (Release THREE)
*** OSM user experience from the UI     
*** OSM user experience from the client     
 
 
 
 
===Tuesday, 16th Jan 2018 ===
===Tuesday, 16th Jan 2018 ===
* '''Session 1: Creating a basic VNF and NS'''
* '''Session 1: Creating a basic VNF and NS'''
** Tutorial. Creating descriptors and packages (simple VNF - single VM, no EPA, no charms)    
** Tutorial. Creating descriptors and packages (simple VNF - single VM, no EPA, no charms)
** Tutorial. Troubleshooting with VNF and NS descriptors   
*** Presentation: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180116%20OSM%20Hackfest%20-%20Session%201%20-%20Creating%20a%20basic%20VNF%20and%20NS.pdf Session 1. Creating a basic VNF and NS]
** Hands-on session.  
*** VNF and NS packages: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_1_vnfd.tar.gz hackfest1-vnf],[https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_1_nsd.tar.gz hackfest1-ns]
** Hands-on session.
* '''Session 2: Modeling multi-VDU VNF'''
* '''Session 2: Modeling multi-VDU VNF'''
** Tutorial. Creating descriptors and packages (complex VNF - multi-VDU)
** Tutorial. Creating descriptors and packages (complex VNF - multi-VDU)
*** Presentation: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180116%20OSM%20Hackfest%20-%20Session%202%20-%20Modeling%20multi-VDU%20VNF.pdf Session 2. Modeling multi-VDU VNF]
*** VNF and NS packages: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_2_vnfd.tar.gz hackfest2-vnf],[https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_2_nsd.tar.gz hackfest2-ns]
** Hands-on session.     
** Hands-on session.     
===Wednesday, 17th Jan 2018 ===
===Wednesday, 17th Jan 2018 ===
* '''Free-style session for VNF builders (along the day)'''
* '''Free-style session for VNF builders (along the day)'''
** Tutorial. Guidelines for VNF builders
** Tutorial. Guidelines for VNF builders
*** Presentation: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180117%20OSM%20Hackfest%20-%20Guidelines%20for%20VNF%20builders.pdf Guidelines for VNF builders]
** Hands-on session: resolution of doubts and testing instantiation.
** Hands-on session: resolution of doubts and testing instantiation.
* '''Session 3: Adding day-0 configuration to your VNF'''
* '''Session 3: Adding day-0 configuration to your VNF'''
** Tutorial. Creating descriptors and packages (complex VNF - multi-VDU, day-0 config via cloud-init, no charms yet)
** Tutorial. Creating descriptors and packages (complex VNF - multi-VDU, day-0 config via cloud-init, no charms yet)
*** Presentation: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180117%20OSM%20Hackfest%20-%20Session%203%20-%20Adding%20day-0%20configuration%20to%20VNFs.pdf Session 3. Adding day-0 configuration to your VNF]
*** VNF and NS packages: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_3_vnfd.tar.gz hackfest3-vnf],[https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_3_nsd.tar.gz hackfest3-ns]
** Hands-on session.
** Hands-on session.
* '''Pre-session 5:'''
* '''Pre-session 5:'''
** Tutorial. Pre-session 5: how to generate VNF package from command line; charms and VNF primitives in OSM
** Tutorial. Pre-session 5: how to generate VNF package from command line; charms and VNF primitives in OSM
*** Presentation: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180117%20OSM%20Hackfest%20-%20Pre-session%205%20-%20VNF%20package%20generation%20from%20command%20line%20and%20introduction%20to%20charms%20and%20VNF%20primitives.pdf Pre-session 5. How to generate VNF package from command line + Charms and VNF primitives in OSM]
* '''Session 5: Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF'''
* '''Session 5: Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF'''
** Tutorial. Creating a charm for a VNF (SSH access, execution of a command, getting the output of that command)
** Tutorial. Creating a charm for a VNF (SSH access, execution of a command, getting the output of that command)
*** Presentation: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180117%20OSM%20Hackfest%20-%20Session%205%20-%20Adding%20day-1%20and%20day-2%20configuration%20to%20your%20VNF%20-%20Creating%20your%20first%20proxy%20charm.pdf Session 5. Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF]
*** VNF and NS packages: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_3charmed_vnfd.tar.gz hackfest3charmed-vnf],[https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_3charmed_nsd.tar.gz hackfest3charmed-ns]
** Hands-on session
** Hands-on session


Line 93: Line 105:
* '''Session 4: Modeling EPA capabilities in your VNF descriptor'''
* '''Session 4: Modeling EPA capabilities in your VNF descriptor'''
** Tutorial. Creating descriptors and packages (complex VNF - multi-VDU, day-0 config via cloud-init, EPA, no charms yet)
** Tutorial. Creating descriptors and packages (complex VNF - multi-VDU, day-0 config via cloud-init, EPA, no charms yet)
*** Presentation: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180118%20OSM%20Hackfest%20-%20Session%204%20-%20Modeling%20EPA%20capabilities%20in%20VNF.pdf Session 4. Modeling EPA capabilities in your VNF descriptor]
*** VNF and NS packages: [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_4_vnfd.tar.gz hackfest4-vnf],[https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/packages/hackfest_4_nsd.tar.gz hackfest4-ns]
** Hands-on session.
** Hands-on session.
* '''Session 5: Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF (cont.)'''
* '''Session 5: Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF (cont.)'''
Line 100: Line 114:
===Friday, 19th Jan 2018 (morning)===
===Friday, 19th Jan 2018 (morning)===
* '''Session 5: Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF (cont.)'''
* '''Session 5: Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF (cont.)'''
**Hands-on session.
** Hands-on session.
* '''Recap'''
* '''Session 4: Modeling EPA capabilities in your VNF descriptor (cont.)'''
** Hands-on session.
* '''[https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180119%20OSM%20Hackfest%20-%20Closing%20session.%20Recap.pdf Closing session. Recap]'''


'''Note: Some time will be accommodated every day to troubleshoot issues with OSM that could be raised during the co-located NFV Plugtests.'''
'''Note: Some time will be accommodated every day to troubleshoot issues with OSM that could be raised during the co-located NFV Plugtests.'''
Line 107: Line 123:
<googlespreadsheet style="width:810px; height:450px">1N5YzZNhXxqNu0DCR_aN4yKnfyGjehCE_goX2N1jiAgw</googlespreadsheet>
<googlespreadsheet style="width:810px; height:450px">1N5YzZNhXxqNu0DCR_aN4yKnfyGjehCE_goX2N1jiAgw</googlespreadsheet>


= Relevant links =
= Hackfest material =
* '''Presentations''':
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180115%20OSM%20Hackfest%20-%20Welcome.pdf Welcome]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180115%20OSM%20Hackfest%20-%20Introduction%20to%20OSM.pdf Introduction to OSM]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180115%20OSM%20Hackfest%20-%20Installation%20and%20first%20use.pdf Installation and first use]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180116%20OSM%20Hackfest%20-%20Session%201%20-%20Creating%20a%20basic%20VNF%20and%20NS.pdf Session 1. Creating a basic VNF and NS]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180116%20OSM%20Hackfest%20-%20Session%202%20-%20Modeling%20multi-VDU%20VNF.pdf Session 2. Modeling multi-VDU VNF]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180117%20OSM%20Hackfest%20-%20Session%203%20-%20Adding%20day-0%20configuration%20to%20VNFs.pdf Session 3. Adding day-0 configuration to your VNF]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180118%20OSM%20Hackfest%20-%20Session%204%20-%20Modeling%20EPA%20capabilities%20in%20VNF.pdf Session 4. Modeling EPA capabilities in your VNF descriptor]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180117%20OSM%20Hackfest%20-%20Pre-session%205%20-%20VNF%20package%20generation%20from%20command%20line%20and%20introduction%20to%20charms%20and%20VNF%20primitives.pdf Pre-session 5. VNF package generation from command line + Intro to charms and VNF primitives in OSM]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180117%20OSM%20Hackfest%20-%20Session%205%20-%20Adding%20day-1%20and%20day-2%20configuration%20to%20your%20VNF%20-%20Creating%20your%20first%20proxy%20charm.pdf Session 5. Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180117%20OSM%20Hackfest%20-%20Guidelines%20for%20VNF%20builders.pdf Guidelines for VNF builders]
** [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/presentations/20180119%20OSM%20Hackfest%20-%20Closing%20session.%20Recap.pdf Closing session. Recap]
* '''All the material (images, presentations and VNF and NS packages) have been stored in [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/ this FTP folder]'''
* Interactive minutes have been captured in this [https://pad.etsi.org/p/OSM_Hackfest_2018 pad]
* Interactive minutes have been captured in this [https://pad.etsi.org/p/OSM_Hackfest_2018 pad]
* Presentations:
** Welcome
** Introduction to OSM
** Installation and first use
** Session 1. Creating a basic VNF and NS
** Session 2. Modeling multi-VDU VNF
** Session 3. Adding day-0 configuration to your VNF
** Session 4. Modeling EPA capabilities in your VNF descriptor
** Pre-session 5
** Session 5. Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF
** Guidelines for VNF builders
** Closing session. Recap
* All the material (images, presentations and VNF and NS packages) have been stored in [https://osm-download.etsi.org/ftp/osm-3.0-three/1st-hackfest/ this FTP folder]


= Contact =
= Contact =
Should you have any question on the OSM Hackfest, please contacts us at [mailto:OSMSupport@etsi.org OSMSupport@etsi.org]


Technical questions on OSM can be sent to [mailto:OSM_TECH@list.etsi.org OSM_TECH@list.etsi.org]
Please send your technical questions to [mailto:OSM_TECH@list.etsi.org OSM_TECH@list.etsi.org]
 
Questions about ETSI, joining OSM, and future events can be sent to: [mailto:OSMSupport@etsi.org OSMSupport@etsi.org]

Latest revision as of 10:52, 14 February 2018

Overview

Hackdate.png

ETSI's Centre for Testing and Interoperability and the OSM community organised the 1st OSM Hackfest on 15-19 January 2018. The event was hosted in ETSI's headquarters in Sophia Antipolis, France and co-located with the Second NFV Plugtests event

Participation to OSM Hackfests is free and open to all.

OSM community.jpg

Scope

The 1st OSM Hackfest concentrated on VNF on-boarding activities covering Day 0/1/2 operations.

It addressed complex descriptor development to leverage the full suite of capabilities offered by OSM Release THREE, from service and resource orchestration to VNF configuration with charm development.

Objectives

  • Install OSM and run some examples
  • Get familiar with OSM's GUI and CLI
  • Create your own VNF and NS descriptors and build packages
  • Understand how to deploy NS/VNF with EPA
  • Learn how to add dynamic LCM with Day-1 and Day-2 actions with charms
  • Basic troubleshooting
    • Special attention to be paid to troubleshoot real cases from co-located NFV Plugtests.

Who attended

  • VNF vendors, who want to onboard their VNF in OSM following best practices
  • System Integrators, who want to get used with OSM
  • Service providers, who want to get first hand operational experience with OSM
  • Academia and Universities, who are considering OSM as platform for their research activities in networking

And, of course, participants in 2nd NFV Plugtests who had specific demands of troubleshooting for their VNF descriptors or Infrastructure

OSM hack.jpg

Prerequisites

ABSOLUTELY NEEDED:

  • Please, register in advance to help us size the event properly.
  • Laptop / VM in laptop
    • Linux installed (preferred, Ubuntu 16.04)
  • User-level knowledge of Linux
  • Familiarity with NFV and SDN concepts


FOR OPTIMAL USE OF THE SESSION:

  • Laptop / VM in laptop:
    • MINIMUM: 4 CPUs, 8 GB RAM, 40GB disk
    • RECOMMENDED: 8 CPUs, 16 GB RAM, 80GB disk
    • Ubuntu 16.04
  • Bring your own VNF
    • Basic knowledge of:
      • Its internal structure (picture is recommended) and resource requirements, as in these examples
      • How to change/adapt its configuration
      • Other known restrictions/limitations
    • VM images available
  • Participating in the NFV Plugtests

Agenda

Schema.png

Monday, 15th Jan 2018 (afternoon)



Tuesday, 16th Jan 2018

Wednesday, 17th Jan 2018

Thursday, 18th Jan 2018

  • Session 4: Modeling EPA capabilities in your VNF descriptor
  • Session 5: Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF (cont.)
    • Tutorial. Troubleshooting charms
    • Hands-on session

Friday, 19th Jan 2018 (morning)

  • Session 5: Adding day-1/day-2 configuration to your VNF. Creating a charm for your VNF (cont.)
    • Hands-on session.
  • Session 4: Modeling EPA capabilities in your VNF descriptor (cont.)
    • Hands-on session.
  • Closing session. Recap

Note: Some time will be accommodated every day to troubleshoot issues with OSM that could be raised during the co-located NFV Plugtests.

Hackfest material

Contact

Please send your technical questions to OSM_TECH@list.etsi.org

Questions about ETSI, joining OSM, and future events can be sent to: OSMSupport@etsi.org