Repository navigation
Operations
This page collects the existing local commands for building, testing, packaging, installing, and inspecting MCOS. It does not add new workflows or checks.
Debug validation:
cmake --preset debug
cmake --build --preset debug
ctest --preset debug --output-on-failure
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\check-mastercontrol-forsetti.ps1Release validation:
cmake --preset release
cmake --build build\release --config Release
ctest --test-dir build\release -C Release --output-on-failure --timeout 300Toolchain discovery is handled by existing repository scripts such as
scripts\Resolve-MasterControlToolchain.ps1.
powershell -NoProfile -ExecutionPolicy Bypass `
-File scripts\Package-MasterControlOrchestrationServer.ps1 `
-Preset releaseThe package script:
- Uses
VERSION.jsonfor the package version. - Installs the build output into a staged payload.
- Runs bootstrapper preflight against the staged payload.
- Builds the MSI through
installer\Build-Msi.ps1. - Creates a zip artifact.
The MSI is the normal operator-facing installer. Zip-only output requires the
explicit -AllowZipOnly option and should be treated as a degraded package.
msiexec /i "dist\packages\release\MasterControlOrchestrationServer-vA3.11.0-win-x64\MasterControlOrchestrationServer-vA3.11.0-win-x64.msi" /l*v "$env:TEMP\mcos-install.log"Service name:
MasterControlProgram
Default install directory:
C:\Program Files\Master Control Orchestration Server
Default current configuration file:
%ProgramData%\MasterControlOrchestrationServer\config\master-control-orchestration-server.json
Get-Service MasterControlProgram
& "C:\Program Files\Master Control Orchestration Server\MasterControlBootstrapper.exe" preflight --json-output
Invoke-RestMethod http://localhost:7300/api/health | ConvertTo-Json
Invoke-RestMethod http://localhost:7300/api/discovery | ConvertTo-Json -Depth 6
Invoke-RestMethod http://localhost:7300/api/gateway/status | ConvertTo-Json -Depth 4If present and suitable for the host, use the existing helper:
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\Deploy-LocalLive.ps1This is a development convenience, not a replacement for MSI packaging.
| Script | Purpose |
|---|---|
scripts\Package-MasterControlOrchestrationServer.ps1 |
Build package artifacts. |
scripts\Get-MasterControlOrchestrationServerReleaseReadiness.ps1 |
Produce release-readiness report from existing inputs. |
scripts\Test-MasterControlOrchestrationServerDeployment.ps1 |
Deployment acceptance harness. |
scripts\Compare-MasterControlOrchestrationServerDeploymentReports.ps1 |
Compare deployment reports. |
scripts\Invoke-MasterControlOrchestrationServerDeploymentMatrix.ps1 |
Run deployment matrix scenarios. |
scripts\check-mastercontrol-forsetti.ps1 |
Forsetti compliance gate. |
scripts\Configure-LocalServerCert.ps1 |
Provision gateway TLS certificate and binding. |
scripts\Remove-LocalServerCert.ps1 |
Remove gateway TLS binding and optional cert/export. |
scripts\Register-CertAutoRotation.ps1 |
Register certificate rotation task. |
Quick Start | Packaging and Gateway Binary | Release Gate | Maintenance | Troubleshooting
Source for this wiki is maintained under docs/wiki/ in the Master-Control-Orchestration-Server repository.
Setup
Connect Clients
Operate
- Daily Operations
- Dashboard
- Telemetry and Activity
- Gateway
- Worker Pools
- Sub-Agents
- Governance
- CLU Governance
- Privileges
Maintain
Troubleshoot
Reference