Add AWSO 2.x to 3.x migration guide with manual and automation scripts by Apoorvkudesia-sumologic · Pull Request #6884 · SumoLogic/sumologic-documentation

Apoorvkudesia-sumologic · 2026-07-10T06:40:07Z

Purpose of this pull request

This pull request adds changes for the AWSO 2.x.x to 3.x.x migration steps with manual and automation script docs.

Select the type of change

Minor Changes - Typos, formatting, slight revisions
Update Content - Revisions, updating sections
New Content - New features, sections, pages, tutorials
Site and Tools - .clabot, version updates, maintenance, dependencies, new packages for the site (Docusaurus, Gatsby, React, etc.)

Ticket (if applicable)

amee-sumo · 2026-07-10T07:29:13Z

Review feedback

A few items to address before merge:

Script download path unclear — In the CloudFormation migration doc (line 92), it says "Download the migration script from the sumologic-solution-templates repository" but doesn't provide a direct URL or curl command to download it. Users will need to search the repo. Consider adding a direct link, e.g.:
```
curl -O https://raw.githubusercontent.com/SumoLogic/sumologic-solution-templates/main/<path>/MigrateToV300.sh
```
Placeholder note in manual doc — Line 174 says "Images showing where to find the role ARN in the CloudFormation console and where to update it in Sumo Logic will be added here." This should be resolved before merge — either add the images or remove the note.
Table rendering — In the scripted doc (line 145), --install-apps Yes\|No uses a backslash-pipe that may not render correctly. Consider using Yes/No or `Yes` or `No` instead.
Horizontal rules — The manual doc uses --- separators between steps. These aren't commonly used elsewhere in this repo and add visual weight. Consider removing them for consistency.

— via Claude Code

amee-sumo · 2026-07-10T11:12:06Z

Review feedback (round 2)

A few more items from the latest revision:

Missing download link for migration script (CloudFormation doc, line 92) — The doc says "Download the migration script from the sumologic-solution-templates repository" but still doesn't provide a direct URL or path. Users can't proceed without searching the repo. Please add a direct link or curl command, e.g.:
```
curl -O https://raw.githubusercontent.com/SumoLogic/sumologic-solution-templates/main/<path>/MigrateToV300.sh
```
Table rendering issue (CloudFormation doc, line 145) — --install-apps Yes\|No renders literally as Yes\|No. The backslash-escaped pipe doesn't work as expected in Markdown tables. Use Yes / No or `Yes` or `No` instead.
Cross-reference link text mismatch (Manual doc, line 13) — The link says "using the migration script" but the linked page title is "Migrate AWS Observability from v2.x to v3.0.0 using CloudFormation". The link text should match the target page title for consistency.

— via Claude Code

amee-sumo · 2026-07-10T14:34:20Z

Review feedback (round 3)

One remaining issue that will confuse users:

Duplicate numbered steps in manual doc (lines 154–166) — The "Find the new IAM role ARN" section has overlapping instructions. Steps 3–4 appear twice with slightly different wording, and the numbered list restarts at 3 after the first screenshot:

1. Go to AWS Console > CloudFormation > Stacks...
2. In the Resources tab, find CreateCommonResources...
3. In the CreateCommonResources stack, go to Resources...search for SumoLogicSourceRole.
4. Note the Physical ID...

[screenshot]

3. In the CreateCommonResources stack, go to Resources...search for SumoLogicSourceRole.  ← duplicate
4. Click the Physical ID link to open the IAM role.  ← duplicate

[screenshot]

5. On the IAM role page, copy the ARN...

This should be a single sequential list (1→2→3→4→5) with screenshots placed between the relevant steps. The old text from before the screenshots were added (lines 154–157) should be removed since lines 159–168 now cover the same steps with proper screenshots.

— via Claude Code

Retain the parent "Deploy and Use AWS Observability" category and split its content into two version subcategories: v3.0.0 (latest) and v2.15.0. Each contains the full doc set. Add a parent launcher landing page, repoint intra-version links, and add redirects for the moved 2.15.0 URLs. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Rename the v300/v215 subfolders to the dotted v3.0.0/v2.15.0 form and update all references: slugs, intra-version links, sidebar IDs, redirect targets, parent launcher cards, and the migration guides' links into the version docs. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Update cross-repo markdown links (release notes, API docs, FAQ, about, fedramp, control-tower) that referenced the pre-restructure paths so they resolve to the v2.15.0 version docs, fixing the production build. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…tation into AWSOMigration

…c-documentation into AWSOMigration

…tation into AWSOMigration

