How to Update Host Network Configuration?

Problem

Guidance on updating the network configuration of a host.

Environment

  • Private Cloud Director - v2025.4 and Higher.

  • Self-Hosted Private Cloud Director Virtualisation – v2025.4 and Higher.

Procedure

  1. Remove All assigned Roles from the host via the PCD UI or CLI.

Warning

To remove all roles from a host, delete or migrate any associated resources to other hosts first.

From UI: Navigate to Cluster hosts Select the host Click on Other Remove all Roles

From CLI: Run the following command inside the host:

$ pcdctl deauthorize-node
  1. Decommissioned the Host from the PCD control plane:

$ pcdctl decommission-node
  1. Re-authorize the Host to the PCD control plane: Navigate to Cluster Hosts Add new Host on the UI. Use the steps outlined in the GUI.

  2. Assign the new Network Configuration: Navigate to Cluster Hosts Select the host Edit Roles Host Network config (Select the new Host network config)

  3. If these steps prove insufficient to resolve the issue, kindly reach out to the Platform9 Support Team for additional assistance.