diff --git a/cdsmcp/AGENTS.md b/cdsmcp/AGENTS.md index 474b66b..79fa631 100644 --- a/cdsmcp/AGENTS.md +++ b/cdsmcp/AGENTS.md @@ -30,6 +30,20 @@ This folder contains the VMware/vCenter + MigrateOps runbook for CDS MCP workflo - Unless user explicitly asks otherwise, scope VM lookup/list responses to cluster `QACL-ATVMCypressONLY`. - For vCenter VM lookup requests, always include datastore name and VM notes/annotation in the response. +## VM Disk And FC Assignment Requirement +- For requests to assign disks and PCI passthrough FC adapters to a VM, use the workflow in `esxvm-guide.md`. +- Always verify the VM, live ESXi host, and datastore first. +- Default expected host is `192.168.1.165`, but verify live placement before planning. +- Unless the operator explicitly specifies alternatives, default to planning these FC adapters: +- `vmhba7` (`0000:85:00.0`) +- `vmhba8` (`0000:85:00.1`) +- Unless the operator explicitly specifies alternatives, default to planning these existing datastore disks: +- `atvm-DISK_1.vmdk` +- `atvm-DISK_2.vmdk` +- The disks must be located in the same datastore as the VM under the `atvm-DISKS` directory. +- If the default or operator-specified adapters or disks are missing, do nothing and report that no assignment will be performed. +- Always provide a read-only summary of findings and planned assignment, then wait for explicit approval before any change. + ## Update Rules - Update `esxvm-guide.md` only when workflow/rules/default behavior changes. - Update `esxvm-runs.md` only when a run reveals a new learning/failure pattern/required check. diff --git a/cdsmcp/esxvm-guide.md b/cdsmcp/esxvm-guide.md index 8b2a4e0..bcdf1b0 100644 --- a/cdsmcp/esxvm-guide.md +++ b/cdsmcp/esxvm-guide.md @@ -41,6 +41,32 @@ This file is for workflow guidance only. Do not add specific run examples here. - VM notes/annotation - include power state and IP when available +## VM Disk And FC Assignment Workflow +- When asked to assign existing disks and PCI passthrough FC adapters to a specified VM, treat the request as a two-step workflow: +- first gather and report findings, +- then wait for explicit approval before making any changes. +- Always log into vCenter `192.168.0.201`. +- Find the specified VM and verify the ESXi host it is currently running on. +- Default expected ESXi host is `192.168.1.165`, but always verify the live host before planning changes. +- Always identify and report the datastore where the VM is stored before planning disk attachment. +- Unless the operator explicitly specifies alternatives, default to these PCI passthrough FC adapters: +- `vmhba7` (`0000:85:00.0`) +- `vmhba8` (`0000:85:00.1`) +- Do not substitute any other PCI FC passthrough adapters if either default or operator-specified adapter cannot be found. +- Unless the operator explicitly specifies alternatives, default to these existing disks from the VM's datastore under the `atvm-DISKS` directory: +- `atvm-DISK_1.vmdk` +- `atvm-DISK_2.vmdk` +- Do not substitute any other disks if either default or operator-specified disk cannot be found. +- If the specified adapters or specified disks cannot be found, do nothing and report that nothing will be assigned. +- Before any assignment action, always provide a summary of: +- the VM found, +- the ESXi host, +- the datastore, +- whether `vmhba7` and `vmhba8` were found and are usable, +- whether `atvm-DISK_1.vmdk` and `atvm-DISK_2.vmdk` were found under `atvm-DISKS`, +- exactly what would be assigned. +- Never perform the assignment step until the operator explicitly approves after seeing that summary. + ## Common VM Credentials - Username: `root` - Password: `cdsi2012`