anthony.wen/cds-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document Windows SSH-based CMC workflow for CDS MCP

Browse Source 
- update the CDS MCP CMC install reference to prefer SSH plus PowerShell for Windows guest execution instead of VMware guest operations
- document the Windows install-state check and uninstall-then-reinstall pattern so it matches the Linux CMC preparation flow
- update the VMware MigrateOps guide to treat Windows CMC preparation as an SSH-based workflow using ATVM_WINDOWS_TARGET_* credentials
- update the CDS MCP README and AGENTS guidance so the Windows guest execution default is explicit
This commit is contained in:
anthony.wen
2026-03-26 08:47:53 -04:00
parent c0004c1dff
commit b19d6a912e
4 changed files with 19 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
cdsmcp/AGENTS.md
View File

@@ -44,6 +44,7 @@ This folder contains the VMware/vCenter + MigrateOps runbook for CDS MCP workflo
- Default CDC project: `Skidamarink` - Default CDC project: `Skidamarink`
- Default access node: `atvm-linux-h2h` - Default access node: `atvm-linux-h2h`
- Default ATVM target reference: `192.168.3.191` - Default ATVM target reference: `192.168.3.191`
- For Windows ATVM guest execution, prefer SSH + PowerShell with `ATVM_WINDOWS_TARGET_USER` and `ATVM_WINDOWS_TARGET_PASSWORD`.
## Update Rules ## Update Rules
- Update `docs/vmware-migrateops-guide.md` only when migration workflow/default behavior changes. - Update `docs/vmware-migrateops-guide.md` only when migration workflow/default behavior changes.

1
cdsmcp/README.md
View File

@@ -9,6 +9,7 @@ This folder contains the VMware/vCenter and MigrateOps runbook material used for
- `docs/vm-lookup-and-assignment.md` - `docs/vm-lookup-and-assignment.md`
- CMC install and uninstall reference: - CMC install and uninstall reference:
- `docs/cmc-install-reference.md` - `docs/cmc-install-reference.md`
- includes the Windows SSH + PowerShell install/reinstall path
- Run-specific learnings: - Run-specific learnings:
- `docs/run-learnings.md` - `docs/run-learnings.md`
- Base operation template: - Base operation template:

8
cdsmcp/docs/cmc-install-reference.md
View File

@@ -16,11 +16,19 @@ curl https://get.cirrusdata.cloud/install-cmc | bash -s -- -rgc "$CMC_GCSTAGE_RE
## Skidamarink Install (Windows) ## Skidamarink Install (Windows)
Source `/home/aw/code/cds/.env.credentials.local` first so `CMC_GCSTAGE_REGISTRATION_CODE` is present in the PowerShell environment, and use `ATVM_WINDOWS_TARGET_USER` plus `ATVM_WINDOWS_TARGET_PASSWORD` for Windows guest access unless the operator explicitly overrides them. Source `/home/aw/code/cds/.env.credentials.local` first so `CMC_GCSTAGE_REGISTRATION_CODE` is present in the PowerShell environment, and use `ATVM_WINDOWS_TARGET_USER` plus `ATVM_WINDOWS_TARGET_PASSWORD` for Windows guest access unless the operator explicitly overrides them.
Prefer SSH to the Windows guest and execute the PowerShell command there instead of relying on VMware guest operations.
```powershell ```powershell
iex "& { $(irm https://get.cirrusdata.cloud/install-cmc-win) } -rgc $env:CMC_GCSTAGE_REGISTRATION_CODE -gce portal.gcstage.cloud.nonprod.cirrusdata.com:443 -pkg-mode PRE_RELEASE" iex "& { $(irm https://get.cirrusdata.cloud/install-cmc-win) } -rgc $env:CMC_GCSTAGE_REGISTRATION_CODE -gce portal.gcstage.cloud.nonprod.cirrusdata.com:443 -pkg-mode PRE_RELEASE"
``` ```
## Windows Reinstall Pattern
- Before install or reinstall, connect over SSH with `ATVM_WINDOWS_TARGET_USER` and `ATVM_WINDOWS_TARGET_PASSWORD`.
- Check whether CMC is already installed before deciding on the next action.
- If CMC is already installed, uninstall first, then run the Windows install command again.
- Use the same registration code and endpoint defaults as the Linux flow.
- Prefer direct SSH + PowerShell execution for both the install and uninstall commands.
## Uninstall (Linux) ## Uninstall (Linux)
```bash ```bash
curl https://get.cirrusdata.cloud/install-cmc | bash -s -- -uninstall curl https://get.cirrusdata.cloud/install-cmc | bash -s -- -uninstall

