FreeSBC:Cloud:AWS Installation A

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(remove test link)
(update create aws instance part 1)
Line 3: Line 3:
 
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.
 
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.
  
−
== Instantiate an FreeSBC ==
+
== Instantiate a FreeSBC ==
−
<ol>
+
* After logging in your Amazon account, click on “EC2” in the main AWS console:
−
    <li>After logging in your Amazon account, click on “EC2” in the main AWS console:</li>
+
[[File:ConsoleEC2.png| 600px]]
−
[[File:ConsoleEC2.png| 800px]]
+
  
  
−
    <li>On the left menu, click on “AMIs”:</li>
+
* On the left menu, click on “AMIs”:
−
[[File:AMIs.png]]
+
[[File:AMIs.png| 100px]]
  
  
−
    <li>Click on the filter drop list and select “Private image” to locate FreeSBC AMI:</li>
+
* Click on the filter drop list and select “Private image” to locate FreeSBC AMI:
 
[[File:PrivateImages.png| 500px]]
 
[[File:PrivateImages.png| 500px]]
  
  
−
    <li>Select the image and click “Launch”: (Check the troubleshooting section if you have a launching issue)</li>
+
* Select the image and click “Launch”: (Check the troubleshooting section if you have a launching issues)
 
[[File:SelectAMI.png| 700px]]
 
[[File:SelectAMI.png| 700px]]
  
  
−
    <li>Select the instance type and its resources. For FreeSBC to run, you need to launch at least m4.large (2 vCPU, 8 GiB):</li>
+
* Select the instance type and its resources. Supported instance type:
 +
**  m4.large (2 vCPU, 8 GiB)
 
[[File:SelectResources.png| 800px]]
 
[[File:SelectResources.png| 800px]]
  
  
−
    <li>Click “Configure instance Details”:</li>
+
* Choose an existing subnet from the list (Do not leave it to default):
−
[[File:ConfigureDetails.png| 1000px]]
+
* Click "Add Device" under Network Interface section
−
 
+
* Click “Add Storage”:
−
 
+
−
    <li>Choose an existing subnet from the default list (or create a new one if you want to change the default parameters):</li>
+
 
[[File:ChooseSubnet.png| 1000px]]
 
[[File:ChooseSubnet.png| 1000px]]
  
  
−
    <li>Click "Add Device" under Network Interface section (since ''FreeSBC'' needs two Network Interfaces). Leave the default parameters as they are:</li>
+
* Change the volume Size to 8Gb. Then, click “Add Tags”:
−
[[File:AddNewNetworkInterface.png| 1000px]]
+
−
 
+
−
 
+
−
    <li>Click “Add Storage”:</li>
+
−
[[File:NextStorage.png| 800px]]
+
−
 
+
−
 
+
−
    <li>Change the volume Size to 40GiB. Then, click “Add Tags”:</li>
+
 
[[File:NextTag.png| 800px]]
 
[[File:NextTag.png| 800px]]
  
  
−
    <li>You can leave the default parameters as they are. Then, click “Configure Security Group”:</li>
+
* You can leave the default parameters as they are. Then, click “Configure Security Group”:
 
[[File:NextSecurityGroup.png| 800px]]
 
[[File:NextSecurityGroup.png| 800px]]
  
 +
* 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)
  
−
    <li>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)
 
−
</li>
 
 
[[File:AddRule.png| 1000px]]
 
[[File:AddRule.png| 1000px]]
  
  
−
    <li>Click “Review and Launch”:</li>
+
* Click “Review and Launch”:
 
[[File:ReviewLaunch.png| 1000px]]
 
[[File:ReviewLaunch.png| 1000px]]
  
  
−
    <li>Click “Launch”. Please, note that FreeSBC is free of charges. However, you will still be charged by Amazon for using their resources that you allocated:</li>
+
# Click “Launch”. Please, note that FreeSBC is free of charges. However, you will still be charged by Amazon for using their resources that you allocated:
 
[[File:Launch.png| 1000px]]
 
[[File:Launch.png| 1000px]]
  
  
−
    <li>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:</li>
+
# 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:
 
[[File:DownloadKey.png| 800px]]
 
[[File:DownloadKey.png| 800px]]
  
  
−
    <li>Click on “Launch Instances”:</li>
+
# Click on “Launch Instances”:
 
[[File:LaunchWithKey.png| 800px]]
 
[[File:LaunchWithKey.png| 800px]]
  
  
−
    <li>You can view your instance by clicking on “View Instances”:</li>
+
# You can view your instance by clicking on “View Instances”:
 
[[File:ViewInstance.png| 800px]]
 
[[File:ViewInstance.png| 800px]]
  
  
−
    <li>Select the instance you just created, and give a name:</li>
+
# Select the instance you just created, and give a name:
 
[[File:RenameInstance.png| 800px]]
 
[[File:RenameInstance.png| 800px]]
  
  
−
    <li>For your instance to become accessible, you need to associate a public IP generated by Amazon. Click on "Elastic IP" on the left, then click on "Allocate new address":</li>
+
# For your instance to become accessible, you need to associate a public IP generated by Amazon. Click on "Elastic IP" on the left, then click on "Allocate new address":
 
[[File:ElasticIP.png| 300px]]
 
[[File:ElasticIP.png| 300px]]
  
  
−
     <li>Click on "Allocate IP". A new public IP will be generated by Amazon:</li>
+
     <li>Click on "Allocate IP". A new public IP will be generated by Amazon:
 
[[File:AllocateIP.png| 600px]]
 
[[File:AllocateIP.png| 600px]]
  
  
−
     <li>Click on "Close":</li>
+
     <li>Click on "Close":
 
