Skip to content

Commit 7656059

Browse files
authored
(docs)clarify v1.3.3 upgrade instructions (#730)
* (docs)clarify v1.3.3 upgrade instructions * add additional caution * fix typo
1 parent 592d1fd commit 7656059

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

docs/installation/installation.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -317,6 +317,7 @@ Issues in Older Releases:
317317
- do NOT update to the latest firewall AMI - see the the last bullet in section [5.1. Accelerator Design Constraints / Decisions](#51-accelerator-design-constraints--decisions)
318318
- do NOT update the `organization-admin-role` - see bullet 2 in section [2.2.6. Other](#226-other)
319319
- do NOT update account-keys (i.e. existing installations cannot change the internal values to `management` from `master`)
320+
- do NOT make changes outside those required for the upgrade (those stated in the release notes or found through the comparison with the sample config file(s)). Customers wishing to change existing Accelerator configuration should either do so before their upgrade, ensuring a clean/successful state machine execution, or after a successful upgrade.
320321
- The Accelerator name and prefix **_CANNOT_** be changed after the initial installation
321322
- Customers which customized any of the Accelerator provided default configuration files (SCPs, rsyslog config, ssm-documents, iam-policies, etc.) must manually merge the latest Accelerator provided updates with deployed customizations:
322323
- it is important customers assess the new defaults and integrate them into their custom configuration, or Accelerator functionality could break or Accelerator deployed features may be unprotected from modification
@@ -325,6 +326,8 @@ Issues in Older Releases:
325326

326327
**Release Specific Upgrade Considerations:**
327328

329+
- Upgrades to `v1.3.3 and above` from `v1.3.2 and below` requires mandatory config file schema changes as documented in the [release notes](https://github.com/aws-samples/aws-secure-environment-accelerator/releases).
330+
- These updates cause the config file change validation to fail and require running the state machine with the following input to override the validation checks on impacted fields: ```{"scope": "FULL", "mode": "APPLY", "configOverrides": {"ov-ou-vpc": true, "ov-ou-subnet": true, "ov-acct-vpc": true }}```
328331
- Upgrades to `v1.3.0 and above` from `v1.2.6 and below`:
329332
- **Please note MAJOR changes to state machine behavior, as documented [here](./customization-index.md#2-new-state-machine-behavior)**.
330333
- Upgrades to `v1.2.6 and above` from `v1.2.5 and below` - Ensure you apply the config file changes described in the release notes:

0 commit comments

Comments
 (0)