66 lines
2.9 KiB
Markdown
66 lines
2.9 KiB
Markdown
# MinerOps Windows Agent
|
|
|
|
The Windows Agent runs at a mining site and performs local discovery, polling,
|
|
API3 enrichment, pool polling, and approved queued miner-control operations.
|
|
MinerOps does not send API3 credentials through the hub command queue; those
|
|
credentials remain in the Agent's local `agent-config.json`.
|
|
|
|
## Recovered Baseline
|
|
|
|
The seven runtime and support scripts in this directory were recovered from the
|
|
live `C:\MinerOpsAgent` installation. `BASELINE_SHA256SUMS` records their exact
|
|
pre-change hashes. Historical backups, live configuration, state, logs, and
|
|
probe output are intentionally excluded.
|
|
|
|
## Local Files
|
|
|
|
Create `agent-config.json` from `config.example.json` on the Agent host. Never
|
|
commit that file. `site_id` is the durable MinerOps site UUID; `site_name` is
|
|
retained only for transitional display compatibility.
|
|
|
|
The Agent writes runtime state to `agent-state.json` and logs under `logs/`.
|
|
Installation and upgrades preserve all three paths.
|
|
|
|
## Security
|
|
|
|
API3 account and password values are local secrets. Missing credentials make
|
|
miner control unavailable. Passwords, API tokens, salts, and the Agent secret
|
|
must not be written to normal logs or returned to MinerOps command history.
|
|
|
|
The Internal Alpha supports one Agent identity protected by the deployment
|
|
shared secret. A second active Agent requires per-Agent credentials before it
|
|
may be enabled.
|
|
|
|
## Legacy Compatibility
|
|
|
|
The older direct Hub API3, `/agent-control`, password-change, bulk-control, and
|
|
scheduling paths remain available for compatibility and are deprecated for the
|
|
Internal Alpha. The new Miner Detail controls use only the typed control API and
|
|
Agent queue; the modular control backend does not connect directly to miners.
|
|
|
|
## Deployment
|
|
|
|
Deploy Agent compatibility before enabling Hub enforcement of the
|
|
`X-MinerOps-Agent-ID` header:
|
|
|
|
1. Copy this directory to a temporary folder on the Windows Agent host.
|
|
2. Create or update `C:\MinerOpsAgent\agent-config.json` locally. Do not pass
|
|
secrets as installer or scheduled-task arguments.
|
|
3. Run `install.ps1` from an elevated Windows PowerShell session.
|
|
4. Confirm the four scheduled tasks are registered and that Agent check-in
|
|
reports the expected non-secret `VERSION`.
|
|
5. Enable the matching Agent ID and shared secret on the Hub.
|
|
|
|
The installer copies runtime code to `C:\MinerOpsAgent`, preserves
|
|
`agent-config.json`, `agent-state.json`, and `logs\`, and registers or
|
|
updates `MinerOpsAgent`, `MinerOpsAgentTray`,
|
|
`MinerOpsApi3Enrichment`, and `MinerOpsPoolPoller`.
|
|
|
|
Before replacing existing runtime files, the installer copies them to a
|
|
timestamped folder under `C:\MinerOpsAgent\backups`. To roll back, stop the
|
|
Agent tasks, copy the selected backup's runtime files back into
|
|
`C:\MinerOpsAgent`, and restart the tasks. `uninstall.ps1` unregisters the
|
|
four tasks and removes runtime code while preserving local configuration,
|
|
state, logs, and backups.
|
|
|