Skip to content

Migrate IEM Pro V1 to V2

Prerequisites

Before you start, ensure that the following prerequisites are met:

  • Your IEM Pro V1 instance runs version v1.15.17 or later.
  • You have access to the IEM Pro V1 instance and the Kubernetes cluster.
  • You reviewed the IEM Pro V2 deployment guide.

Migration risks

In rare cases, the migration does not complete successfully and you must roll back the system.

Before you start the migration, create a current backup of the Keycloak database. You can use your database backup procedure or create an IEM namespace backup with Velero.

If you need to roll back, restore the Keycloak database backup as part of the rollback procedure.

Procedure

The migration from IEM Pro V1 to V2 uses an in-place Helm upgrade.

  1. Add the IEM Pro V2 Helm repository and update it.

    helm repo add iehubv2 https://repo.portal.eu1.edge.siemens.cloud/public-v2
helm repo update iehubv2

  2. Identify the current IEM Pro V1 Helm release name.

    helm list -n <namespace>

    Record the V1 release name in RELEASE_NAME variable.

    NOTICE

    The Helm Chart of the IEM Pro V1 is application-management-service.

  3. Run the Helm upgrade.

    helm upgrade $RELEASE_NAME iehubv2/ie-management --version="v2.2.0" --timeout 30m0s -n <namespace> --reset-then-reuse-values

    Upgrade details

    • Use the --reset-then-reuse-values flag. This flag is required. It resets the values to the chart defaults and then reapplies your existing overrides. You can also provide additional values. For more information about the available V2 values, see the Helm Chart Reference.
    • The V2 chart name is ie-management.
    • The timeout is set to 30 minutes because pulling the V2 images and running the migration jobs can take time.

    Legacy Group Migration

    The legacy group migration is triggered automatically during the upgrade. For more information about the legacy group migration, see Legacy Group Migration.

  4. Verify the migration.

    • The helm upgrade command finished without errors.
    • You can access the IEM Pro V2 UI.

If the migration does not complete successfully, see the Rollback Guide.