Groups the v2.x-to-v3.0.0 migration guides under migration/cloudformation/ and migration/terraform/, each with its own landing page, and replaces the two per-version changelogs with a single consolidated changelog.md. Updates the index page, sidebar, and all cross-references accordingly, and fixes two broken relative links to the old changelog paths.

Removes a stale client-redirect that conflicted with the new consolidated changelog page, repoints legacy redirect targets and blog release-note links to the new path, and fixes three pre-existing broken anchors (before-you-deploy, access-keys, account-settings-preferences) that surfaced once the build could get far enough to check them.

…c-documentation into AWSOMigration

kimsauce

Re-review of the latest commit (6bdea4c): 1 of 3 issues from the earlier pass is fixed (the v2.15.0 template URL in the update-stack doc — nice fix, now points to the "latest" section instead of hardcoding a version). Two link-target issues remain, flagged inline below.

Generated by Claude Code

kimsauce · 2026-08-21T18:53:57Z

+<div className="box-wrapper">
+<div className="box smallbox card">
+  <div className="container">
+  <a href={useBaseUrl('docs/observability/aws/deploy-use-aws-observability/before-you-deploy/')}><img src={useBaseUrl('img/icons/observe.png')} alt="Observe icon" width="40"/><h4>Before You Deploy</h4></a>


All 8 topic cards on this "v3.0.0 (latest)" landing page link to un-versioned flat paths (before-you-deploy/, deploy-with-aws-cloudformation/, deploy-with-terraform/, migration-strategy-using-terraform/, view-dashboards/, configure-alerts/, update-aws-observability-stack/, resources/ — lines 42, 48, 54, 60, 66, 72, 78, 84), instead of the v3.0.0/-prefixed paths. None of these flat files exist anywhere in the repo anymore on this branch — every one of these docs now lives only under v2.15.0/ or v3.0.0/. So every card on this page is a dead link.

The sibling v2.15.0/index.md added in this same PR gets this right — it prefixes every card link with v2.15.0/. This file should follow the same pattern and prefix each link with v3.0.0/.

Generated by Claude Code

kimsauce · 2026-08-21T18:54:01Z

+The script automates the entire migration process and pauses at key points for your approval before making any destructive changes.
+
+:::note
+This guide is for CloudFormation-based deployments only. If you deployed using Terraform, refer to [Migration Strategy using Terraform](/docs/observability/aws/deploy-use-aws-observability/v3.0.0/migration-strategy-using-terraform/). If you prefer to migrate manually without the script, see [Manually Migrate AWS Observability from v2.x to v3.0.0](/docs/observability/aws/deploy-use-aws-observability/migration/cloudformation/migration-strategy-v2x-to-v300-manual/).


This note's Terraform cross-link points to the wrong doc: /docs/observability/aws/deploy-use-aws-observability/v3.0.0/migration-strategy-using-terraform/ is the unrelated, pre-existing "Migrate CloudWatch Source to Kinesis Firehose Source using Terraform" page, not a v2.x→v3.0.0 migration guide.

The actual v2.x→v3.0.0 Terraform migration guide added in this PR now lives at /docs/observability/aws/deploy-use-aws-observability/migration/terraform/ (per its slug in migration/terraform.md). This link should point there instead, so Terraform users land on the real migration steps rather than an unrelated source-migration doc.

Generated by Claude Code

* Changed app module related info * terraform provider & v3 fixes --------- Co-authored-by: Sachin Magar <sachin.magar.ctr@sumologic.com>

Apoorvkudesia-sumologic added 2 commits July 10, 2026 12:08

SUMO-288112 | Apoorv | Add. AWSO 2.x to 3.x migration docs

f6782ce

SUMO-288112 | Apoorv | Add. AWSO 2.x to 3.x migration docs

88bb0e9

Apoorvkudesia-sumologic requested review from JV0812, amee-sumo, kimsauce and mafsumo as code owners July 10, 2026 06:40

cla-bot Bot added the cla-signed Contributor approved, listed in .clabot file label Jul 10, 2026

amee-sumo added 5 commits July 10, 2026 15:25

Update migration-strategy-v2x-to-v300-cloudformation.md

6cd160e

Update migration-strategy-v2x-to-v300-cloudformation.md

e6b7497

Update migration-strategy-v2x-to-v300-manual.md

f0b4e18

Update migration-strategy-v2x-to-v300-manual.md

b195d88

Update migration-strategy-v2x-to-v300-cloudformation.md

df74c26

SUMO-288122 | Apoorv | Apply review fixes to migration docs

8082f67

Apoorvkudesia-sumologic added the do-not-merge Pull requests that should not be merged label Jul 10, 2026

Merge branch 'main' into AWSOMigration

ada00fc

kimsauce assigned Apoorvkudesia-sumologic Jul 13, 2026

kimsauce changed the title ~~Awso migration~~ Add AWSO 2.x to 3.x migration guide with manual and automation scripts Jul 13, 2026

Apoorvkudesia-sumologic and others added 10 commits July 14, 2026 09:39

SUMO-288112 | Apoorv | Fix. PR feedback

291dccd

Merge branch 'main' into AWSOMigration

8e3a1be

Merge branch 'main' of https://github.com/SumoLogic/sumologic-documen…

4c668ec

…tation into AWSOMigration

added deploy-with-aws-cloudformation changes

f5d8588

Merge branch 'main' of https://github.com/SumoLogic/sumologic-documen…

293ef60

…tation into AWSOMigration

resolved feedback comments

f64be9d

resolved feedback comments

c8b341f

sachin-sumologic and others added 24 commits August 7, 2026 10:32

Merge branch 'AWSOMigration' of https://github.com/SumoLogic/sumologi…

577fa37

…c-documentation into AWSOMigration

SUMO-290516 | Apoorv | Add. TF manual migration doc

f9e2295

resolved conflicts

d21fc4d

Merge branch 'AWSOMigration' of https://github.com/SumoLogic/sumologi…

981d414

…c-documentation into AWSOMigration

Updated migration doc

96022bd

updated permissions

e486b21

Merge branch 'AWSOMigration' of https://github.com/SumoLogic/sumologi…

05f33c5

…c-documentation into AWSOMigration

Updated terraform migration path

03a400c

Added fields

1ae0021

Merge branch 'main' of https://github.com/SumoLogic/sumologic-documen…

6e65ed8

…tation into AWSOMigration

Merge remote-tracking branch 'origin/main' into AWSOMigration

032fd05

Merge branch 'AWSOMigration' of https://github.com/SumoLogic/sumologi…

68c740f

…c-documentation into AWSOMigration

doc review changes

59942c5

aws observability left menu restructure

6fc898f

deploy multiple accounts regions related changes

1e512d8

updated docs with minor fixes

c313466

updated docs with minor fixes

27399dc

terraform deployment fixes

ae19778

doc fixes

a5ea9e9

doc fixes

6a284af

restructure Update Observability Stack

10b79af

Updated Override default parameter values

6bdea4c

kimsauce reviewed Aug 21, 2026

View reviewed changes

sachin-sumologic and others added 5 commits August 24, 2026 11:52

document TF fixes

a484f05

fixed changelog and Other Configuration and Tools restructures

03196e0

Changed app module related info (#7051)

63d7ab7

* Changed app module related info * terraform provider & v3 fixes --------- Co-authored-by: Sachin Magar <sachin.magar.ctr@sumologic.com>

Updated migration with multi accounts and regions

9b8da0c

updated AWSO docs

b06165e

Navigation Menu

Uh oh!

Add AWSO 2.x to 3.x migration guide with manual and automation scripts - #6884

Add AWSO 2.x to 3.x migration guide with manual and automation scripts#6884
Apoorvkudesia-sumologic wants to merge 52 commits into
mainfrom
AWSOMigration

Apoorvkudesia-sumologic commented Jul 10, 2026 •

edited by amee-sumo

Loading

Uh oh!

amee-sumo commented Jul 10, 2026

Uh oh!

amee-sumo commented Jul 10, 2026

Uh oh!

amee-sumo commented Jul 10, 2026

Uh oh!

kimsauce left a comment

Uh oh!

kimsauce Aug 21, 2026

Uh oh!

kimsauce Aug 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Uh oh!

Conversation

Apoorvkudesia-sumologic commented Jul 10, 2026 • edited by amee-sumo Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose of this pull request

Select the type of change

Ticket (if applicable)

Uh oh!

amee-sumo commented Jul 10, 2026

Review feedback

Uh oh!

amee-sumo commented Jul 10, 2026

Review feedback (round 2)

Uh oh!

amee-sumo commented Jul 10, 2026

Review feedback (round 3)

Uh oh!

kimsauce left a comment

Choose a reason for hiding this comment

Uh oh!

kimsauce Aug 21, 2026

Choose a reason for hiding this comment

Uh oh!

kimsauce Aug 21, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Apoorvkudesia-sumologic commented Jul 10, 2026 •

edited by amee-sumo

Loading