Upgrade IDE Services

Last modified: 13 November 2024

Upgrade to IDE Services 2024.4

This section outlines the options to upgrade IDE Services On-Premises to version 2024.4 smoothly with minimized downtime.

tip

The provided instructions are intended for Helm users. If you use a different way to deploy IDE Services, contact the IDE Services support team for assistance.

Upgrade path

  • Direct upgrade from versions earlier than 2024.3.0 is not supported.

  • If you use a version earlier than 2024.3.0, you must upgrade to 2024.3.0 first and then upgrade to 2024.4.0.

  • Adhere to the industry's best practices for database backups and upgrade timing.

Non-disruptive upgrade

  • A non-disruptive upgrade is partially supported from 2024.3.X to 2024.4.0.

  • IDEs and the Toolbox App will continue functioning during the upgrade. However, you may experience some glitches in the IDE Services Web UI.

  • If the upgrade fails due to insufficient resources or misconfiguration, the previous version of the IDE Services Server will continue functioning without downtime. However, you will need to roll back the deployment of the 2024.4.0 version manually using the helm rollback command.

Initiate a non-disruptive upgrade

  1. In the values.yaml file, make sure that the deploymentStrategy parameter for IDE Services pods is set to RollingUpdate (default).

  2. Add the following ides.config.javaOpts to the values.yaml file:

    ides:
  config:
    javaOpts: "-Xmx1g -Xms256m -Dspring.flyway.outOfOrder=true -Dspring.flyway.ignoreMigrationPatterns.0=*:missing -Dspring.flyway.ignoreMigrationPatterns.1=*:future"

  3. Update your Helm installation using version 2024.3.X to apply changes in values.yaml.

  4. Perform the Helm update to 2024.4.0, which will be executed non-disruptively.

Stop-the-world upgrade

Initiate a stop-the-world upgrade

  1. In the values.yaml file, set the deploymentStrategy parameter for IDE Services pods to Recreate.

  2. Perform the Helm update to 2024.4.0, which will stop all services during the process.