Release: Amazon IoT Greengrass Core v2.5.0 software update on November 12, 2021 - Amazon IoT Greengrass
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Release: Amazon IoT Greengrass Core v2.5.0 software update on November 12, 2021

This release provides version 2.5.0 of the Greengrass nucleus component, new Amazon-provided components, and updates to Amazon-provided components.

Release date: November 12, 2021

Release highlights

Platform support updates

Platform Details
Windows

Amazon IoT Greengrass now supports running the Amazon IoT Greengrass Core software on the following versions of Windows:

  • Windows 10

  • Windows Server 2019

For more information, see Supported platforms and requirements and Greengrass feature compatibility by operating system.

Public component updates

The following table lists Amazon-provided components that include new and updated features.

Important

When you deploy a component, Amazon IoT Greengrass installs the latest supported versions of all of that component's dependencies. Because of this, new patch versions of Amazon-provided public components might be automatically deployed to your core devices if you add new devices to a thing group, or you update the deployment that targets those devices. Some automatic updates, such as a nucleus update, can cause your devices to restart unexpectedly.

To prevent unintended updates for a component that is running on your device, we recommend that you directly include your preferred version of that component when you create a deployment. For more information about update behavior for Amazon IoT Greengrass Core software, see Update the Amazon IoT Greengrass Core software (OTA).

Component Details
Greengrass nucleus

Version 2.5.0 of the Greengrass nucleus is available.

New features
  • Adds support for core devices that run Windows.

  • Change the behavior of thing group removal. With this version, you can remove a core device from a thing group to uninstall that thing group's components in the next deployment.

    As a result of this change, a core device's Amazon IoT policy must have the greengrass:ListThingGroupsForCoreDevice permission. If you used the Amazon IoT Greengrass Core software installer to provision resources, the default Amazon IoT policy allows greengrass:*, which includes this permission. For more information, see Device authentication and authorization for Amazon IoT Greengrass.

  • Adds support for HTTPS proxy configurations. For more information, see Connect on port 443 or through a network proxy.

  • Adds the new windowsUser configuration parameter. You can use this parameter to specify the default user to use to run components on a Windows core device. For more information, see Configure the user that runs components.

  • Adds the new httpClient configuration options that you can use to customize HTTP request timeouts to improve performance on slow networks. For more information, see the httpClient configuration parameter.

Bug fixes and improvements
  • Fixes the bootstrap lifecycle option to restart the core device from a component.

  • Adds support for hyphens in recipe variables.

  • Fixes IPC authorization for on-demand Lambda function components.

  • Improves log messages and changes non-critical logs from INFO to DEBUG level, so logs are more useful.

  • Removes the iot:DescribeCertificate permission from the default token exchange role that the Greengrass nucleus creates when you install the Amazon IoT Greengrass Core software with automatic provisioning. This permission isn't used by the Greengrass nucleus.

  • Fixes an issue so that the automatic provisioning script doesn't require the iam:GetPolicy permission if iam:CreatePolicy is available for the same policy.

  • Additional minor fixes and improvements.

Greengrass CLI

Version 2.5.0 of the Greengrass CLI is available.

New features
  • Adds support for core devices that run Windows.

  • Adds the new AuthorizedWindowsGroups configuration parameter that you can specify to authorize system groups to use the Greengrass CLI on Windows devices.

  • Adds the windowsUser parameter for local deployments. You can use this parameter specify the user to use to run components on a Windows core device.

CloudWatch metrics

Version 3.0.0 of the CloudWatch metrics component is available.

This version of the CloudWatch metrics component expects different configuration parameters than version 2.x. If you use a non-default configuration for version 2.x, and you want to upgrade from v2.x to v3.x, you must update the component's configuration. For more information, see CloudWatch metrics component configuration.

New features
  • Adds support for core devices that run Windows.

  • Changes the component type from Lambda component to generic component. This component now no longer depends on the legacy subscription router component to create subscriptions.

  • Adds new InputTopic configuration parameter to specify the topic to which the component subscribes to receive messages.

  • Adds new OutputTopic configuration parameter to specify the topic to which the component publishes status responses.

  • Adds new PubSubToIoTCore configuration parameter to specify whether to publish and subscribe to Amazon IoT Core MQTT topics.

  • Adds the new UseInstaller configuration parameter that lets you optionally disable the installation script that installs component dependencies.

Bug fixes and improvements

Adds support for duplicate timestamps in input data.

Lambda manager

Version 2.2.0 of the Lambda manager component is available.

Bug fixes and improvements
  • Fixes an issue where Lambda functions couldn't write logs after a restart.

  • Fixes an issue where the legacy subscription router sends duplicate messages when there are wildcards in the topic.

  • Fixes an issue where non-pinned Lambda functions couldn't use the Greengrass interprocess communication (IPC) library in the Amazon IoT Device SDK.