Migrate from Amazon IoT Greengrass Version 1 - 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).

Migrate from Amazon IoT Greengrass Version 1

Amazon IoT Greengrass Version 2 is a major version release of the Amazon IoT Greengrass Core software, APIs, and console. Amazon IoT Greengrass V2 introduces several improvements to Amazon IoT Greengrass V1, such as modular applications, deployments to large fleets of devices, and support for additional platforms.

Note

Amazon IoT Greengrass Version 1 no longer receives feature updates, and will receive only security patches and bug fixes until June 30, 2023. For more information, see the Amazon IoT Greengrass V1 maintenance policy. If you use Amazon IoT Greengrass V1, we strongly recommend that you migrate to Amazon IoT Greengrass V2.

Follow instructions in this guide to migrate from Amazon IoT Greengrass V1 to Amazon IoT Greengrass V2.

Can I run my V1 applications on V2?

Most V1 applications can run on V2 core devices without needing to change the application code. If your V1 applications use any of the following features, you won't be able to run them on V2 yet.

  • The C and C++ Lambda function runtimes

  • On-disk storage cache for outbound MQTT messages

If your V1 applications use either of the following features, you must modify your application code to use the Amazon IoT Device SDK V2 to run the applications on Amazon IoT Greengrass V2.

  • Interact with the local shadow service

  • Publish messages to local connected devices (Greengrass devices)

Note

The Amazon IoT Device SDK for JavaScript V2 doesn't currently support Amazon IoT Greengrass V2. If your V1 applications use either of these features and the Amazon IoT Greengrass Core SDK for Node.js, you can't run them on V2 yet.

Migration overview

At a high level, you can use the following procedure to upgrade core devices from Amazon IoT Greengrass V1 to Amazon IoT Greengrass V2. The exact procedure that you follow depends on the specific requirements for your environment.


        An overview of how to migrate from Amazon IoT Greengrass V1 to Amazon IoT Greengrass V2.
  1. Understand the differences between V1 and V2

    Amazon IoT Greengrass V2 introduces new fundamental concepts for device fleets and deployable software, and V2 simplifies several concepts from V1.

    The Amazon IoT Greengrass V2 cloud service and Amazon IoT Greengrass Core software v2.x aren't backward compatible with the Amazon IoT Greengrass V1 cloud service and Amazon IoT Greengrass Core software v1.x. As a result, Amazon IoT Greengrass V1 over-the-air (OTA) updates can't upgrade core devices from V1 to V2.

  2. Validate that V1 core devices can run V2

    Validate that a V1 core device can run the Amazon IoT Greengrass Core software v2.x and Amazon IoT Greengrass V2 features. Amazon IoT Greengrass V2 has different device requirements than Amazon IoT Greengrass V1.

  3. Set up a new device to test V1 applications on V2

    To minimize risk to your devices in production, create a new device to test your V1 applications on V2. After you install the Amazon IoT Greengrass Core software v2.x, you can create and deploy Amazon IoT Greengrass V2 components to migrate and test your Amazon IoT Greengrass V1 applications.

  4. Upgrade V1 core devices to run V2

    Upgrade an existing V1 core device to run the Amazon IoT Greengrass Core software v2.x and Amazon IoT Greengrass V2 components. To migrate a fleet of devices from V1 to V2, you repeat this step for each device in the fleet.