Domino Nexus only allows control planes and data planes to be out of sync by patch version. For instance, 5.5.0 and 5.5.1 are compatible, but 5.5.0 and 5.6.0 are not.
If your control plane has been upgraded, but the data planes have not, they are marked as degraded in the Admin UI, and new executions are not permitted.
Data plane upgrades can be performed using two methods: manual upgrade, applicable to versions 5.10 and below, or UI-based upgrade, available from version 5.11 onwards. The manual method remains an option for later versions as well.
The manual method uses Helm to give upgrade commands:
-
Generate a new Helm install command using the details of the existing data plane.
The new command will use the new chart version.
-
Apply any custom values: Incorporate any custom values as needed.
-
Re-run the install: Execute the Helm command to upgrade the data plane agent and other Domino platform services.
For detailed steps, follow the existing upgrade instructions.
You can use the Domino UI to upgrade data planes:
-
To get started, go to the admin portal, then click Manage resources > Data Planes.
-
Identify the data plane that needs an upgrade by looking for a status message indicating that the "Data Plan is running an older version".
-
Click the three vertical dots next to your selected data plane.
-
Select Upgrade from the dropdown menu.
|
Important
| If the current data plane version and the target upgrade version differ by at least one major version, the upgrade cannot be completed through the UI and must be performed manually. |