Skip to content

[Backport scarthgap-next] README/gg: remove separate greengrass-bin demo reference #13892

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Parent: Add example to help and check for correct AMI_DISK_SIZE_GB
merged 1 commit into from
Oct 14, 2025
Merged

[Backport scarthgap-next] README/gg: remove separate greengrass-bin demo reference #13892

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 1 addition & 40 deletions recipes-iot/aws-iot-greengrass/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ AWS IoT Greengrass has been integrated with prplWare and RDK Telco stacks using

These images are provided for AWS IoT Greengrass V2:
* `greengrass-bin`: This installs Greengrass v2 without a configuration file. This can be used if you plan to add logic to configure Greengrass when the device runs for the first time
* `greengrass-bin-demo`: This installs Greengrass v2 and configures it to run using the provided certificates and configs. Use this if you want the image to be specific to a device, or to get started quickly.

### Add systemd

Expand All @@ -144,42 +143,6 @@ VIRTUAL-RUNTIME_init_manager = "systemd"
VIRTUAL-RUNTIME_initscripts = ""
```

### Configure for demo mode (greengrass-bin-demo)

1. Put this in local.conf and configure

```bash
IMAGE_INSTALL:append = " greengrass-bin-demo"

GGV2_DATA_EP = ""
GGV2_CRED_EP = ""
GGV2_REGION = ""
GGV2_PKEY = ""
GGV2_CERT = ""
GGV2_CA = ""
GGV2_THING_NAME = ""
GGV2_TES_RALIAS = ""
```

Add certificate, key, and CA to the files/ directory. Overwrite the
files named:

- demo.pkey.pem : private key in PEM format
- demo.cert.pem : certificate in PEM format
- demo.root.pem : root CA certificate in PEM format

A sample configuration looks like the following.

```bash
GGV2_DATA_EP = "audqth88umq6e-ats.iot.us-east-1.amazonaws.com"
GGV2_CRED_EP = "c2uxv58888oq7k.credentials.iot.us-east-1.amazonaws.com"
GGV2_REGION = "us-west-2"
GGV2_THING_NAME = "workstation"
GGV2_TES_RALIAS = "GreengrassV2TokenExchangeRoleAlias"
```

In order to get the information above you can follow the instructions provided here: https://docs.aws.amazon.com/greengrass/v2/developerguide/manual-installation.html

## Using Greengrass Fleet Provisioning

When enabling Fleet provisioning `PACKAGECONFIG:pn-greengrass-bin = "fleetprovisioning"`, you need to provide claim certificates and configuration. You can do this in two ways:
Expand Down Expand Up @@ -213,7 +176,7 @@ If you don't set the certificate paths, the recipe will create the certificate d

### Additional Configuration

Make sure to provide the configuration through the variables in local.conf similar to the ones in `greengrass-bin-demo`:
Make sure to provide the configuration through the variables in local.conf:

```bash
GGV2_DATA_EP = ""
Expand All @@ -227,7 +190,5 @@ GGV2_TES_RALIAS = ""
```
with the addition of:
```bash
GGV2_THING_GROUP = ""
# in which the devices will be part of after automatic provisioning and
GGV2_FLEET_PROVISIONING_TEMPLATE_NAME = ""
```
Loading