Skip to Content

Upgrading BMC Helix Platform Common Services

  

BMC Helix Platform Common Services (PCS) is a microservices-based platform that provides foundational services (such as user management, tenant management, and single sign-on) and the data lake (such as Elasticsearch, PostgreSQL, Redis, and MinIO).  

Compatibility matrix

Click to view the compatibility matrix

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 26.1.01:

BMC Helix Service ManagementBMC Helix Platform Common ServicesKubernetesOpenShiftIngress (NGINX)Helm
26.1.0126.1.001.354.201.14.3 3.19, 3.20
1.344.191.14.3 3.19, 3.20
1.334.181.14.3 3.19, 3.20
1.32NA1.14.3 3.19, 3.20
1.31NA1.14.3 3.19, 3.20
1.304.171.13.73.18
1.294.161.13.7 3.18
25.4.001.344.191.13.x and 1.14.03.19
1.334.181.12.43.18
1.324.171.12.13.17
1.314.161.11.53.16
1.30NA1.11.53.15

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 25.4.01:

BMC Helix Service ManagementBMC Helix Platform Common ServicesKubernetesOpenShiftIngress (NGINX)Helm
25.4.0125.4.001.344.191.13.x and 1.14.03.19
1.334.181.12.43.18
1.324.171.12.13.17
1.314.161.11.53.16
1.30NA1.11.53.15
25.3.001.334.191.12.43.18
1.324.181.12.13.17
1.314.171.11.53.16
1.304.161.11.53.15
1.29NA1.11.53.14

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 25.3.01:

BMC Helix Service ManagementBMC Helix Platform Common ServicesKubernetesOpenShiftIngress (NGINX)Helm
25.3.0125.3.001.334.191.12.43.18
1.324.181.12.13.17
1.314.171.11.53.16
1.304.161.11.53.15
1.29NA1.11.53.14
25.2.00

1.32

4.181.12.13.17
1.314.171.11.53.16
1.304.161.11.53.15
1.294.151.11.53.14

 The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 25.2.01:

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

25.2.01

25.2.00

1.32

4.181.12.13.17
1.314.171.11.53.16
1.304.161.11.53.15
1.294.151.11.53.14

1.28

NA1.11.53.14
25.1.00

1.31

NA1.11.53.17
4.171.11.43.17

1.30

NA1.11.53.16
4.161.11.23.16
1.30NA1.11.5
1.11.1		3.15
3.14
1.29NA1.11.5
1.11.1		3.15
3.14
1.284.151.11.5
1.11.1
1.10.1 		3.15
3.14

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 25.1.01:

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

25.1.01

25.1.00

1.31

NA1.11.53.17
4.171.11.43.17

1.30

NA1.11.53.16
4.161.11.23.16
1.30NA1.11.5
1.11.1		3.15
3.14
1.29NA1.11.5
1.11.1		3.15
3.14
1.284.151.11.5
1.11.1
1.10.1 		3.15
3.14

1.27

NA1.11.53.13
4.141.10.1
1.9.6 		3.13

1.26

NA1.11.53.12
4.131.9.6 
1.8.1		3.12 

1.25

NA1.8.13.11
4.121.7.03.11

24.4.00

1.30

4.16

4.15

1.11.2

3.16

1.30

NA

1.11.1

3.15
3.14

1.29

1.11.1

3.15
3.14

1.28

4.15

1.11.1
1.10.1 

3.15
3.14

1.27

4.14

1.10.1
1.9.6 

3.13

1.26

4.13

1.9.6 
1.8.1

3.12

1.25

 

NA

1.8.1

3.11

4.12

1.7.0

3.11

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 23.3.04: 

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

23.3.04

24.4.00

1.30

4.16

4.15

1.11.2

3.16

1.30

NA

1.11.1

3.15
3.14

1.29

1.11.1

3.15
3.14

1.28

4.15

1.11.1
1.10.1 

3.15
3.14

1.27

4.14

1.10.1
1.9.6 

3.13

1.26

4.13

1.9.6 
1.8.1

3.12

1.25

 

NA

1.8.1

3.11

4.12

1.7.0

3.11

24.3.00

1.30

4.16

4.15

1.11.1

3.15
3.14

1.29

1.11.1

3.15
3.14

1.28

1.11.1
1.10.1 

3.15
3.14

1.27

4.14

1.10.1
1.9.6 

3.13

1.26

4.13

1.9.6 
1.8.1

