Configuration

Configuration

1. vCenter Connection

Go to Proactive HA → vCenter Connections → Add vCenter.

Field	Description
Name	Display name
URL	https://vcenter.example.com/
Username	Service account username
Password	Service account password
Verify SSL	Disable only for self-signed/internal CAs
Enabled	Whether this connection is active

Click Test to verify connectivity and provider registration.

Required vCenter Permissions

• Register/unregister HealthUpdate providers
• Add/remove monitored entities
• Read hosts and clusters

The module does not use Host.Inventory.EditCluster.

2. Cluster Configuration

Go to Proactive HA → Clusters → Add Cluster.

This step:

• Registers the HealthUpdate provider in vCenter
• Adds cluster hosts as monitored entities

It does not enable Proactive HA on the cluster. A vCenter administrator must do that separately.

Enable Proactive HA on the Cluster

Either manually in the GUI or use Williams Lam's PowerCLI library:

Set-PHAConfig `
    -Cluster "DR Cluster" `
    -Enabled `
    -ClusterMode Manual `
    -ModerateRemediation QuarantineMode `
    -SevereRemediation QuarantineMode `
    -ProviderId "52 01 85 bb 43 dc 1c eb-8b 2a c3 bd 6d a4 74 9d"

Get the provider ID from vCenter Connections in the web UI.

3. Mappings

Go to Proactive HA → Mappings → Add Mapping.

Field	Description
vCenter	Select configured vCenter
Business Process Node	BP config and node to monitor
vSphere Host Name	Host name as shown in vSphere
vSphere Host MOID	Optional; auto-resolved if empty
Enabled	Whether this mapping is active

The MOID is auto-resolved via vCenter when the form is saved.

4. systemd Services

Install and enable the timers:

cp etc/systemd/*.service /etc/systemd/system/
cp etc/systemd/*.timer /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now proactiveha-monitor.timer
systemctl enable --now proactiveha-worker.timer

Default intervals:

• Monitor: every 30 seconds
• Worker: every 5 seconds

The services run as www-data:icingaweb2 by default. Adjust if needed.