Actions

ProSBC:Cloud:AWS Installation


This page is intended to give assistance to people launching an instance of ProSBC using an Amazon Machine Image (AMI) on Amazon Web Service (AWS).
NOTE The old installation guide is here: AWS installation

Instantiate a ProSBC

  • After logging in your Amazon account, click on “EC2” in the main AWS console:
AWS Management Console 2022-07-28 16-27-37.png


  • Be sure you are in the correct region, on the left menu click on “AMIs” and select “Private image” to locate FreeSBC/ProSBC AMI:
AWS EC2 AMIs.png


  • Launch the FreeSBC/ProSBC image.
EC2 launch AMI.png


  • Name the instance and add any necessary tag
EC2-AMI Launch.png


  • Select the instance type and its resources. The recommended instance type is:
    • m5.large (2 vCPU, 8 GiB)
  • Supported instance type are:
  • This is the list of approximate performances for different AWS instance types. Results may vary according to configuration.
EC2 Instance AWS CPU cores Calls per second (cps) Sessions with RTP anchoring Sessions with Media bypass

m5.large

2

50

400

32,000

m5.xlarge

4

215

750

60,000

c4.xlarge

4

215

750

60,000

c4.2xlarge

8

575

2,000

60,000

m5.4xlarge

16

650

4,000

60,000

m5.12xlarge

48

650

4,800

60,000


EC2 AMI CPU.png


  • For later access to the FreeSBC/ProSBC SSH console you will need to select a Key Pair to secure the login. You can also create a new Key Pair in case you need.
EC2 AWS Key pair.png


  • In "Networking Settings" select "Create security group". We recommend that you simply open "All Traffic" on your own IP addresses to whitelist it in AWS firewall on "Source", once all your IPs are listed click on "Add security group rule": (note that the SBC contains its own internal firewall)
EC2 AMI Network.png
  • In "Configure Storage" change the Volume Size to 40Gb and select volume type to GP2.
EC2 AMI Storage.png
  • Finally review the summary of your instance and start the creation process clicking on "Launch Instance". Be aware, from this moment you will be billed by Amazon for the instance resources:
EC2 AMI Launch.png
  • You should receive the confirmation of the launching process, this process will take some minutes until the instance is available, You can view your instance clicking on “View Instances”:
EC2 AMI Confirmation.png
  • After a few minutes your instance should be running and available to be configured:
EC2 AMI Instances.png


Optional: Elastic IP Creation section

  • AWS will automatically provide and allocate a dynamic public IP to your instance, this will allow you to access from the IPs you whitelisted before to the Public IP allocated to your instance. For ProSBC servers the purpose is to interact with other SIP elements as part of a VoIP cloud telecom infrastructure, TelcoBridges strongly recommends associating an Elastic IP to your instance, which is, in short, to associate a fixed public IP to your SBC. For more information about how to associate an Elastic IP to your instance please check the official documentation in AWS here.

Enable SR-IOV enhanced networking

By default M5 instances have enhanced networking enabled. If you want to use any other instance, like m4 type instance, you need to check if enahnced networking is enabled or not.

It is very important to enable "enhanced networking" for tbrouter to have access to the network devices on the VM.

This must be done before completing the initial web portal configuration. Please shut down the instance before entering the serial number and all other information and set SR-IOV

There are two types of enhanced networking, we need the second one.

1) Elastic Network Adapter (ENA)

2) Intel 82599 Virtual Function (VF) interface

Install the AWS CLI

https://aws.amazon.com/cli/

Get security credentials for the command line

On the AWS web portal, click on your account name and choose "My Security Credentials"

Expand the "Access keys" section

Create a new key, you will need the AWSAccessKeyId and AWSSecretKey

Open a CLI and execute the aws cli commands

 aws configure

Paste the access key ID and key that you previously obtained along with your default region.

Show if the enhanced networking is enabled

Make sure to replace the example instance ID with your own AWS instance ID

 aws ec2 describe-instance-attribute --instance-id i-0123456789abcdef1 --attribute sriovNetSupport

Enabled:

 {
     "InstanceId": "i-0123456789abcdef1",
     "SriovNetSupport": {
         "Value": "simple"
     }
 }

Not enabled:

 {
     "InstanceId": "i-0123456789abcdef1",
     "SriovNetSupport": {}
 }

To enable the sriov enhanced networking, first turn off the instance then do:

 aws ec2 modify-instance-attribute --instance-id i-0123456789abcdef1  --sriov-net-support simple

Accessing the ProSBC

Accessing the ProSBC web portal

  • Open a web browser to the management IP of the ProSBC, on port 12358. Example if your Instance public IP address is 35.183.126.193, the URL would be:
    http://35.183.126.193:12358


You should get to the ProSBC Configuration Wizard
AWS TSBC WebPortal Configuration wizard.jpg


Take note that it may take a while for the ProSBC system to make the Web Portal available (around 3-5 minutes).

Installing AWS Instance with CloudFormation Template

AWS CloudFormation is a service that helps you model and set up your AWS resources so that you can spend less time managing those resources and more time focusing on your applications that run in AWS. Telcobridge created a CloudFormation template to reduce the time spent on ProSBC AWS installation. Click on the following link to the ProSBC CloudFormation installation: ProSBCAWS CloudFormation Installation

Upgrading the instance type

You can upgrade the instance type in AWS based on your requirements. Click on the following link for instance type upgrade ProSBC AWS Intance Upgrade

Adding more interfaces to ProSBC in AWS

You can add more interfaces to ProSBC in AWS based on your requirements. Click on the following link for how to add an interface ProSBC AWS Additional Interface

Web Portal Initial Configuration

Click on the following link to pursue installation from the web portal: ProSBC Initial Configuration

Troubleshooting

External References