3.12

1.25

 

NA

1.8.1

3.11

4.12

1.7.0

3.11

 The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 23.3.03:

Information

BMC Helix Service Management 23.3.03 is a controlled availability release.

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

23.3.03

24.4.00

1.30

4.15

1.11.2

3.16

1.30

NA

1.11.1

3.15
3.14

1.29

1.11.1

3.15
3.14

1.28

4.15

1.11.1
1.10.1 

3.15
3.14

1.27

4.14

1.10.1
1.9.6 

3.13

1.26

4.13

1.9.6 
1.8.1

3.12

1.25

 

NA

1.8.1

3.11

4.12

1.7.0

3.11

24.3.00

1.30

4.15

1.11.1

3.15
3.14

1.29

1.11.1

3.15
3.14

1.28

1.11.1
1.10.1 

3.15
3.14

NA1.9.6 3.15
3.14

1.27

4.14

1.10.1
1.9.6 

3.13

1.26

4.13

1.9.6 
1.8.1

3.12

1.25

 

NA

1.8.1

3.11

4.12

1.7.0

3.11

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 23.3.01:

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

23.3.01

24.3.00

1.29

4.16

4.15

1.11.1

3.15
3.14

1.28

4.16

4.15

1.11.1
1.10.1 

3.15
3.14

1.27

4.14

1.10.1
1.9.6 

3.13

1.26

4.13

1.9.6 
1.8.1

3.12

1.25

4.12

1.8.1
1.7.0

3.11

24.2.00

1.29

NA

1.11.1

3.15
3.14

1.28

4.15

1.11.1
1.10.1 

3.15
3.14

1.27

4.14

1.10.1
1.9.6 

3.13

1.26

 

4.13

1.9.6 
1.8.1

3.12

4.12

1.7.0

3.11

24.1.00

1.29

NA

1.9.6

3.15

1.28

4.14

1.9.5

3.14

1.27

1.9.3

3.13

1.26

4.13

1.8.1

3.12

1.25

4.12

1.7.0

3.11

1.24

4.11

1.7.0

3.11

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 22.1.06:

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

22.1.06

24.1.00

1.29

NA

1.9.6

3.15

1.28

4.14

1.9.5

3.14

1.27

1.9.3

3.13

1.26

4.13

1.8.1

3.12

1.25

4.12

1.7.0

3.11

1.24

4.11

1.7.0

3.11

23.4.00

1.27

4.14

1.9.3

3.13

1.26

4.13

1.8.1

3.12

1.25

4.12

1.7.0

3.11

1.24

4.11

1.7.0

3.11

23.2.02

1.25

4.12

1.7.0

3.11

1.24

4.11

1.7.0

3.11

1.23

4.10

1.6.4

3.11

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 21.3.10:

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

21.3.10

23.2.02

1.25

4.12

1.7.0

3.11

1.24

4.11

1.7.0

3.11

1.23

4.10

1.6.4

3.11

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 21.3.06:

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

21.3.06

23.2.02

1.18 – 1.24

4.6 – 4.11

 1.6.4, 1.7.0

3.11

23.1.02 Hotfix 1

1.2.0, 1.5.1

3.x

22.4.00 Hotfix 1

1.2.0, 1.5.1

3.x

22.2.01

1.2.0

3.x

The following table lists the compatible versions of BMC Helix Platform Common Services and technology stacks with BMC Helix Service Management 21.3.05:

BMC Helix Service Management

BMC Helix Platform Common Services

Kubernetes

Openshift

Ingress

Helm

21.3.05

22.2.01

1.18.x – 1.21.x

4.6 – 4.8

0.32

3.x

21.3.03.001

1.2.0

3.x

 

Upgrading  BMC Helix Platform Common Services to version 26.1.00

To upgrade BMC Helix Platform Common Services to version 26.1.00, use the following paths based on your source BMC Helix Platform Common Services version.

The upgrade path varies based on the current BMC Helix Platform Common Services version that you are using. For example, upgrade BMC Helix Platform Common Services from version 25.4.00 to 26.1.00 is a single step upgrade. However, upgrade BMC Helix Platform Common Services from version 25.2.00 to 26.1.00 is a two step upgrade. You first upgrade BMC Helix Platform Common Services from 25.2.00 to 25.4.00, and then upgrade BMC Helix Platform Common Services 25.4.00 to 26.1.00.

Warning

