Migrate from solution version 1 to version 2 - Amazon Virtual Andon

Migrate from solution version 1 to version 2

This implementation guide contains information about how to set up and configure Amazon Virtual Andon version 2.x and above. You cannot update version 1 of the solution to version 2 using the AWS CloudFormation console due to changes with how resources are deployed. To use version 2, you must launch a new stack using version 2 of the AWS CloudFormation template.

Refer to the following table for a list of the major differences between versions 1 and 2 of this solution.

Version 1 Version 2
Solution deployment Resources are deployed by AWS CloudFormation template, AWS CodePipeline, and Amplify CLI. Resources are deployed by AWS CloudFormation template.
Amazon DynamoDB tables

Site table

Area table

Process table

Event table

Station table

Device table

Issue table

Site table

Area table

Process table

Event table

Station table

Device table

Issue table

Permission table

Root cause table

The Users page available on the web interface No Yes
The Permissions page to manage the Associate Group available on the web interface No Yes
Selection cache at Client page No Yes

Users created in version 1 cannot be migrated to version 2. The solution administrator must manually recreate users in version 2. However, the web interface provides a CSV template to upload multiple users at once from the Users page. For guidance, refer to Step 3. Add users.

Note

User passwords from version 1 cannot be migrated to version 2. Users will receive an email after they have been added in version 2. The email contains the URL to the web interface and the sign-in credentials, including a temporary password that users must change.

Use the following steps to migrate your Amazon DynamoDB tables.

  1. Migrate your Amazon DynamoDB table data. Use the following table names:

    Table Version 1 Version 2
    Site table Site-<hash>-<your stack name> <your stack name>-SiteTable-<hash>
    Area table Area-<hash>-<your stack name> <your stack name>-AreaTable-<hash>
    Process table Process-<hash>-<your stack name> <your stack name>-ProcessTable-<hash>
    Event table Event-<hash>-<your stack name> <your stack name>-EventTable-<hash>
    Station table Station-<hash>-<your stack name> <your stack name>-StationTable-<hash>
    Device table Device-<hash>-<your stack name> <your stack name>-DeviceTable-<hash>
    Issue table Issue-<hash>-<your stack name> <your stack name>-IssueTable-<hash>

    The table schema is exactly the same between the two versions. If you have less than 200,000 items in each table, you can use the Amazon Virtual Andon migration template. If you have more data, refer to Exporting and Importing DynamoDB Data Using AWS Data Pipeline in the Amazon DynamoDB Developer Guide.

    Note

    The template does not support cross Region data migration. It takes approximately four to six minutes for 100,000 items to migrate. The template launches an AWS Lambda function, which times out after 15 minutes. When the migration is completed, a notification is sent through Amazon Simple Notification Service (Amazon SNS). You can also view migration result from the AWS CloudFormation console by accessing the Outputs tab.

  2. Because Amazon DynamoDB table migration does not include Amazon Simple Notification Service (Amazon SNS) topic migration, you must create new Amazon SNS topics, and update the topicArn attribute for each item in the event Amazon DynamoDB table. You can update topic ARNs by updating events using the solution version 2 web interface.

  3. After user and table data migration is finished, the Amazon Virtual Andon web interface displays the exact same data as version 1. After confirming that version 2 of the Amazon Virtual Andon solution has identical data, you can terminate version 1 of the solution.