Difference between revisions of "IoTGateway/AWS/Greengrass"
Daniel.hung (talk | contribs) |
Daniel.hung (talk | contribs) |
||
Line 45: | Line 45: | ||
== Set Up AWS Greengrass == | == Set Up AWS Greengrass == | ||
+ | |||
+ | This section is referred to this [http://docs.aws.amazon.com/greengrass/latest/developerguide/gg-setup.html AWS Greengrass document]. | ||
=== Download the AWS Greengrass Core Software === | === Download the AWS Greengrass Core Software === | ||
− | Sign in to the [https://console.aws.amazon.com AWS Management Console] and navigate to the '''AWS IoT''' | + | Sign in to the [https://console.aws.amazon.com AWS Management Console] and navigate to the '''AWS IoT''' console. Then, download the [https://us-west-2.console.aws.amazon.com/iotv2/home?region=us-west-2#/software AWS Greengrass Core Software] from '''Software''' page. |
− | + | Copy the tar file into target device, and use the following command to extract the tar file: | |
sudo tar -zxvf greengrass-<span style="color:purple">platform</span>-<span style="color:purple">version</span>.tar.gz -C / | sudo tar -zxvf greengrass-<span style="color:purple">platform</span>-<span style="color:purple">version</span>.tar.gz -C / | ||
Line 58: | Line 60: | ||
:*linux-x86-64 | :*linux-x86-64 | ||
:*linux-aarch64 | :*linux-aarch64 | ||
+ | |||
+ | '''PS:''' You are also able to download this AWS Greengrass core software in the next step. | ||
=== Create an AWS Greengrass Group === | === Create an AWS Greengrass Group === | ||
+ | |||
+ | Open the AWS IoT console and, in the navigation pane, choose '''Greengrass'''. On the '''Define a Greengrass group''' tile, choose '''Get Started'''. | ||
+ | |||
+ | [[File:Aws-gg-1.png|800px|Aws-gg-1.png]] | ||
+ | |||
+ | On the '''Set up your Greengrass Group''' page, choose '''Use easy creation''', and then follow the instructions. Finally, you can see the page as below. | ||
+ | |||
+ | Download the public/private key pairs & certificate, and keep them safe. When the download has completed choose '''Finish'''. | ||
+ | |||
+ | [[File:Aws-gg-2.png|600px|Aws-gg-2.png]] | ||
+ | |||
+ | ==== <font color="#0070c0">Install certificates on your Core device</font> ==== | ||
+ | |||
+ | 1. Download the [http://www.symantec.com/content/en/us/enterprise/verisign/roots/VeriSign-Class%203-Public-Primary-Certification-Authority-G5.pem AWS IoT root CA certificate] from Verisign. | ||
+ | |||
+ | 2. Copy the Core's private key, certificate, and the AWS IoT root CA certificate into the <code>/greengrass/configuration/certs</code> directory of your device using the following names: | ||
+ | |||
+ | : | ||
+ | |||
+ | *'''cloud.pem.crt''' | ||
+ | |||
+ | ::The Core certificate downloaded from the console,e.g. ce69fc71e9.cert.pem. | ||
+ | |||
+ | : | ||
+ | |||
+ | *'''cloud.pem.key''' | ||
+ | |||
+ | ::The private key downloaded from the console, e.g. ce69fc71e9.private.key. | ||
+ | |||
+ | : | ||
+ | |||
+ | *'''root-ca.pem''' | ||
+ | |||
+ | ::The AWS IoT root CA certificate from Symantec. | ||
=== Create an AWS Greengrass Core Device in the Cloud === | === Create an AWS Greengrass Core Device in the Cloud === |
Revision as of 11:02, 5 September 2017
This article is written based on AWS (Amazon Web Services) Greengrass 1.0.0, and the target device is Advantech RSB-4760 (Qualcomm APQ8016 platform).
Set Up Environment
This section is referred to the AWS Greengrass document and AWS CLI document.
Debian 9 (Stretch)
1. Add ggc_user and ggc_group using the following commands:
sudo useradd ggc_user sudo groupadd ggc_group
2. Install missing dependencies using the following commands:
sudo apt-get update sudo apt-get install sqlite3
3. Set up cgroups
wget https://raw.githubusercontent.com/tianon/cgroupfs-mount/master/cgroupfs-mount chmod 777 cgroupfs-mount sudo bash ./cgroupfs-mount
4. Install Pip
curl -O https://bootstrap.pypa.io/get-pip.py python get-pip.py --user # Add an export command to your profile script, e.g. ~/.profile export PATH=~/.local/bin:$PATH # Load the profile into your current session source ~/.profile # Verify that pip is installed correctly pip --version
5. Installing the AWS CLI with Pip
pip install awscli --upgrade --user # Verify that the AWS CLI installed correctly aws --version
Set Up AWS Greengrass
This section is referred to this AWS Greengrass document.
Download the AWS Greengrass Core Software
Sign in to the AWS Management Console and navigate to the AWS IoT console. Then, download the AWS Greengrass Core Software from Software page.
Copy the tar file into target device, and use the following command to extract the tar file:
sudo tar -zxvf greengrass-platform-version.tar.gz -C /
- Where platform is either:
- linux-armv7l
- linux-x86-64
- linux-aarch64
PS: You are also able to download this AWS Greengrass core software in the next step.
Create an AWS Greengrass Group
Open the AWS IoT console and, in the navigation pane, choose Greengrass. On the Define a Greengrass group tile, choose Get Started.
On the Set up your Greengrass Group page, choose Use easy creation, and then follow the instructions. Finally, you can see the page as below.
Download the public/private key pairs & certificate, and keep them safe. When the download has completed choose Finish.
Install certificates on your Core device
1. Download the AWS IoT root CA certificate from Verisign.
2. Copy the Core's private key, certificate, and the AWS IoT root CA certificate into the /greengrass/configuration/certs
directory of your device using the following names:
- cloud.pem.crt
- The Core certificate downloaded from the console,e.g. ce69fc71e9.cert.pem.
- cloud.pem.key
- The private key downloaded from the console, e.g. ce69fc71e9.private.key.
- root-ca.pem
- The AWS IoT root CA certificate from Symantec.