Important

  • During the upgrade of BMC Helix Platform Common Services, BMC Helix Service Management will remain operational with the intermediate versions of BMC Helix Platform Common Services until you complete the upgrade. You can upgrade BMC Helix Service Management after completing all upgrade hops for BMC Helix Platform Common Services.
  • You must upgrade the technology stack, including Kubernetes, OpenShift, Helm, and the Ingress Controller, to a supported version that aligns with the intermediate versions of BMC Helix Platform Common Services. Continue upgrading the technology stack until you have completed upgrading BMC Helix Platform Common Services to the latest version.

The following image displays the upgrade path from the supported BMC Helix Platform Common Services source versions to the target version 26.1.00:

PCS upgrade paths.png

Source version

Upgrade path

Steps to upgrade

25.4Upgrade path 7See Upgrading BMC Helix Platform Common Services version from 25.4.00 to 26.1.00
25.3Upgrade path 7See Upgrading BMC Helix Platform Common Services version from 25.3.00 to 26.1.00
25.2Upgrade path 6
25.1

Upgrade path 6

24.4

Upgrade path 5

24.3

Upgrade path 5

24.2

Upgrade path 4

24.1

Upgrade path 4

23.4.00

Upgrade path 3

 

23.2.02

Upgrade path 3

23.1.02

Upgrade path 2

22.4.00

Upgrade path 2

22.2.01

Upgrade path 1

  1. See Upgrading BMC Helix Platform Common Services version from 22.2.01 to 23.2.02 in BMC Helix Service Management 22.1.06 documentation.

  2. See Upgrading BMC Helix Platform Common services version from 23.2.02 to 24.1.00 in BMC Helix Service Management 23.3.01 documentation.

  3. See Upgrading BMC Helix Platform Common services version from 24.1.00 to 24.3.00 in BMC Helix Service Management 23.3.04 documentation.
  4. See Upgrading BMC Helix Platform Common services version from 24.3.00 to 25.1.00 in BMC Helix Service Management 23.3.04 documentation.
  5. See Upgrading BMC Helix Platform Common Services version from 25.1.00 to 25.2.00 in BMC Helix Service Management 23.3.01 documentation.
  6. See Upgrading BMC Helix Platform Common Services version from 25.2.00 to 25.3.00
  7. See Upgrading BMC Helix Platform Common Services version from 25.3.00 to 26.1.00

Upgrading  BMC Helix Platform Common Services to version 25.4.00

To upgrade BMC Helix Platform Common Services to version 25.4.00, use the following paths based on your source BMC Helix Platform Common Services version.

The upgrade path varies based on the current BMC Helix Platform Common Services version that you are using. For example, upgrade BMC Helix Platform Common Services from version 25.3.00 to 25.4.00 is a single step upgrade. However, upgrade BMC Helix Platform Common Services from version 24.4.00 to 25.4.00 is a two step upgrade. You first upgrade BMC Helix Platform Common Services from 24.4.00 to 25.2.00, and then upgrade BMC Helix Platform Common Services 25.2.00 to 25.4.00.

Warning

Important

  • During the upgrade of BMC Helix Platform Common Services, BMC Helix Service Management will remain operational with the intermediate versions of BMC Helix Platform Common Services until you complete the upgrade. You can upgrade BMC Helix Service Management after completing all upgrade hops for BMC Helix Platform Common Services.
  • You must upgrade the technology stack, including Kubernetes, OpenShift, Helm, and the Ingress Controller, to a supported version that aligns with the intermediate versions of BMC Helix Platform Common Services. Continue upgrading the technology stack until you have completed upgrading BMC Helix Platform Common Services to the latest version.

The following image displays the upgrade path from the supported BMC Helix Platform Common Services source versions to the target version 25.4.00:

PCS upgrade path 25.4.png

Source version

Upgrade path

Steps to upgrade

25.3Upgrade path 6See Upgrading BMC Helix Platform Common Services version from 25.3.00 to 25.4.00
25.2Upgrade path 6See Upgrading BMC Helix Platform Common Services version from 25.2.00 to 25.4.00
25.1

Upgrade path 5

24.4

Upgrade path 5

24.3

Upgrade path 4

24.2

Upgrade path 4

 

24.1

Upgrade path 3

23.4.00

Upgrade path 3

 

 

23.2.02

Upgrade path 2

23.1.02

Upgrade path 2

22.4.00

Upgrade path 1

22.2.01

Upgrade path 1

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Service Management Deployment 26.1.01