# AWS Installation

### Instantiate a ProSBC

* After logging in your Amazon account, click on “EC2” in the main AWS console:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/9/96/ConsoleEC2.png/600px-ConsoleEC2.png" alt=""><figcaption></figcaption></figure>

* On the left menu, click on “AMIs”:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/9/95/AMIs.png/100px-AMIs.png" alt=""><figcaption></figcaption></figure>

* Click on the filter drop list and select “Private image” to locate ProSBC AMI:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/9/94/PrivateImages.png/500px-PrivateImages.png" alt=""><figcaption></figcaption></figure>

* Select the region matching the region of the ProSBC AMI you want to test. If you don't know it, try "Canada (Central)".

<figure><img src="https://docs.telcobridges.com/w/images/thumb/d/d3/RegionAMI.png/700px-RegionAMI.png" alt=""><figcaption></figcaption></figure>

* Select the image and click “Launch”:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/f/fa/SelectAMI.png/700px-SelectAMI.png" alt=""><figcaption></figcaption></figure>

<br>

* Select the instance type and its resources.&#x20;

  The smallest instance type is:

  * m5.large (2 vCPU, 8 GiB)

  The recommended instance type is:

  * m5.xlarge (4 vCPU, 16 GiB)
* Supported instance types are:
  * C3, C4, D2, I2, and R3 instances ([Supported instances from Amazon documentation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enhanced-networking.html))
* This is the list of approximate performances for different AWS instance types. Results may vary according to configuration.

<table><thead><tr><th width="148">EC2 Instance</th><th width="145">AWS CPU cores</th><th width="152">Sessions with RTP anchoring</th><th width="271">Sessions with Media bypass</th></tr></thead><tbody><tr><td>m5.large</td><td>2</td><td>400</td><td>32,000</td></tr><tr><td>m5.xlarge</td><td>4</td><td>750</td><td>60,000</td></tr><tr><td>m5.4xlarge</td><td>16</td><td>4,000</td><td>60,000</td></tr><tr><td>m5.120xlarge</td><td>48</td><td>4,800</td><td>60,000</td></tr></tbody></table>

<br>

<figure><img src="https://docs.telcobridges.com/w/images/thumb/9/95/SelectResources.png/800px-SelectResources.png" alt=""><figcaption></figcaption></figure>

<br>

* Click “Add Storage” to proceed to the next page:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/8/8f/ChooseSubnet.png/1000px-ChooseSubnet.png" alt=""><figcaption></figcaption></figure>

<br>

* Change the Volume Size to 40Gb.
* Select "Volume Type": gp2
* Check the box "Delete on Termination"
* Click “Add Tags” to proceed to the next page.

<figure><img src="https://docs.telcobridges.com/w/images/thumb/8/81/NextTag.png/800px-NextTag.png" alt=""><figcaption></figcaption></figure>

<br>

* You can leave the default parameters as they are.
* Click “Configure Security Group” to proceed to the next page:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/f/ff/NextSecurityGroup.png/800px-NextSecurityGroup.png" alt=""><figcaption></figcaption></figure>

* Select "Create a new security group". We recommend that you simply open all ports on your own IP address, since the SBC contains its own internal firewall:

| Rule        | Type        | Port Range | Source IP                |
| ----------- | ----------- | ---------- | ------------------------ |
| All traffic | All traffic | 0 - 65535  | (Use your own public IP) |

<figure><img src="https://docs.telcobridges.com/w/images/thumb/7/71/AddRule.png/600px-AddRule.png" alt=""><figcaption></figcaption></figure>

<br>

* Click “Launch”. Be aware: you will be billed by Amazon for the instance resources:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/6/68/Launch.png/1000px-Launch.png" alt=""><figcaption></figcaption></figure>

<br>

* You will be prompted to create a key pair, allowing you to securely connect to your instance. Select “Create a new key pair” if you do not own one, and give it a name. Then, click on “Download Key Pair” to download a .pem file since it is needed for a SSH connection. (Note: Make sure to not lose it, since you would then lose access the the SSH connection for the instance):

