How to install OSM in Amazon EC2: Difference between revisions
From OSM Public Wiki
No edit summary |
Ramonsalguer (talk | contribs) No edit summary |
||
| (10 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
'' | '''THIS PAGE IS DEPRECATED'''. OSM User Guide has been moved to a new location: '''https://osm.etsi.org/docs/user-guide/''' | ||
--- | |||
= Requirements = | = Requirements = | ||
| Line 6: | Line 8: | ||
* MINIMUM: 2 CPUs, 4 GB RAM, 20GB disk and a single interface with Internet access | * 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 | * RECOMMENDED: 2 CPUs, 8 GB RAM, 40GB disk and a single interface with Internet access | ||
''' | |||
Instance Type/AMI:''' | '''Instance Type/AMI:''' | ||
* Recommended Instance Type: m5.xlarge (https://aws.amazon.com/ec2/instance-types/) | * 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 16.04 (64-bit variant required) as base AMI (http://releases.ubuntu.com/16.04/) | ||
| Line 21: | Line 23: | ||
1. Install OSM and save installation logs to a file for troubleshooting if needed: | 1. Install OSM and save installation logs to a file for troubleshooting if needed: | ||
wget https://osm-download.etsi.org/ftp/osm- | wget https://osm-download.etsi.org/ftp/osm-6.0-six/install_osm.sh | ||
chmod +x install_osm.sh | chmod +x install_osm.sh | ||
./install_osm.sh 2>&1 | tee osm_install_log.txt | ./install_osm.sh 2>&1 | tee osm_install_log.txt | ||
| Line 33: | Line 35: | ||
* Do you want to setup an IPv6 subnet? No | * Do you want to setup an IPv6 subnet? No | ||
3 | 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 stack ps osm |grep -i running | ||
docker service ls | docker service ls | ||
4. Create the AWS VIM Account (AWS Site) | |||
NOTE: Make sure to select the region in which your EC2 instance resides. | NOTE: Make sure to select the region in which your EC2 instance resides. | ||
| Line 47: | Line 45: | ||
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}}”}' | 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. | NOTE: You can use a Windows instance to easily access the OSM Console. | ||
Launching an EC2 Windows Instance: | Launching an EC2 Windows Instance: | ||
https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2_GetStarted.html#ec2-launch-instance | https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2_GetStarted.html#ec2-launch-instance | ||
http://1.2.3.4 | http://1.2.3.4 | ||
| Line 58: | Line 55: | ||
password: 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- | wget https://osm-download.etsi.org/ftp/osm-4.0-four/3rd-hackfest/packages/hackfest_1alt_vnfd.tar.gz | ||
wget https://osm-download.etsi.org/ftp/osm- | |||
osm vnfd-create hackfest_1alt_vnfd.tar.gz | osm vnfd-create hackfest_1alt_vnfd.tar.gz | ||
osm nsd-create hackfest_1alt_nsd.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-create --ns_name hackfest1alt --nsd_name hackfest1alt-ns --vim_account aws-site | |||
osm ns-list | osm ns-list | ||
osm ns-show hackfest1alt | osm ns-show hackfest1alt | ||
Latest revision as of 16:56, 17 February 2021
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