Update the solution

If you have previously deployed the solution, follow this procedure to update the Cloud Migration Factory on AWS solution CloudFormation stack to get the latest version of the solution’s framework.

1. Sign in to the AWS CloudFormation console, select your existing Cloud Migration Factory on AWS solution CloudFormation stack, and select Update.

2. Select Replace current template.

3. Under Specify template:

   1. Select Amazon S3 URL.

   2. Copy the link for the latest template.

   3. Paste the link in the Amazon S3 URL box.

   4. Verify that the correct template URL shows in the Amazon S3 URL text box, and choose Next. Choose Next again.

4. Under Parameters, review the parameters for the template and modify them as necessary. Refer to Step 2. Launch the Stack for details about the parameters.

5. Choose Next.

6. On the Configure stack options page, choose Next.

7. On the Review page, review and confirm the settings. Be sure to check the box acknowledging that the template might create AWS Identity and Access Management (IAM) resources.

8. Choose View change set and verify the changes.

9. Choose Update stack to deploy the stack.

You can view the status of the stack in the AWS CloudFormation console in the Status column. You should receive a UPDATE_COMPLETE status in approximately 10 minutes.

Redeploy the API Gateway APIs

After updating the stack, it is required that you redeploy the API Gateway APIs: admin, login, tools, and user. This ensures that any changes to the configuration are available to all APIs.

1. Sign in to the Amazon API Gateway console , select *APIs *from the left navigation, and then select the CMF API.

2. From the API Resources, select Actions, and select Deploy API.

3. Select Deployment Stage *of *prod, and choose Deploy.

4. Repeat steps 1-3 for each of the Cloud Migration Factory on AWS APIs.

Note

Updating the solution adds the current versions of the built-in scripts to the deployment, but it won’t set the default versions of the scripts to the latest version. The reason is that we don’t want to overwrite any customizations that might have been applied to the solution.

Use the latest versions of the scripts

To use the latest versions of the scripts:

1. Navigate to the Cloud Migration Factory on AWS console.

2. In the navigation menu, select Automation, then select Scripts.

3. Goto the Cloud Migration Factory on AWS console.

4. Select Automation, then Scripts.

5. Select the existing script that you want to update to the latest version. Then select Actions and choose *Change default version. *

6. For Script Default Version, choose the latest version of the script.

7. Choose Save.

Update customized scripts

To update scripts that have been customized:

1. Download the updated scripts from the following repository.

2. Extract the contents to see the individual scripts.

3. From one of the new scripts extract the mfcommon.py file.

4. Goto the Cloud Migration Factory on AWS console.

5. Select Automation, then Scripts.

6. Select the existing script to update, and then select Actions and choose *Download default version. *

7. Extract the contents of the script archive.

8. Replace the mfcommon.py file with the version extracted in Step 3.

9. Compress all the contents of the script, with the new mfcommon.py file.

10. Upload this new version, following the instructions in the Add new version of a script package section.

    On the Automation Scripts page, for each script you want the latest version to be the default:

    1. Select the script.

    2. From Actions, choose Change default version.

    3. From Script Default Version, choose the latest available version number.

11. Choose Save.

(Private deployment only) Redeploy private web console static content

To redeploy private web console static content, complete the steps documented in Step 5: (Optional) Deploy private web console static content section.