[[File:NewIP.png| 600px]]
 
[[File:NewIP.png| 600px]]
  
  
−
     <li>Go to the left pane and click on "Instance". Then select the instance "FreeSBC" to display its description:</li>
+
     <li>Go to the left pane and click on "Instance". Then select the instance "FreeSBC" to display its description:
 
[[File:IPforInstance.png| 600px]]
 
[[File:IPforInstance.png| 600px]]
  
  
−
     <li>Notice the main Private IP circled in green. You need to identify which of the network interfaces is associated with it. Usually, it is the first in the list:</li>
+
     <li>Notice the main Private IP circled in green. You need to identify which of the network interfaces is associated with it. Usually, it is the first in the list:
 
[[File:GetTheRightNetworkInterface.png| 1100px]]
 
[[File:GetTheRightNetworkInterface.png| 1100px]]
  
  
−
     <li>Click on the identified Network Interface associated with the main Private IP, then click on "Interface ID" link:</li>
+
     <li>Click on the identified Network Interface associated with the main Private IP, then click on "Interface ID" link:
 
[[File:InterfaceID.png| 1100px]]
 
[[File:InterfaceID.png| 1100px]]
  
  
−
     <li>Right-click on the selected Network Interface, then click "Associate Address":</li>
+
     <li>Right-click on the selected Network Interface, then click "Associate Address":
 
[[File:AssociateAddress.png| 800px]]
 
[[File:AssociateAddress.png| 800px]]
  
  
−
     <li>In the Address list, select the public IP to associate with the main Network Interface. Then, click on "Associate Address":</li>
+
     <li>In the Address list, select the public IP to associate with the main Network Interface. Then, click on "Associate Address":
 
[[File:SelectAddress.png| 800px]]
 
[[File:SelectAddress.png| 800px]]
  
  
−
     <li>Click on "Instances" on the left pane and select "FreeSBC" instance. Check if your instance is associated with a public IP:</li>
+
     <li>Click on "Instances" on the left pane and select "FreeSBC" instance. Check if your instance is associated with a public IP:
 
[[File:Ready.png| 1100px]]
 
[[File:Ready.png| 1100px]]
−
</ol>
+
 
  
  
Line 126: Line 115:
 
=== Launch Failed after step 4===
 
=== Launch Failed after step 4===
 
[[File:FailedLaunch.png| 800px]]
 
[[File:FailedLaunch.png| 800px]]
−
<ol>
+
 
−
     <li>Follow the link:</li>
+
     Follow the link:
 
[[File:FailedLaunchLink.png| 800px]]
 
[[File:FailedLaunchLink.png| 800px]]
  
  
−
     <li>Click on “Continue to Subscribe”:</li>
+
     <li>Click on “Continue to Subscribe”:
 
[[File:Subscribe.png| 800px]]
 
[[File:Subscribe.png| 800px]]
  
−
     <li>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:</li>
+
     <li>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:
 
[[File:Accept.png| 800px]]
 
[[File:Accept.png| 800px]]
−
</ol>
+
 
  
 
=== Test if FreeSBC is up and running in real-time ===
 
=== Test if FreeSBC is up and running in real-time ===

Revision as of 14:29, 9 March 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.

Contents

Instantiate a FreeSBC

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

ConsoleEC2.png


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

AMIs.png


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

PrivateImages.png


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

SelectAMI.png


  • Select the instance type and its resources. Supported instance type:
    • m4.large (2 vCPU, 8 GiB)

SelectResources.png


  • Choose an existing subnet from the list (Do not leave it to default):
  • Click "Add Device" under Network Interface section
  • Click “Add Storage”:

ChooseSubnet.png


  • Change the volume Size to 8Gb. Then, click “Add Tags”:

NextTag.png


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

NextSecurityGroup.png

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

AddRule.png


  • Click “Review and Launch”:

ReviewLaunch.png


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

Launch.png


  1. 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:

DownloadKey.png


  1. Click on “Launch Instances”:

LaunchWithKey.png


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

ViewInstance.png


  1. Select the instance you just created, and give a name:

RenameInstance.png


  1. For your instance to become accessible, you need to associate a public IP generated by Amazon. Click on "Elastic IP" on the left, then click on "Allocate new address":

ElasticIP.png


  • Click on "Allocate IP". A new public IP will be generated by Amazon: AllocateIP.png
  • Click on "Close": NewIP.png
  • Go to the left pane and click on "Instance". Then select the instance "FreeSBC" to display its description: IPforInstance.png
  • Notice the main Private IP circled in green. You need to identify which of the network interfaces is associated with it. Usually, it is the first in the list: GetTheRightNetworkInterface.png
  • Click on the identified Network Interface associated with the main Private IP, then click on "Interface ID" link: InterfaceID.png
  • Right-click on the selected Network Interface, then click "Associate Address": AssociateAddress.png
  • In the Address list, select the public IP to associate with the main Network Interface. Then, click on "Associate Address": SelectAddress.png
  • Click on "Instances" on the left pane and select "FreeSBC" instance. Check if your instance is associated with a public IP: Ready.png

    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

    FailedLaunch.png 

       Follow the link:

    FailedLaunchLink.png


  • Click on “Continue to Subscribe”: Subscribe.png
  • 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.png

    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:

    Your Computer Topic
    Linux Connecting to Your Linux Instance Using SSH
    Windows Connecting to Your Linux Instance from Windows Using PuTTY
    All (using Firefox, Edge or Internet Explorer) Connecting to Your Linux Instance Using MindTerm
    • Retrieved from "https://docs.telcobridges.com/mediawiki/index.php?title=FreeSBC:Cloud:AWS_Installation_A&oldid=25201"
    Personal tools