How to install OSM in Amazon EC2

2019-01-07T10:07:51Z

Sam1973:

= Requirements =

'''Resources:'''
* MINIMUM: 2 CPUs, 4 GB RAM, 20GB disk and a single interface with Internet access
* RECOMMENDED: 2 CPUs, 8 GB RAM, 40GB disk and a single interface with Internet access

'''Instance Type/AMI:'''
* Recommended Instance Type: m5.xlarge (https://aws.amazon.com/ec2/instance-types/)
* Ubuntu 16.04 (64-bit variant required) as base AMI (http://releases.ubuntu.com/16.04/)
* Ubuntu AMI’s: https://cloud-images.ubuntu.com/locator/ec2/
* Launching an EC2 instance: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html#ec2-launch-instance

'''''The following installation steps assume that you already have an EC2 instance launched which meets the minimum requirements mentioned above.'''''

= OSM Installation =

1. Install OSM and save installation logs to a file for troubleshooting if needed:

wget https://osm-download.etsi.org/ftp/osm-5.0-five/install_osm.sh
chmod +x install_osm.sh
./install_osm.sh 2>&1 | tee osm_install_log.txt

2. Answer the following dialog box questions accordingly:

* The installation will configure LXD, install juju, install docker CE and init a docker swarm, as pre-requirements. Do you want to proceed (Y/n)? Y
* Do you want to configure the LXD bridge? Yes
* Do you want to setup an IPv4 subnet? Yes
* ''<< '''Default values''' apply for next questions >>''
* Do you want to setup an IPv6 subnet? No

3. Add the following environment variables to the end of your ‘.bashrc’ file and then source it with ‘source .bashrc’:
export OSM_HOSTNAME=127.0.0.1
export OSM_SOL005=True

4. You will notice 10 Docker Containers created on the EC2 instance. Check the status of the containers and Docker service:
docker stack ps osm |grep -i running
docker service ls

5. Create the AWS VIM Account (AWS Site)

NOTE: Make sure to select the region in which your EC2 instance resides.

osm vim-create --name aws-site --user <aws-access-key> --password <aws-secret-key> --auth_url https://aws.amazon.com --tenant admin --account_type aws --config '{region_name: us-west-2, flavor_info: “{t2.nano: {cpus: 1, disk: 100, ram: 512}, t2.micro: {cpus: 1, disk: 100, ram: 1024}, t2.small: {cpus: 1, disk: 100, ram: 2048}, m1.small: {cpus: 1, disk: 160, ram: 1741}}”}'

6. Access the OSM Console via the EC2 Instance’s Private IP from another EC2 Instance in the same subnet:

NOTE: You can use a Windows instance to easily access the OSM Console.
Launching an EC2 Windows Instance:
https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2_GetStarted.html#ec2-launch-instance

http://1.2.3.4
username: admin
password: admin

7. Deploy/Test a network service by using any of the available VNF and NS packagers from ‘https://osm-download.etsi.org/ftp/osm-4.0-four/3rd-hackfest/packages/’:
wget https://osm-download.etsi.org/ftp/osm-4.0-four/3rd-hackfest/packages/hackfest_1alt_nsd.tar.gz
wget https://osm-download.etsi.org/ftp/osm-4.0-four/3rd-hackfest/packages/hackfest_1alt_vnfd.tar.gz

osm vnfd-create hackfest_1alt_vnfd.tar.gz
osm nsd-create hackfest_1alt_nsd.tar.gz
osm ns-create --ns_name hackfest1alt --nsd_name hackfest1alt-ns --vim_account aws-site --ssh_keys <PUBKEY_FILE> --config '{vld: [ {name: mgmtnet, vim-network-name: subnet-xxxxxxx} ] }'
osm ns-list
osm ns-show hackfest1alt

5th OSM Hackfest

2018-12-20T08:52:01Z

Sam1973:

[[File:bcn.jpg|750px|center|top]]

= Overview =
[[File:5hackdate.png|350px|right|top|link=https://portal.etsi.org/webapp/MeetingCalendar/MeetingDetails.asp?m_id=35467]]

ETSI's Centre for Testing and Interoperability and the OSM community are organizing the 5th OSM Hackfest on 4-8 February 2019.

The event will be hosted by '''[http://www.cttc.es/about-cttc/location-and-contact/ CTTC]''' in Castelldefels (Barcelona), co-located with the '''[http://portal.etsi.org/webapp/MeetingCalendar/MeetingDetails.asp?m_id=34951 OSM Mid-Release SIX]''' meeting and a [https://5gtango.eu/news/55-joint-sonata-and-osm-hackfest-barcelona-4-8-february-2019.html '''SonataNFV''' Hackfest], offering a great opportunity to share and learn with OSM developers and module leaders, and explore further opportunities for synergy and collaboration with 5G research activities.

Participation to OSM Hackfests is free and open to all upon '''[https://portal.etsi.org/webapp/MeetingCalendar/MeetingDetails.asp?m_id=35467 registration]'''

== Venue ==
'''Centre Tecnològic de Telecomunicacions de Catalunya - [http://www.cttc.es/about-cttc/location-and-contact/ CTTC]'''

Parc Mediterrani de la Tecnologia (PMT) - Building B4

Av. Carl Friedrich Gauss 7

08860 - Castelldefels (Barcelona) - Spain

= Scope =
This OSM Hackfest will allow new users to get familiar with '''OSM Release FIVE''' and exercise all the main functionalities, from basic operations (installation, setup, common operations, etc.) to most advanced activities, with a big focus on VNF on-boarding activities covering Day 0/1/2 operations.

In addition, experienced users and developers will have the opportunity to hack into OSM, build complex examples, fine-tune, test and demonstrate experimental features on the OSM Remote Labs network.

[[File:OSM_community_paloalto.jpg|800px|center]]

= Objectives =
OSM Hackfest participants will learn to
* Install OSM and run some examples
* Get familiar with OSM's GUI and CLI
* Create own VNF and NS descriptors and build packages
* Model and deploy NS/VNF with EPA capabilities
* Model dynamic Life Cycle Management operations with Day-1 and Day-2 actions
* Perform basic troubleshooting
* Configure Fault and Performance management and close-loop operations
* Modify and experiment with OSM source code
* Build complex examples and run own experimental testing

= Who should attend =
* 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
* Experimented developers and users that want to share and test with the community

[[File:OSM_hack.jpg|800px|center]]

= Prerequisites =
* Seats are limited, [https://portal.etsi.org/webapp/MeetingCalendar/MeetingDetails.asp?m_id=35467 registration] is mandatory
* Participants are expected to have user-level knowledge of Linux and be familiar with NFV and SDN concepts
* Laptop / VM in laptop
** Linux installed (preferred, Ubuntu 16.04)
** RECOMMENDED: 2 CPUs, 8 GB RAM, 20GB disk
* It is highly recommended that you '''download and install OSM Rel FIVE before the hackfest'''.
** See [https://osm.etsi.org/wikipub/index.php/How_to_run_OSM_on_Vagrant how to download and install OSM from Vagrant on your computer].

= Agenda =

* '''Session 0: Introduction to NFV and OSM'''
* '''Session 1: OSM Installation and first use'''
** OSM installation (Release FIVE)
** OSM user experience from the GUI
** OSM user experience from the CLI
* '''Session 2: Creating a basic VNF and NS'''
* '''Session 3: Modeling multi-VDU VNF'''
* '''Session 4: Adding day-0 configuration to your VNF'''
* '''Session 5: Modeling EPA capabilities in your VNF descriptor'''
* '''Session 6: Adding day-1/day-2 configuration to your VNF.'''
** Creating a charm for your VNF
** VNF primitives
* '''Session 7: OSM Fault & Performance Management'''
** Collecting and visualizing metrics from VNFs
** Collecting, visualizing and reacting to events from VNFs
* '''Session 8: 5G Network Slicing with OSM'''
* '''Session 9: Service Function Chaining'''
* '''Session 10: Contributing to OSM'''
* '''Freestyle Experimental Sessions'''
* '''SonataNFV dedicated Sessions'''



= Previous Hackfests material =
* [[4th OSM Hackfest | 4th OSM Hackfest Wiki]]
* [[3rd OSM Hackfest | 3rd OSM Hackfest Wiki]]
* [[2nd OSM Hackfest | 2nd OSM Hackfest Wiki]]
* [[1st OSM Hackfest | 1st OSM Hackfest Wiki]]

= Get involved =
* Join the [https://join.slack.com/t/opensourcemano/shared_invite/enQtMzQ3MzYzNTQ0NDIyLWJkMzRjNDM0MjFjODYzMGQ3ODIzMzJlNTg2ZGI5OTdiZjFiNDMyMzYxMjRjNDU4N2FmNjRjNzY5NTE1MjgzOTQ OSM Community Slack Workspace]
* If your organisation is already an [https://portal.etsi.org/TBSiteMap/OSM/ListofOSMMembers.aspx OSM member], you can also:
** [https://webapp.etsi.org/createaccount/ Request an EOL account] (if you don’t have one yet)
** Subscribe [https://list.etsi.org/scripts/wa.exe?SUBED1=OSG_OSM&A=1 OSM general] and [https://list.etsi.org/scripts/wa.exe?SUBED1=OSM_TECH&A=1 OSM TECH] mailing lists
* If your organisation is not yet an OSM member:
** Learn [https://osm.etsi.org/about/how-to-join how to join], it is free and open to all
* Join the [https://osm.etsi.org/wikipub/index.php/OSM_Ecosystem OSM Ecosystem]

= Contact =
Please send your technical questions to [mailto:OSM_TECH@list.etsi.org OSM_TECH@list.etsi.org] or join the [https://join.slack.com/t/opensourcemano/shared_invite/enQtMzQ3MzYzNTQ0NDIyLWJkMzRjNDM0MjFjODYzMGQ3ODIzMzJlNTg2ZGI5OTdiZjFiNDMyMzYxMjRjNDU4N2FmNjRjNzY5NTE1MjgzOTQ OSM Community Slack Workspace]

Questions about ETSI, joining OSM, this hackfest and future events can be sent to: [mailto:OSMSupport@etsi.org OSMSupport@etsi.org]

OSM Public Wiki - User contributions [en]

How to install OSM in Amazon EC2

5th OSM Hackfest