Revision as of 13:40, 26 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:
• 

  Show main console on AWS

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

  Show available AMIs on AWS

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

  Filter Available Images

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

  Show available AMIs on AWS

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

  Select minimum resources for FreeSBC

6. Click “Review and Launch”:
• 

  Review and launch FreeSBC with the selected resources

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

  Launch an instance of FreeSBC AMI

8. 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:
• 

  Download generated Key Pair

9. Click on “Launch Instances”:
• 

  Launch FreeSBC instance with generated key

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

  View available instances

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

  Rename FreeSBC instance

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:

Launche Failed

• 

  Launch failed after step 4

1. Follow the link:
• 

  Copy and paste the link in a new tab in your browser

2. Click on “Continue to Subscribe”:
• 

  Subscribe to Amazon Web Service

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:
• 

  Accept if you agree with Amazon terms

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: