Upgrading Infrastructure Components

When a new version of infrastructure components is available, you can see the Upgrade available message on the data plane card. You must do the upgrade to use the latest features. It is a best practice to have infrastructure components on the latest version to ensure that all capabilities and services are running without any issues.

Most of the infrastructure components can be upgraded by using the TIBCO Control Plane UI, but some infrastructure components must be upgraded by running helm commands in the registered cluster. You do not lose any data in the upgrade.

Before you begin
  • You must do a Control Plane upgrade first before upgrading data plane infrastructure components. After TIBCO Control Plane upgrade, you will see an upgrade available for data planes and capabilities.
  • You must have Data plane Manager permission. For more information, see Permissions.

  • You must have Helm version 3.14.0 or later installed.

  • If you have configured custom Helm repository, ensure that the latest charts from TIBCO Helm repository are available in your custom repository.
    Procedure

  1. On the data plane card, click Upgrade available. Alternatively, on the data plane details page, you can see Upgrade available pop-up and button in the top pane.

  2. On the Infrastructure Components tab, helm command to upgrade either of dp-configure-namespace or dp-core-infrastructure charts is displayed. Command for Helm repository configuration is displayed. Copy and run the commands in your Kubernetes cluster. Alternatively, you can also download and run upgrade script which will run these all commands.

    If only dp-configure-namespace is available for upgrade then helm command for dp-configure-namespace is only displayed, if dp-core-infrastructure is available for upgrade then helm upgrade command for it is displayed and if both are available for upgrade then both the commands are displayed. You must have dp-core-infrastructure chart version 1.1.8 or later to view both commands.

  3. Click Upgrade now. It takes some time to upgrade the infrastructure components.
Result

When upgrade is successful and all components are up to date, you can see the message that 'Infrastructure components are up to date’.

If any infrastructure component fails to upgrade, the upgrade failure message is displayed. If upgrade fails, the failed component’s helm chart is in the failed state, but no existing functionality of data plane or capability is affected. The infrastructure components are available for upgrade again.