Skip to content

Management Tools ​

This domain explains how the environment is actually managed in practice.

What Ranger Collects ​

The management-tools domain should document:

  • Windows Admin Center deployment and extension posture
  • SCVMM and SCOM integration when present
  • Azure portal or Azure CLI-based management surfaces where relevant
  • notable third-party management, backup, recovery, or monitoring agents detected on the nodes
  • tool compatibility limitations for the current identity or operating variant

Manifest Sub-Domains ​

The v1 collector writes to these named sections of the managementTools manifest domain:

Sub-domainContent
toolsDetected management services — Windows Admin Center, SCVMM, SCOM, OEM tooling, and third-party agents
agentsPer-node agent inventory — installed agents, versions, and connection state
summaryCount of running management services and identified control surfaces

Current Collector Depth ​

Current v1 collection also covers:

  • Windows Admin Center presence, service state, and certificate signals where visible.
  • Third-party agent inventory for backup, monitoring, and operations tooling.
  • SCVMM and SCOM presence indicators for environments that still carry those agents.
  • Service-level roll-ups used to explain management-plane coverage in the reports.

Why It Matters ​

An environment is managed through tools, not just through cluster objects. Ranger should document that operational reality so a receiving team knows which control surfaces matter.

Connectivity and Credentials ​

RequirementPurpose
WinRM / PowerShell remotingHost-side discovery of installed and connected tooling
Cluster credentialRequired
Optional Azure credentialHelpful where management surfaces are Azure-hosted or Azure-registered

Default Behavior ​

This domain should run by default when cluster credentials are available because it is low-friction host-side discovery and often high value for handoff.

Variant Behavior ​

Local Identity with Azure Key Vault ​

Current Microsoft documentation states that Windows Admin Center is not supported in Azure Key Vault-based identity environments and SCVMM support is limited or unsupported. Ranger should call those boundaries out clearly.

Disconnected Operations ​

Ranger should distinguish public-Azure management tools from the local disconnected control-plane management surfaces.

Multi-Rack Preview ​

Current Microsoft documentation emphasizes Azure portal, ARM, and Azure CLI management for multi-rack preview. Ranger should describe that as a different management posture from standard hyperconverged environments.

Example Manifest Data ​

A successful collect produces entries like this:

json
{
  "id": "managementPerformance",
  "status": "success",
  "domains": {
    "managementTools": {
      "tools": [
        { "name": "Windows Admin Center", "detected": true, "serviceState": "Running",
          "version": "2311.0.0.0", "port": 443 },
        { "name": "SCVMM", "detected": false },
        { "name": "SCOM", "detected": false }
      ],
      "agents": [
        { "node": "tplabs-01-n01", "name": "Microsoft Monitoring Agent", "version": "10.20.18053",
          "state": "Running" },
        { "node": "tplabs-01-n01", "name": "Azure Monitor Agent", "version": "1.22.0",
          "state": "Running" }
      ],
      "summary": { "managementServicesDetected": 1, "totalAgentsDetected": 8 }
    }
  }
}

Common Findings ​

FindingSeverityWhat it means
Windows Admin Center service stoppedWarningWAC is installed but not running; management via WAC is unavailable
Windows Admin Center not detectedInfoWAC is absent from this environment; cluster is managed through other surfaces
Legacy MMA agent detected alongside AMAInfoBoth old and new monitoring agents are installed; the old agent may be redundant
SCVMM detectedInfoSCVMM is part of the management surface; document its version and connection state
No management tooling detectedInfoNo WAC, SCVMM, SCOM, or third-party tooling; cluster is managed solely through PowerShell and Azure portal

Partial Status ​

status: partial on the management-tools collector means:

  • Agent inventory succeeded on some nodes but not others (node unreachable)
  • Service detection succeeded but WAC certificate or version queries failed

Core tool detection (WAC present/absent, service state) is usually complete even when version or configuration detail fails.

Domain Dependencies ​

Depends on the cluster-and-node domain for a node list. Independent of storage, networking, and Azure collectors.

Evidence Boundaries ​

  • Direct discovery: host-side detection of management and operational tooling
  • Azure-side discovery: Azure-registered management surfaces where applicable
  • Manual/imported evidence: operator-supplied process notes when management happens outside discoverable tooling

v1 and Future Boundaries ​

v1 should document what tools are present and how they relate to the environment.

It should not attempt to become a complete runbook or process-mining system for every operational workflow.

Released under the MIT License.