Files
cds-ai/cdsmcp/docs/cmc-install-reference.md
anthony.wen 68cd428733 Require CDC cleanup before Windows CMC reinstall in CDS MCP workflow
- update the Windows CMC install reference to require CDC project cleanup before reinstall when stale host state may exist
- update the VMware MigrateOps guide so the cleanup-first CMC preparation rule applies to both Linux and Windows sources
- document that Windows reinstall must be followed by a fresh CDC reconnect check before creating migration sessions
- update CDS MCP AGENTS guidance so Windows sources do not skip the standard CDC cleanup plus reinstall sequence
2026-03-26 10:14:11 -04:00

2.6 KiB

CMC Install Reference

This file contains the CMC install, uninstall, and reinstall fallback reference used by the CDS MCP VMware workflow.

Default Project Rule

  • Default project: Skidamarink
  • Source /home/aw/code/cds/.env.credentials.local and use CMC_GCSTAGE_REGISTRATION_CODE
  • Default endpoint: portal.gcstage.cloud.nonprod.cirrusdata.com:443
  • Use a different project code only when the user explicitly requests it in that run.

Skidamarink Install (Linux)

source /home/aw/code/cds/.env.credentials.local
curl https://get.cirrusdata.cloud/install-cmc | bash -s -- -rgc "$CMC_GCSTAGE_REGISTRATION_CODE" -gce portal.gcstage.cloud.nonprod.cirrusdata.com:443 -pkg-mode PRE_RELEASE

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. Prefer SSH to the Windows guest and execute the PowerShell command there instead of relying on VMware guest operations.

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, clean stale CDC project state for that machine when applicable instead of blindly reusing an existing registration.
  • 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.
  • After cleanup/reinstall, verify the host shows up as a fresh connected system in the CDC project before creating migrations.
  • 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)

curl https://get.cirrusdata.cloud/install-cmc | bash -s -- -uninstall

Uninstall (Windows)

iex "& { $(irm https://get.cirrusdata.cloud/install-cmc-win) } -uninstall"

CMC Reinstall Fallback (RHEL 10)

  • If installer-based reinstall fails due repo metadata/download errors, use cached local mtdi-daemon and galaxy-migrate RPMs, start services, enforce galaxy_complete_endpoint, then manually register.
  • Do not continue MigrateOps create until the source host is visible as connected in CDC.