From c0004c1dff5c0373773dd779369f0b4dfd443af4 Mon Sep 17 00:00:00 2001 From: "anthony.wen" Date: Thu, 26 Mar 2026 08:33:41 -0400 Subject: [PATCH] Document separate Linux and Windows ATVM target credentials - add explicit Windows ATVM guest credential references alongside the existing Linux target defaults - update the ATVM automation guide and AGENTS rules so Linux SSH uses ATVM_TARGET_* while Windows guest access uses ATVM_WINDOWS_TARGET_* - update the CDS MCP CMC install and VMware workflow docs to distinguish Linux and Windows credential usage for the shared ATVM target IP - update the VM lookup reference so common VM credentials list both Linux and Windows target variables --- atvm/AGENTS.md | 5 +++-- atvm/docs/automation/guide.md | 4 +++- cdsmcp/docs/cmc-install-reference.md | 2 ++ cdsmcp/docs/vm-lookup-and-assignment.md | 6 ++++-- cdsmcp/docs/vmware-migrateops-guide.md | 3 ++- 5 files changed, 14 insertions(+), 6 deletions(-) diff --git a/atvm/AGENTS.md b/atvm/AGENTS.md index 7ca06db..f68a915 100644 --- a/atvm/AGENTS.md +++ b/atvm/AGENTS.md @@ -36,11 +36,12 @@ This file defines how to operate and maintain the ATVM workspace in `/home/aw/co - ATVM static IP target: `192.168.3.191/22` - Gateway: `192.168.0.1` - DNS: `8.8.8.8`, `8.8.4.4` -- Default setup credential source: `/home/aw/code/cds/.env.credentials.local` via `ATVM_TARGET_USER` and `ATVM_TARGET_PASSWORD` +- Default Linux setup credential source: `/home/aw/code/cds/.env.credentials.local` via `ATVM_TARGET_USER` and `ATVM_TARGET_PASSWORD` - Client log file: `atvm_setup_script.log` - Treat `192.168.3.191` as the default ATVM target host reference. - For SSH to `192.168.3.191`, ignore host key mismatch by default with `-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null`. -- For SSH to `192.168.3.191`, source `/home/aw/code/cds/.env.credentials.local` and use `ATVM_TARGET_USER` plus `ATVM_TARGET_PASSWORD` unless explicitly overridden. +- For Linux SSH to `192.168.3.191`, source `/home/aw/code/cds/.env.credentials.local` and use `ATVM_TARGET_USER` plus `ATVM_TARGET_PASSWORD` unless explicitly overridden. +- Use `ATVM_WINDOWS_TARGET_USER` plus `ATVM_WINDOWS_TARGET_PASSWORD` for Windows guest access to the same ATVM target IP unless explicitly overridden. ## Automation Track Defaults - Controller host: `atvm-cypres-vm-1` diff --git a/atvm/docs/automation/guide.md b/atvm/docs/automation/guide.md index 6e2945f..cd41777 100644 --- a/atvm/docs/automation/guide.md +++ b/atvm/docs/automation/guide.md @@ -17,7 +17,9 @@ Run ATVM CMC automation tests on the designated automation VM without unintended ## ATVM Target Host Default - Treat `192.168.3.191` as the default ATVM target host reference. - For SSH to `192.168.3.191`, ignore host key mismatch by default with `-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null`. -- For SSH to `192.168.3.191`, source `/home/aw/code/cds/.env.credentials.local` and use `ATVM_TARGET_USER` plus `ATVM_TARGET_PASSWORD` unless the operator explicitly overrides them. +- For Linux SSH access to `192.168.3.191`, source `/home/aw/code/cds/.env.credentials.local` and use `ATVM_TARGET_USER` plus `ATVM_TARGET_PASSWORD` unless the operator explicitly overrides them. +- `ATVM_LINUX_TARGET_HOST`, `ATVM_LINUX_TARGET_USER`, and `ATVM_LINUX_TARGET_PASSWORD` mirror the Linux default values when an OS-specific reference is clearer. +- For Windows guest access to `192.168.3.191`, 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. ## Operating Constraints - Run only scripts/commands explicitly requested. diff --git a/cdsmcp/docs/cmc-install-reference.md b/cdsmcp/docs/cmc-install-reference.md index b66a72b..9d1fa90 100644 --- a/cdsmcp/docs/cmc-install-reference.md +++ b/cdsmcp/docs/cmc-install-reference.md @@ -15,6 +15,8 @@ curl https://get.cirrusdata.cloud/install-cmc | bash -s -- -rgc "$CMC_GCSTAGE_RE ``` ## 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. + ```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" ``` diff --git a/cdsmcp/docs/vm-lookup-and-assignment.md b/cdsmcp/docs/vm-lookup-and-assignment.md index 716e6d2..2671d46 100644 --- a/cdsmcp/docs/vm-lookup-and-assignment.md +++ b/cdsmcp/docs/vm-lookup-and-assignment.md @@ -48,8 +48,10 @@ This file covers vCenter VM lookup responses and the workflow for assigning exis ## Common VM Credentials - Source `/home/aw/code/cds/.env.credentials.local` -- Username: `ATVM_TARGET_USER` -- Password: `ATVM_TARGET_PASSWORD` +- Linux username: `ATVM_TARGET_USER` +- Linux password: `ATVM_TARGET_PASSWORD` +- Windows username: `ATVM_WINDOWS_TARGET_USER` +- Windows password: `ATVM_WINDOWS_TARGET_PASSWORD` ## Status Output Format (Power-Off/Revert/Power-On) - `VM [vm name] was poweredOn, so I powered it off` (or `already poweredOff`) diff --git a/cdsmcp/docs/vmware-migrateops-guide.md b/cdsmcp/docs/vmware-migrateops-guide.md index 6c20387..e67b0a1 100644 --- a/cdsmcp/docs/vmware-migrateops-guide.md +++ b/cdsmcp/docs/vmware-migrateops-guide.md @@ -22,7 +22,8 @@ This file is for workflow guidance only. Do not add specific run examples here. - Any other VM IP must be obtained live from vCenter for that run only. - Do not carry forward ad-hoc VM IPs from previous runs in runbooks. - 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`, 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. ## Related References - VM lookup, datastore reporting, and FC/disk assignment: