View source for How to install OSM in Amazon EC2

'''THIS PAGE IS DEPRECATED'''. OSM User Guide has been moved to a new location: '''https://osm.etsi.org/docs/user-guide/'''

---

= 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-6.0-six/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.	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

4.	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}}”}'
  	        
5.	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

6.	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