Revision as of 14:58, 27 February 2018

This page is intended to give assistance to people launching an instance of FreeSBC using Amazon Machine Image (AMI) on Amazon Web Service (AWS). In the Troubleshot section, instructions are suggested for a potential issue that a user may encounter.

Procedure to instanciate an AMI

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






2. On the left menu, click on “AMIs”:






3. Click on the filter drop list and select “Private image” to locate FreeSBC AMI:






4. Select the image and click “Launch”: (Check the troubleshooting section if you have a launching issue)






5. Select the instance type and its resources. For FreeSBC to run, you need to launch at least m4.large (2 vCPU, 8 GiB):






6. Click “Configure instance Details”:






7. Choose an existing subnet for the default list (or create a new one if you want to change the default parameters):






8. Click "Add Device" under Network Interface section (since FreeSBC needs two Network Interfaces). Leave the default parameters as they are:






9. Click “Add Storage”:






10. You can leave the default parameters as they are. Then, click “Add Tags”:






11. You can leave the default parameters as they are. Then, click “Configure Security Group”:






12. Select "Create a new security group" ( you can change its name and description). Then, click "Add Rule" to add a new rule as follow:
    • Type: Custom TCP Rule
    • Protocol: TCP
    • Port Range: 12358
    • Source: My IP (will make this instance only accessible from your current computer IP)






13. Click “Review and Launch”:






14. Click “Launch”. Please, note that FreeSBC is free of charges. However, you will still be charged by Amazon for using their resources you allocated:






15. 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 secured SSH connection:






16. Click on “Launch Instances”:






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






18. Select the instance m4.large you just created, and give a name:

You are ready to connect to FreeSBC instance on AWS through the Web Portal.

Troubleshooting

If you come across the following issue, please follow the suggested instructions:

Launch Failed after step 4

1. Follow the link:






2. Click on “Continue to Subscribe”:






3. If you agree with Amazon conditions, click on “Accept Software Terms & Launch with 1-click”. Now, you are ready to launch the instance you need:

Test if FreeSBC is up and running in real-time

You can open a session of the image running CentOS7 and check the status of FreeSBC in real-time. Depending on your operating system, you can follow the links on Amazon guide to do so: