Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion aws-transform/POWER.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ displayName: "AWS Transform"
description: "Migrate, modernize, and upgrade codebases: .NET Framework to .NET 8/10, mainframe COBOL to Java, VMware VMs to EC2, SQL Server/Oracle/MySQL to Aurora, and Java/Python/Node.js version upgrades or AWS SDK migrations. Assess, plan, and execute code transformations from your IDE."
keywords: ["migrate", "modernize", "mainframe", "cobol", "vmware", "dotnet", ".net framework", "windows", "sql server", "oracle", "mysql", "aurora", "ec2 migration", "rehost", "lift-and-shift", "replatform", "legacy", "code upgrade", "sdk migration", "boto3", "java upgrade", "atx", "continuous modernization", "AWS Transform - continuous modernization"]
author: "AWS"
version: "2.8.0"
version: "2.8.1"
---

# AWS Transform Power
Expand Down
2 changes: 1 addition & 1 deletion aws-transform/steering/workload-custom-troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
| Transform not found | Run `atx custom def list --json` to check available transformation definitions |
| Configuration fails with commas | Do not use commas inside `additionalPlanContext` values — they break the CLI parser. Rephrase to avoid commas |
| Conversation expired | Conversations expire after 30 days. Start a new one |
| Windows not supported | Tell user to use Windows Subsystem for Linux (WSL) |
| `atx ct` fails on Windows | `atx ct` (continuous modernization) is not yet supported on native Windows (WSL is an option). `atx custom` works on native Windows |
| Git clone fails in remote container | See "Private Repo Credential Issues" section below |
| Timeout | Set `export ATX_SHELL_TIMEOUT=1800` (default: 900s) |
| Stale .exit file | The `.exit` file in `atx-agent-session/` may be left over from a previous run. Always use `kill -0 <pid>` to check if the process is still running — do not rely solely on the `.exit` file |
Expand Down
26 changes: 6 additions & 20 deletions aws-transform/steering/workload-custom.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,28 +68,14 @@ ask the user to pick.
Prerequisite checks run ONCE at the start of a session. Do not repeat per repo.
Do NOT run prerequisite checks until the user has stated what they want to do.

### 0. Platform Check (Required — All Modes)
### 0. Platform Note (All Modes)

Detect the user's operating system. If on Windows (not WSL), stop immediately and
inform the user:
`atx custom` is supported on Linux, macOS, native Windows (Windows Terminal and
PowerShell), and WSL. Do NOT block or redirect native Windows users to WSL, and do
NOT probe the OS with `uname` (it does not exist in PowerShell).

> AWS Transform custom does not support native Windows. You need to install
> Windows Subsystem for Linux (WSL) and run this from within WSL.
>
> Install WSL: `wsl --install` in PowerShell (as Administrator), then restart.
> After that, open a WSL terminal and re-run this power from there.

Check by running:

```bash
uname -s
```

- `Linux` or `Darwin` → proceed normally
- `MINGW*`, `MSYS*`, `CYGWIN*`, or any Windows-like output → block and show the WSL message above
- Command fails, errors, or is not found → treat as native Windows, block and show the WSL message above

Do NOT proceed with any other steps on native Windows.
`atx ct` (continuous modernization) is not yet supported on native Windows; tell
the user if they ask for it.

### 1. AWS CLI (Required — All Modes)

Expand Down
Loading