Repository navigation
Maintenance
This page covers backup, restore, upgrade, repair, uninstall, certificate maintenance, and log preservation for MCOS operators.
For daily health checks and routine pool operations, see Daily Operations.
| Path | Purpose |
|---|---|
C:\Program Files\Master Control Orchestration Server |
Default install directory. |
%ProgramData%\MasterControlOrchestrationServer\config\master-control-orchestration-server.json |
Current configuration file. |
%ProgramData%\MasterControlOrchestrationServer\config\master-control-program.json |
Legacy fallback configuration file. |
%ProgramData%\MasterControlOrchestrationServer\state\ |
Runtime state files. |
%ProgramData%\MasterControlOrchestrationServer\work\ |
Runtime work directory. |
%PUBLIC%\Documents\Master Control Orchestration Server\logs\ |
Operator-visible persistent logs when emitted by installed components. |
Minimal configuration backup:
$timestamp = Get-Date -Format "yyyyMMdd-HHmmss"
$source = "$env:ProgramData\MasterControlOrchestrationServer"
$target = "$env:USERPROFILE\Desktop\mcos-backup-$timestamp"
New-Item -ItemType Directory -Force -Path $target | Out-Null
Copy-Item -Recurse -Force "$source\config" $target
Copy-Item -Recurse -Force "$source\state" $target -ErrorAction SilentlyContinueArchive the backup:
Compress-Archive -Path $target -DestinationPath "$target.zip"Stop-Service MasterControlProgram
Copy-Item -Recurse -Force "$target\*" "$env:ProgramData\MasterControlOrchestrationServer\"
Start-Service MasterControlProgramThen verify:
& "C:\Program Files\Master Control Orchestration Server\MasterControlBootstrapper.exe" preflight --json-output
Invoke-RestMethod http://localhost:7300/api/health | ConvertTo-JsonStop-Service MasterControlProgram
msiexec /i "<path>\MasterControlOrchestrationServer-vA3.11.0-win-x64.msi" /l*v "$env:TEMP\mcos-upgrade.log"
Get-Service MasterControlProgramConfiguration and state under ProgramData are preserved by normal MSI upgrades. If plugin registration was performed as a copy instead of a junction, refresh it after upgrade:
powershell -NoProfile -ExecutionPolicy Bypass -File `
"C:\Program Files\Master Control Orchestration Server\Register-McosControlPlugin.ps1"msiexec /fa "<path-to-current-or-newer-msi>" /l*v "$env:TEMP\mcos-repair.log"
& "C:\Program Files\Master Control Orchestration Server\MasterControlBootstrapper.exe" preflight --json-outputRepair reinstalls MSI payload files and custom-action side effects. It does not delete operator configuration.
Preserve configuration and state:
$product = Get-WmiObject -Class Win32_Product -Filter "Name = 'Master Control Orchestration Server'"
if ($product) {
msiexec /uninstall $product.IdentifyingNumber /qn /l*v "$env:TEMP\mcos-uninstall.log"
}Optional cleanup after uninstall:
Remove-Item -Recurse -Force "$env:ProgramData\MasterControlOrchestrationServer" -ErrorAction SilentlyContinue
Get-NetFirewallRule -DisplayName "MCOS *" -ErrorAction SilentlyContinue | Remove-NetFirewallRuleStop-Service MasterControlProgram
Remove-Item "$env:ProgramData\MasterControlOrchestrationServer\config\master-control-orchestration-server.json" -Force
Start-Service MasterControlProgramThe runtime regenerates configuration from buildDefaultConfiguration(). This
creates a new instance identity and removes persisted pool definitions unless
they are restored separately.
Gateway TLS:
scripts\Configure-LocalServerCert.ps1 -RestartService
scripts\Register-CertAutoRotation.ps1
scripts\Remove-LocalServerCert.ps1 -RestartServiceSee TLS and HTTPS for the distinction between gateway TLS and admin listener TLS.
Operations | Configuration | TLS and HTTPS | Windows Firewall and LAN Mode | 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