Related Documents
Document Properties
Kbid
30N414
Last Modified
09-Jun-2022
Added to KB
19-May-2022
Public Access
Everyone
Status
Online
Doc Type
Release Notes
Product
  • IOM 3.0
  • IOM 3.1
  • IOM 3.2
  • IOM 3.3
  • IOM 3.4
  • IOM 3.5
  • IOM 3.6
  • IOM 3.7
  • IOM 4.0
  • IOM 4.1
  • IOM 4.2

Public Release Note - IOM Helm Charts 2.1

1 Introduction

Welcome to the IOM Helm Charts 2.1.

IOM is delivered as Docker images which are dedicated to run in Kubernetes. Intershop also provides Helm Charts for IOM, which allow to easily operate the system.

1.1 Dependency Version Information

For the best compatibility between IOM Helm charts and IOM, please always use the newest version of IOM Helm charts, regardless of the IOM version you are currently using. To do so, please update IOM Helm charts as often as possible.

Helm \ IOM3.03.13.23.33.43.53.63.74.04.1
2.1.X1), 2), 3), 4), 5), 6), 7), 8)4), 6), 7), 8)5), 6), 7), 8)6), 7), 8)7), 8)8)9)


2.0.X1), 2), 3), 4), 5), 6), 7), 8)4), 6), 7), 8)5), 6), 7), 8)6), 7), 8)7), 8)8)9)

x
1.6.X1), 2), 3), 4), 5), 6), 7), 8)4), 6), 7), 8)5), 6), 7), 8)6), 7), 8)7), 8)8)9)
xx
1.5.X1), 2), 3), 4), 5), 6), 7), 8)4), 6), 7), 8)5), 6), 7), 8)6), 7), 8)7), 8)8)
xxx
1.4.X1), 2), 3), 4), 5), 6), 7)4), 6), 7)5), 6), 7)6), 7)7)
xxxx
1.3.0

1), 2), 3), 4), 5), 6)

4), 6)5), 6)6)
xxxxx
1.2.1

1), 2), 3), 4), 5)

4), 5)5)
xxxxxx
1.2.0

1), 2), 3), 4)

4)
xxxxxxx
1.1.0

1)


xxxxxxxx
1.0.0
xxxxxxxxx


1) Defect 
IOM-10458 still occurs in this combination
2) Helm parameter for timeout of test-data import does not work in this combination
3) Helm parameter to control creation of access log does not work in this combination
4) Defect IOM-10362 still occurs in this combination
5) Defect IOM-10891 still occurs in this combination
6) Helm parameters to control Datadog APM do not work in this combination
7) Helm parameter jboss.nodePrefix does not work in this combination
8) Helm parameters log.rest, config.skip*, oms.db.connectionMonitor.*, oms.db.connectTimeout do not work in this combination.
9) Helm parameter jboss.activemqClientPoolSizeMax does not work in this combination

x) Not supported

1.2 Glossary

TermDescription
DockerAn OS-level virtualization software.
HelmA package manager for Kubernetes.
IOMThe abbreviation for Intershop Order Management
KubernetesAn open-source system for automating deployment, scaling, and management of containerized applications.

2 General Information

3 New Features

3.1 Default Value of dbaccount.image.tag Has Been Updated

The new default value of dbaccount.image.tag is "1.4.0", which enables the usage of the newest release of the iom-dbaccount image.

3.2 New Parameter jboss.javaOptsAppend Has Been Added

The new Helm parameter jboss.javaOptsAppend has been added, which allows to define Java options without the need to overwrite the default value provided by jboss.javaOpts. This change will reduce migration efforts in future since users do not have to track changes of default values and re-apply them to their individual settings.

jboss.javaOptsAppend is empty per default.

3.3 Integrated Mailhog Has Been Updated

The Helm Chart of the integrated Malihog sub-chart has been updated to version 5.0.6.

3.4 Integrated NGINX Has Been Updated

The Helm chart of the integrated NGINX ingress controller has been updated to version 4.0.19.

3.5 IOM Helm Templates Have Been Updated

The IOM Helm templates have been updated to Helm version 3.8.1.

3.6 Liveness and Readiness Probes of Mailhog Can Be Disabled Now

The liveness and readiness probes of Mailhog are producing a lot of messages. Now it is possible to disable these probes, which avoids the creation of the messages. Therefore, the new Helm parameter mailhog.probes.enabled has been added. Its default value is true.


Fixed Defects

Key

Summary

76274Default memory settings are causing OOM

Migration Notes

Default Value of Parameter dbaccount.image.tag Has Changed

The default value of parameter dbaccount.image.tag has changed from 1.3.0.0 to 1.4.0

New Parameter jboss.javaOptsAppend Provided

If you have overwritten jboss.javaOpts, you should check if the same result can be obtained by using jboss.javaOptsAppend instead. When using jboss.javaOptsAppend, the migration efforts will be reduced in the future, since you do not have to track and reapply any changes of jboss.javaOpts.

Default Value of Parameter jboss.javaOpts Has Changed

The default value of parameter jboss.javaOpts has changed from
"-XX:+UseContainerSupport -XX:MinRAMPercentage=90 -XX:MaxRAMPercentage=90"
to
"-XX:+UseContainerSupport -XX:MinRAMPercentage=85 -XX:MaxRAMPercentage=85".

If your installation has overwritten the default value, you should update your individual settings, too.

Format of Parameter pg.sslRootCert Has Changed

Values of the parameter pg.sslRootCert have a different format now. Certificates now have to be passed as is; no quoting must be applied. Example:

before migration
pg:
  sslRootCert: |
    -----BEGIN CERTIFICATE-----
    MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJ
    RTESMBAGA1UEChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYD
    VQQDExlCYWx0aW1vcmUgQ3liZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoX
    DTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMCSUUxEjAQBgNVBAoTCUJhbHRpbW9y
    ZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFsdGltb3JlIEN5YmVy
    VHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKMEuyKr
    mD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjr
    IZ3AQSsBUnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeK
    mpYcqWe4PwzV9/lSEy/CG9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSu
    XmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9XbIGevOF6uvUA65ehD5f/xXtabz5OTZy
    dc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjprl3RjM71oGDHweI12v/ye
    jl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoIVDaGezq1
    BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3
    DQEBBQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT92
    9hkTI7gQCvlYpNRhcL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3Wgx
    jkzSswF07r51XgdIGn9w/xZchMB5hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0
    Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsaY71k5h+3zvDyny67G7fyUIhz
    ksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9HRCwBXbsdtTLS
    R9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp
    -----END CERTIFICATE-----

Default Value of pg.sslRootCert Has Changed

pg.sslRootCert is now empty by default. In older versions of IOM Helm Charts, the default value was set to the content of BaltimoreCyberTrustRoot.crt.pem. If your setup relies on this certificate, you now have to set it in your values file using the format shown above.

Known Defects

Key

Summary

69933It is not possible to use the internal NGINX in combination with a global NGINX ingress-controller
76294Internal NGINX ingress-controller cannot use custom ingress-class nginx-iom (it is using class nginx instead)

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources
Tickets