Install Alauda AI Infrastructure Accelerator Virtualization Console
Alauda AI Infrastructure Accelerator Virtualization Console is an optional HAMi product-line component. Install it when users need a HAMi-specific resource overview in addition to ACP monitoring.
TOC
Before you beginPrepare the Prometheus settingsInstall the Operator BundleAccess HAMi-WebUIVerify the Prometheus query pathNext stepsBefore you begin
- Install Alauda Build of HAMi.
- Confirm the supported HAMi-WebUI version in Versions and Components.
- Obtain the
Alauda AI Infrastructure Accelerator Virtualization Consolev1.3.0 Operator Bundle for the target architecture from the package source configured for the target ACP environment. - Confirm that ACP monitoring is available in the target cluster and that HAMi-WebUI can reach its Prometheus query address.
- Obtain cluster administrator access. The generated Prometheus authentication value is a credential and must be handled as a secret.
The v1.3.0 Operator Bundle cannot be upgraded in place from an earlier HAMi-WebUI Cluster Plugin. Uninstall the old Cluster Plugin first, wait for its operator, WebUI workload, Service, and configuration resources to be removed, then perform a fresh v1.3.0 installation.
Prepare the Prometheus settings
The plugin form requires a Prometheus address and accepts the complete value for the HTTP Authorization header. For Basic authentication, the value must include the scheme prefix:
Use the following script to read the monitoring Feature and generate the two form values. It does not print the username or password separately.
Do not omit the Basic prefix. HAMi-WebUI sends the configured authentication string unchanged as the Prometheus Authorization header. A base64 value without the scheme prefix can be redirected to an authorization page instead of receiving Prometheus JSON.
From a network location that can reach the returned address, verify the credentials before installing the plugin:
A successful response has "status":"success" and a Prometheus JSON data object. An HTML page, login page, or authorization redirect is not a valid response.
Install the Operator Bundle
-
Add the
hami-webui-operatorpackage to the selected ACP catalog and create or update its Subscription. -
Approve the generated InstallPlan when the Subscription uses manual approval.
-
Wait for the CSV
hami-webui-operator.v1.3.0to reachSucceededand the operator Deployment to become Ready. -
Create the
HamiWebUIresource incpaas-systemwith the Prometheus and service settings required by the target cluster. -
Fill in or update the WebUI configuration:
-
Wait for the WebUI pod to become Ready:
Access HAMi-WebUI
Use the ACP route when platform access is available:
When NodePort is enabled, find the service port and a reachable node address:
Open the direct task page with the selected NodePort:
Verify the Prometheus query path
For a NodePort deployment, query the same WebUI backend endpoint used by the page:
The expected response is a JSON object with a data array, for example {"data":[...]}. HTTP 523, VGPU_DOMAIN_ERROR, or an error containing an HTML document means the WebUI backend did not receive a valid Prometheus API response. See Troubleshooting.