10
cdsmcp/docs/vmware-migrateops-guide.md
View File

@@ -24,6 +24,7 @@ This file is for workflow guidance only. Do not add specific run examples here.
- When the operator refers to `192.168.3.191`, assume ATVM target SSH access should ignore host key mismatch by default with `-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null`. - When the operator refers to `192.168.3.191`, assume ATVM target SSH access should ignore host key mismatch by default with `-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null`.
- When the operator refers to `192.168.3.191` for Linux SSH access, source `/home/aw/code/cds/.env.credentials.local` and use `ATVM_TARGET_USER` plus `ATVM_TARGET_PASSWORD` unless the operator explicitly overrides them. - When the operator refers to `192.168.3.191` for Linux SSH access, source `/home/aw/code/cds/.env.credentials.local` and use `ATVM_TARGET_USER` plus `ATVM_TARGET_PASSWORD` unless the operator explicitly overrides them.
- When the operator refers to `192.168.3.191` for Windows guest access, source `/home/aw/code/cds/.env.credentials.local` and use `ATVM_WINDOWS_TARGET_USER` plus `ATVM_WINDOWS_TARGET_PASSWORD` unless the operator explicitly overrides them. - When the operator refers to `192.168.3.191` for Windows guest access, source `/home/aw/code/cds/.env.credentials.local` and use `ATVM_WINDOWS_TARGET_USER` plus `ATVM_WINDOWS_TARGET_PASSWORD` unless the operator explicitly overrides them.
- For Windows guest command execution, prefer SSH + PowerShell on the guest instead of VMware guest operations unless the operator explicitly requests otherwise.
## Related References ## Related References
- VM lookup, datastore reporting, and FC/disk assignment: - VM lookup, datastore reporting, and FC/disk assignment:
@@ -35,7 +36,7 @@ This file is for workflow guidance only. Do not add specific run examples here.
- Use `/home/aw/code/cds/cdsmcp/templates/vmw.yaml` as the starting template. - Use `/home/aw/code/cds/cdsmcp/templates/vmw.yaml` as the starting template.
- Default sequence for requested source machine: - Default sequence for requested source machine:
- clean CDC state for that machine - clean CDC state for that machine
- reinstall CMC Linux on that machine - reinstall CMC on that machine
- perform migration preflight and operation create - perform migration preflight and operation create
- If user provides a client name, replace consistently: - If user provides a client name, replace consistently:
- `config.system_name` - `config.system_name`
@@ -64,6 +65,13 @@ This file is for workflow guidance only. Do not add specific run examples here.
- Destination datastore/host/network resolve in vCenter. - Destination datastore/host/network resolve in vCenter.
- `source_nic` discovered via SSH from source host. - `source_nic` discovered via SSH from source host.
## CMC Preparation Rule
- For Linux sources, use the Linux SSH credential path and the Linux install/uninstall reference.
- For Windows sources, use SSH to the guest with `ATVM_WINDOWS_TARGET_USER` and `ATVM_WINDOWS_TARGET_PASSWORD`.
- For Windows sources, check whether CMC is already installed before install.
- If Windows CMC is already present, uninstall first and then reinstall using the Windows PowerShell installer command.
- Do not treat VMware guest operations as the default Windows execution path.
## Post-Migration Validation and Cleanup Pattern ## Post-Migration Validation and Cleanup Pattern
- Validate destination login before cleanup: - Validate destination login before cleanup:
- get destination guest IP from vCenter - get destination guest IP from vCenter