HYDRA Command Center - Linux install kit
========================================

This kit installs HYDRA Command Center (HCC) as a service on a Linux machine
(Ubuntu 22.04+/Debian 12+, RHEL/Rocky/Alma 9+, with systemd) that is
connected to the HYDRA enclosure's USB management port.

1. Unzip the kit and run the installer
--------------------------------------
  sudo sh install-hcc.sh

Add --with-agent if this same machine is also the host whose PCIe links
reach the drives (it installs and enrolls the HCC host agent too).

The installer needs internet access to download HCC's Python dependencies.
It creates /opt/serialcables/hcc (a private Python environment), the 'hcc'
service, its settings in /etc/hcc, and a self-signed TLS certificate.

2. Open HCC
-----------
The installer ends by printing a link like

  https://<this-host>:8600/?token=<token>

Open it from any browser on your network and accept the self-signed
certificate warning once. Show the link again any time with:

  sudo hcc-setup status

'hydractl' works straight away on this machine (log in again first so your
account picks up the 'hcc' group).

Useful options
--------------
  --serial-port /dev/serial/by-id/...   pick the enclosure when it can't be
                                        auto-detected (e.g. two enclosures)
  --local                               this machine only (127.0.0.1, no TLS)
  --port 8600                           a different port
  --with-agent --allow-writes           let the local agent run write recipes
  --no-quarch                           skip the Quarch module support

Upgrade: unzip the newer kit and run  sudo sh install-hcc.sh  again. Your
token, certificate, settings and data are kept.

Uninstall: sudo sh install-hcc.sh --uninstall   (add --purge to also delete
settings and data).

Host agent on other machines
----------------------------
In HCC, open Host Agents, click "Download agent bundle", copy it to the
host and unzip it. Click "New enrollment code" and run the one-line command
shown there on the host.

The full User's Manual is on the HYDRA product page:
https://www.serialcables.com/products/hydra
