Quick start: Greengrass device setup

Provide your credentials as environment variables. The following example exports temporary credentials, which include the session token.

export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

Download and start the script. Provide input values as needed. For example:

If your core device is running Raspbian or OpenWrt, reboot the device when prompted, provide your credentials, and then restart the script.

1. When prompted to reboot the device, run one of the following commands.

   For Raspbian platforms:

   sudo reboot

   For OpenWrt platforms:

   reboot

2. After the device reboots, open the terminal and provide your credentials as environment variables.

   export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
   export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

3. Restart the script.

   sudo -E ./gg-device-setup-latest.sh bootstrap-greengrass

4. When prompted whether to use your input values from the previous session or start a new installation, enter yes to reuse your input values.

   Note

   On platforms that require a reboot, your input values from the previous session, excluding credentials, are temporarily stored in the GreengrassDeviceSetup.config.info file.

When the setup is complete, the terminal displays a success status message that's similar to the following.

If you included the Hello World Lambda function, Greengrass device setup deploys the Greengrass group to your core device. To test the Lambda function, or for information about how to remove the Lambda function from the group, continue to Verify the Lambda function is running on the core device in Module 3-1 of the Getting Started tutorial.

If you didn't include the Hello World Lambda function, you can create your own Lambda function or try other Greengrass features. For example, you can add the Docker application deployment connector to your group and use it to deploy Docker containers to your core device.

Download and start the script. Provide your credentials and any other input values that you want to specify. The following examples show how to provide temporary credentials, which include the session token.

If your core device is running Raspbian or OpenWrt, reboot the device when prompted, provide your credentials, and then restart the script.

1. When prompted to reboot the device, run one of the following commands.

   For Raspbian platforms:

   sudo reboot

   For OpenWrt platforms:

   reboot

2. Restart the script. You must include your credentials in the command, but not the other input values. For example:

   sudo -E ./gg-device-setup-latest.sh bootstrap-greengrass
   --aws-access-key-id AKIAIOSFODNN7EXAMPLE
   --aws-secret-access-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   --aws-session-token AQoDYXdzEJr1K...o5OytwEXAMPLE=

3. When prompted whether to use your input values from the previous session or start a new installation, enter yes to reuse your input values.

   Note

   On platforms that require a reboot, your input values from the previous session, excluding credentials, are temporarily stored in the GreengrassDeviceSetup.config.info file.

When the setup is complete, the terminal displays a success status message that's similar to the following.

If you included the Hello World Lambda function, Greengrass device setup deploys the Greengrass group to your core device. To test the Lambda function, or for information about how to remove the Lambda function from the group, continue to Verify the Lambda function is running on the core device in Module 3-1 of the Getting Started tutorial.

If you didn't include the Hello World Lambda function, you can create your own Lambda function or try other Greengrass features. For example, you can add the Docker application deployment connector to your group and use it to deploy Docker containers to your core device.