How to install OSM in Amazon EC2: Difference between revisions

From OSM Public Wiki
Jump to: navigation, search
No edit summary
No edit summary
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
''These instructions are oriented to install OSM Release FOUR''
'''THIS PAGE IS DEPRECATED'''. OSM User Guide has been moved to a new location: '''https://osm.etsi.org/docs/user-guide/'''
 
---


= Requirements =
= Requirements =
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-4.0-four/install_osm.sh
  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. Add the following environment variables to the end of your ‘.bashrc’ file and then source it with ‘source .bashrc’:
3. You will notice 10 Docker Containers created on the EC2 instance. Check the status of the containers and Docker service:
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 stack ps osm |grep -i running
  docker service ls
  docker service ls


5. Create the AWS VIM Account (AWS Site)
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}}”}'
            
            
6. Access the OSM Console via the EC2 Instance’s Private IP from another EC2 Instance in the same subnet:
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


7. Deploy/Test a network service by using any of the available VNF and NS packagers from ‘https://osm-download.etsi.org/ftp/osm-3.0-three/2nd-hackfest/packages/’:
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-3.0-three/2nd-hackfest/packages/hackfest_1alt_vnfd.tar.gz
  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-3.0-three/2nd-hackfest/packages/hackfest_1alt_nsd.tar.gz
 
  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:


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
Retrieved from "http:///wikipub/index.php?title=How_to_install_OSM_in_Amazon_EC2&oldid=6088"