HydraOrganizationState

CLI inspection tool for validating Hydra infrastructure topology. Compares actual service state against desired organization configuration. Read-only — never modifies any service.

Infrastructure

Operations

Install / Update

# Linux/macOS
curl -sL https://releases.experiencenet.com/hydraorganizationstate/production/latest/hydraorganizationstate-$(uname -s | tr '[:upper:]' '[:lower:]')-amd64 -o /usr/local/bin/hydraorganizationstate
chmod +x /usr/local/bin/hydraorganizationstate

Or use self-update:

hydraorganizationstate update

Inspect infrastructure

hydraorganizationstate inspect

Queries all Hydra services and compares actual state vs desired topology defined in HydraOrganization.

Validate a specific organization

hydraorganizationstate inspect --org <org-id>

Key Concepts

What it checks

• Organizations exist in HydraOrganization and have expected configuration
• Venues are registered in HydraVenues for each organization
• Districts have the expected services in HydraDistrict
• Render nodes are enrolled and healthy in HydraCluster
• WireGuard peers are configured in HydraGuard
• Experiences are in the correct lifecycle state in ExperienceLibrary

Actual vs desired

HydraOrganizationState compares:

• Desired: what the organization configuration says should exist
• Actual: what each service reports as its current state

Discrepancies are reported as warnings or errors.

Read-only guarantee

This tool only reads from services via their public APIs. It never creates, modifies, or deletes any data. Safe to run at any time.

Troubleshooting

Service unreachable

If a service can't be contacted during inspection, it's reported as unreachable. Check:

1. Is the service running? (curl <service-url>/api/v1/health)
2. Network connectivity from your workstation
3. DNS resolution for the service hostname

Stale results

Results reflect the point-in-time state when the inspection ran. If services are being updated, results may not match the latest state. Re-run the inspection after changes settle.