<figure><img src="https://docs.telcobridges.com/w/images/thumb/2/2f/DownloadKey.png/800px-DownloadKey.png" alt=""><figcaption></figcaption></figure>

<br>

* Click on “Launch Instances”:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/b/b3/LaunchWithKey.png/800px-LaunchWithKey.png" alt=""><figcaption></figcaption></figure>

<br>

* You can view your instance by clicking on “View Instances”:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/f/f7/ViewInstance.png/800px-ViewInstance.png" alt=""><figcaption></figcaption></figure>

<br>

* Select the instance you just created and feel free to give it a name:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/b/ba/RenameInstance.png/800px-RenameInstance.png" alt=""><figcaption></figcaption></figure>

#### Optional: Elastic IP Creation section

* If you want to use an associate public IP generated by Amazon (called "Elastic IP"). Click on "Elastic IP" on the left, then click on "Allocate new address":

<figure><img src="https://docs.telcobridges.com/w/images/thumb/8/84/ElasticIP.png/300px-ElasticIP.png" alt=""><figcaption></figcaption></figure>

<br>

* Click on "Allocate IP". A new public IP will be generated by Amazon:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/6/6e/AllocateIP.png/600px-AllocateIP.png" alt=""><figcaption></figcaption></figure>

<br>

* Click on "Close":

<figure><img src="https://docs.telcobridges.com/w/images/thumb/f/f7/NewIP.png/600px-NewIP.png" alt=""><figcaption></figcaption></figure>

#### Optional: Elastic IP association section

* Go to the left pane and click on "Instance". Then select the instance "ProSBC" to display its description:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/1/16/IPforInstance.png/600px-IPforInstance.png" alt=""><figcaption></figcaption></figure>

* Find the eth0 network interface in the instance description:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/3/36/GetTheRightNetworkInterface.png/1100px-GetTheRightNetworkInterface.png" alt=""><figcaption></figcaption></figure>

<br>

* Click on the eth0 Network Interface, then click on the "Interface ID" link:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/4/48/InterfaceID.png/1100px-InterfaceID.png" alt=""><figcaption></figcaption></figure>

<br>

* Right-click on the selected Network Interface, then click "Associate Address":

<figure><img src="https://docs.telcobridges.com/w/images/thumb/3/37/AssociateAddress.png/800px-AssociateAddress.png" alt=""><figcaption></figcaption></figure>

<br>

* In the Address list, select the public IP to associate with the main Network Interface. Then, click on "Associate Address":

<figure><img src="https://docs.telcobridges.com/w/images/thumb/6/6f/SelectAddress.png/800px-SelectAddress.png" alt=""><figcaption></figcaption></figure>

<br>

* Click on "Instances" on the left pane and select "ProSBC" instance. Check if your instance is associated with a public IP:

<figure><img src="https://docs.telcobridges.com/w/images/thumb/e/eb/Ready.png/1100px-Ready.png" alt=""><figcaption></figcaption></figure>

### Enable SR-IOV enhanced networking

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](http://35.183.126.193:12358/)

You should get to the ProSBC Configuration Wizard<br>

<figure><img src="https://docs.telcobridges.com/w/images/thumb/0/01/AWS_TSBC_WebPortal_Configuration_wizard.jpg/700px-AWS_TSBC_WebPortal_Configuration_wizard.jpg" alt=""><figcaption></figcaption></figure>

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

* From here, you can go to Web Portal Initial Configuration Guide to continue the installation.

### Web Portal Initial Configuration

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

### Troubleshooting

* [Installation troubleshooting](/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws/aws-installation-troubleshooting.md)
* [Recovering an Elastic IP address](/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws/recovering-an-elastic-ip-address.md)

### External References

* [Accessing device with SSH and private key using putty](https://devops.profitbricks.com/tutorials/use-ssh-keys-with-putty-on-windows/#connect-to-server-with-private-key)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://prosbcdocs.telcobridges.com/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws/aws-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.