Itential GatewayVirtual clusters

Edit a virtual cluster

Gateway Manager 1.2.2+

You can edit a virtual cluster to update its name, description, distribution type, or cluster membership. Changes take effect for new jobs immediately after saving. In-flight jobs complete under the prior configuration.

Open the edit form

  1. Navigate to Gateway Manager.
  2. Select the virtual cluster you want to edit from the cluster table.
  3. In the detail panel, select Edit Cluster.

The edit form uses the same layout as the create form. The live preview on the right updates as you make changes.

Edit cluster details

To update the Cluster ID or Description, edit the fields directly and select Save.

Change the distribution type

To convert a virtual cluster between Active/Standby and Load Balancing, select a new value in the Distribution dropdown. The preview panel updates immediately to reflect the new type—Failover Chain (Preview) for Active/Standby, Cluster Pool (Preview) for Load Balancing.

Converting from Active/Standby to Load Balancing: The primary and backup designations are preserved in the member list, but all reachable members begin serving traffic simultaneously once the change is saved. In-flight jobs on the current active cluster complete normally.

Converting from Load Balancing to Active/Standby: The current primary cluster remains the primary. Backup clusters retain their existing order. Once saved, only the primary serves new traffic; other members stand by.

The virtual cluster’s Cluster ID is unchanged by a type conversion. Platform features that reference the cluster by name require no reconfiguration.

Add or remove member clusters

To add a cluster:

  1. Select Add Backup Cluster and choose a physical cluster from the dropdown.
  2. For active/standby clusters, drag the new entry to the correct position in the failover order.
  3. Select Save.

When you add a cluster to a virtual cluster that is already enabled, all users with access to the virtual cluster immediately gain implicit runtime access to the newly added cluster and its services. Verify that the cluster and its services are appropriate for all user groups assigned to this virtual cluster before saving.

To remove a cluster:

  1. Select the delete icon next to the cluster you want to remove.
  2. Select Save.

Removing a cluster from a live virtual cluster immediately stops new jobs from routing to it. In-flight jobs on that cluster complete normally.

To reorder backup clusters (active/standby only):

  1. Drag clusters to the desired position in the list. The topmost backup is the first failover target.
  2. Select Save.

Cancel changes

Select Cancel to discard all unsaved changes and return to the detail view. No changes are applied.