MAS update - Cannot enter the DB2U-KIND parameter.

[Bongho-Song]

MAS CLI version

23.10.0

CLI function used

update

What happened?

When trying to update MAS, an error "DB2U_KIND MISMATCH DETECTED" occurs because the DB2U-KIND parameter cannot be entered.

--with db2u-kind parameter-------------------------------------------------------------------------------------------------
[ibmmas/cli:23.10.0]mascli$ mas update -c v9-260827-amd64 --db2u-kind db2uinstance --no-confirm

IBM Maximo Application Suite Admin CLI v23.10.0
Powered by https://github.com/ibm-mas/ansible-devops/ and https://tekton.dev/

Usage (non-interactive mode):
mas update -c MAS_CATALOG_VERSION [--db2-namespace DB2_NAMESPACE]
[--mongodb-namespace MONGODB_NAMESPACE] [--mongodb-v5-upgrade]
[--mongodb-v6-upgrade] [--mongodb-v7-upgrade] [--mongodb-v8-upgrade]
[--kafka-namespace KAFKA_NAMESPACE] [--kafka-provider {redhat,strimzi}]
[--artifactory-username ARTIFACTORY_USERNAME]
[--artifactory-token ARTIFACTORY_TOKEN] [--dev-mode]
[--cp4d-version CPD_PRODUCT_VERSION] [--no-confirm] [--skip-pre-check]

Usage (interactive mode):
mas update

Usage (help):
mas update -h
mas update: error: unrecognized arguments: --db2u-kind db2uinstance

---

--without db2u-kind parameter-------------------------------------------------------------------------------------------------
TASK [ibm.mas_devops.db2 : Validate DB2U_KIND matches existing deployment] *****
[ERROR]: Task failed: Action failed: DB2U_KIND MISMATCH DETECTED!

Requested DB2U_KIND: db2ucluster
Existing deployment: db2uinstance
Namespace: db2u

ERROR: Cannot change deployment type during upgrade.

RESOLUTION:

• To upgrade existing Db2uCluster: Set DB2U_KIND=db2ucluster
• To upgrade existing Db2uInstance: Set DB2U_KIND=db2uinstance

Origin: /opt/app-root/lib64/python3.12/site-packages/ansible_collections/ibm/mas_devops/roles/db2/tasks/upgrade/main.yml:57:3

55 # 4. Validate DB2U_KIND matches existing deployment
56 # -------------------------------------------------------------------------
57 - name: "Validate DB2U_KIND matches existing deployment"
^ column 3

fatal: [localhost]: FAILED! => {
"assertion": "db2u_kind == detected_db2u_kind",
"changed": false,
"evaluated_to": false,
"msg": "DB2U_KIND MISMATCH DETECTED!\n\nRequested DB2U_KIND: db2ucluster\nExisting deployment: db2uinstance\nNamespace: db2u\n\nERROR: Cannot change deployment type during upgrade.\n\nRESOLUTION:\n- To upgrade existing Db2uCluster: Set DB2U_KIND=db2ucluster\n- To upgrade existing Db2uInstance: Set DB2U_KIND=db2uinstance\n"
}

PLAY RECAP *********************************************************************
localhost : ok=8 changed=0 unreachable=0 failed=1 skipped=1 rescued=0 ignored=0

Relevant log output

STEP-DB2

Export all env vars defined in /workspace/settings
Using /opt/app-root/src/ansible.cfg as config file
[WARNING]: No inventory was parsed, only implicit localhost is available
[WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit localhost does not match 'all'
running playbook inside collection ibm.mas_devops

PLAY [localhost] ***************************************************************

TASK [Gathering Facts] *********************************************************
ok: [localhost]

TASK [ibm.mas_devops.db2 : Run the selected action] ****************************
included: /opt/app-root/lib64/python3.12/site-packages/ansible_collections/ibm/mas_devops/roles/db2/tasks/upgrade/main.yml for localhost
[WARNING]: Deprecation warnings can be disabled by setting `deprecation_warnings=False` in ansible.cfg.
[DEPRECATION WARNING]: Importing 'to_bytes' from 'ansible.module_utils._text' is deprecated. This feature will be removed from ansible-core version 2.24. Use ansible.module_utils.common.text.converters instead.
[DEPRECATION WARNING]: Importing 'to_native' from 'ansible.module_utils._text' is deprecated. This feature will be removed from ansible-core version 2.24. Use ansible.module_utils.common.text.converters instead.
[DEPRECATION WARNING]: Importing 'to_text' from 'ansible.module_utils._text' is deprecated. This feature will be removed from ansible-core version 2.24. Use ansible.module_utils.common.text.converters instead.

TASK [ibm.mas_devops.db2 : Lookup Namespace: db2u] *****************************
ok: [localhost] => {"api_found": true, "changed": false, "resources": [{"apiVersion": "v1", "kind": "Namespace", "metadata": {"annotations": {"db2w-shared.databases.ibm.com/account-hash": "3004052839", "db2w-shared.databases.ibm.com/db2uengine-account-hash": "3004052839", "kubectl.kubernetes.io/last-applied-configuration": "{\"apiVersion\":\"v1\",\"kind\":\"Namespace\",\"metadata\":{\"labels\":{\"ibm.com/kyverno\":\"audit\"},\"name\":\"db2u\"}}", "openshift.io/sa.scc.mcs": "s0:c29,c9", "openshift.io/sa.scc.supplemental-groups": "1000830000/10000", "openshift.io/sa.scc.uid-range": "1000830000/10000", "security.openshift.io/MinimallySufficientPodSecurityStandard": "privileged"}, "creationTimestamp": "2026-08-31T01:58:56Z", "labels": {"ibm.com/kyverno": "audit", "kubernetes.io/metadata.name": "db2u", "olm.operatorgroup.uid/c1ab3d78-223e-47a3-a066-eca6d2b647f7": "", "openshift-pipelines.tekton.dev/namespace-reconcile-version": "1.23.2", "openshift-pipelines.tekton.dev/namespace-trusted-configmaps-version": "1.23.2", "pod-security.kubernetes.io/audit": "privileged", "pod-security.kubernetes.io/audit-version": "latest", "pod-security.kubernetes.io/warn": "privileged", "pod-security.kubernetes.io/warn-version": "latest"}, "managedFields": [{"apiVersion": "v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:metadata": {"f:annotations": {"f:security.openshift.io/MinimallySufficientPodSecurityStandard": {}}, "f:labels": {"f:pod-security.kubernetes.io/audit": {}, "f:pod-security.kubernetes.io/audit-version": {}, "f:pod-security.kubernetes.io/warn": {}, "f:pod-security.kubernetes.io/warn-version": {}}}}, "manager": "pod-security-admission-label-synchronization-controller", "operation": "Apply", "time": "2026-09-01T08:05:01Z"}, {"apiVersion": "v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:metadata": {"f:annotations": {".": {}, "f:kubectl.kubernetes.io/last-applied-configuration": {}}, "f:labels": {".": {}, "f:ibm.com/kyverno": {}, "f:kubernetes.io/metadata.name": {}}}}, "manager": "OpenAPI-Generator", "operation": "Update", "time": "2026-08-31T01:58:56Z"}, {"apiVersion": "v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:metadata": {"f:annotations": {"f:openshift.io/sa.scc.mcs": {}, "f:openshift.io/sa.scc.supplemental-groups": {}, "f:openshift.io/sa.scc.uid-range": {}}}}, "manager": "cluster-policy-controller", "operation": "Update", "time": "2026-08-31T01:58:56Z"}, {"apiVersion": "v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:metadata": {"f:labels": {"f:olm.operatorgroup.uid/c1ab3d78-223e-47a3-a066-eca6d2b647f7": {}}}}, "manager": "olm", "operation": "Update", "time": "2026-08-31T01:58:58Z"}, {"apiVersion": "v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:metadata": {"f:annotations": {"f:db2w-shared.databases.ibm.com/account-hash": {}, "f:db2w-shared.databases.ibm.com/db2uengine-account-hash": {}}}}, "manager": "manager", "operation": "Update", "time": "2026-09-01T00:11:30Z"}, {"apiVersion": "v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:metadata": {"f:labels": {"f:openshift-pipelines.tekton.dev/namespace-reconcile-version": {}, "f:openshift-pipelines.tekton.dev/namespace-trusted-configmaps-version": {}}}}, "manager": "openshift-pipelines-operator", "operation": "Update", "time": "2026-09-03T00:49:08Z"}], "name": "db2u", "resourceVersion": "8272368", "uid": "829f2c70-cac0-4aca-aeb8-c3dc6cc40798"}, "spec": {"finalizers": ["kubernetes"]}, "status": {"phase": "Active"}}]}

TASK [ibm.mas_devops.db2 : Set found_db2_namespace Fact] ***********************
ok: [localhost] => {"ansible_facts": {"found_db2_namespace": true}, "changed": false}

TASK [ibm.mas_devops.db2 : Namespace Not Found: db2u] **************************
skipping: [localhost] => {"false_condition": "not found_db2_namespace"}

TASK [ibm.mas_devops.db2 : Detect existing Db2uCluster CR] *********************
ok: [localhost] => {"api_found": true, "changed": false, "resources": []}

TASK [ibm.mas_devops.db2 : Detect existing Db2uInstance CR] ********************
ok: [localhost] => {"api_found": true, "changed": false, "resources": [{"apiVersion": "db2u.databases.ibm.com/v1", "kind": "Db2uInstance", "metadata": {"annotations": {"db2u/certs-api-cert": "[secure]", "db2u/certs-api-key": "[secure]", "db2u/certs-wv-rest": "[secure]", "db2u/license": "[secure]", "db2u/sshkeys-db2instusr": "[secure]", "db2u/sshkeys-db2uadm": "[secure]", "db2u/sshkeys-db2uhausr": "[secure]", "kubectl.kubernetes.io/last-applied-configuration": "{\"apiVersion\":\"db2u.databases.ibm.com/v1\",\"kind\":\"Db2uInstance\",\"metadata\":{\"name\":\"db2w-shared\",\"namespace\":\"db2u\"},\"spec\":{\"account\":{\"imagePullSecrets\":[\"ibm-registry\"],\"securityConfig\":{\"privilegedSysctlInit\":true}},\"advOpts\":{\"timezone\":\"Asia/Seoul\"},\"environment\":{\"databases\":[{\"dbConfig\":{\"APPLHEAPSZ\":\"8192 AUTOMATIC\"},\"name\":\"BLUDB\",\"settings\":{\"dftTableOrg\":\"ROW\"}}],\"dbType\":\"db2wh\",\"instance\":{\"registry\":{\"DB2AUTH\":\"OSAUTHDB,ALLOW_LOCAL_FALLBACK,PLUGIN_AUTO_RELOAD\",\"DB2_4K_DEVICE_SUPPORT\":\"ON\",\"DB2_FMP_RUN_AS_CONNECTED_USER\":\"NO\",\"DB2_WORKLOAD\":\"ANALYTICS\"}},\"partitionConfig\":{\"total\":1},\"ssl\":{\"allowSslOnly\":true,\"certLabel\":\"CN=db2u\",\"secretName\":\"db2u-certificate-db2w-shared\"}},\"license\":{\"accept\":true},\"nodes\":1,\"podTemplate\":{\"db2u\":{\"resource\":{\"db2u\":{\"limits\":{\"cpu\":\"6000m\",\"memory\":\"16Gi\"},\"requests\":{\"cpu\":\"4000m\",\"memory\":\"8Gi\"}}}}},\"storage\":[{\"name\":\"meta\",\"spec\":{\"accessModes\":[\"ReadWriteOnce\"],\"resources\":{\"requests\":{\"storage\":\"10Gi\"}},\"storageClassName\":\"lvms-vg1-immediate\"},\"type\":\"create\"},{\"name\":\"backup\",\"spec\":{\"accessModes\":[\"ReadWriteMany\"],\"resources\":{\"requests\":{\"storage\":\"50Gi\"}},\"storageClassName\":\"lvms-vg1-immediate\"},\"type\":\"create\"},{\"name\":\"data\",\"spec\":{\"accessModes\":[\"ReadWriteOnce\"],\"resources\":{\"requests\":{\"storage\":\"50Gi\"}},\"storageClassName\":\"lvms-vg1-immediate\"},\"type\":\"template\"},{\"name\":\"tempts\",\"spec\":{\"accessModes\":[\"ReadWriteOnce\"],\"resources\":{\"requests\":{\"storage\":\"10Gi\"}},\"storageClassName\":\"lvms-vg1-immediate\"},\"type\":\"template\"},{\"name\":\"activelogs\",\"spec\":{\"accessModes\":[\"ReadWriteOnce\"],\"resources\":{\"requests\":{\"storage\":\"10Gi\"}},\"storageClassName\":\"lvms-vg1-immediate\"},\"type\":\"template\"},{\"name\":\"auditlogs\",\"spec\":{\"accessModes\":[\"ReadWriteOnce\"],\"resources\":{\"requests\":{\"storage\":\"10Gi\"}},\"storageClassName\":\"\"},\"type\":\"template\"},{\"name\":\"archivelogs\",\"spec\":{\"accessModes\":[\"ReadWriteMany\"],\"resources\":{\"requests\":{\"storage\":\"10Gi\"}},\"storageClassName\":\"\"},\"type\":\"create\"}],\"version\":\"s12.1.4.0\"}}"}, "creationTimestamp": "2026-08-31T05:49:10Z", "generation": 31, "managedFields": [{"apiVersion": "db2u.databases.ibm.com/v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:metadata": {"f:annotations": {".": {}, "f:kubectl.kubernetes.io/last-applied-configuration": {}}}, "f:spec": {".": {}, "f:account": {".": {}, "f:imagePullSecrets": {}, "f:securityConfig": {".": {}, "f:privilegedSysctlInit": {}}}, "f:advOpts": {".": {}, "f:timezone": {}}, "f:environment": {".": {}, "f:databases": {}, "f:dbType": {}, "f:instance": {".": {}, "f:registry": {".": {}, "f:DB2AUTH": {}, "f:DB2_4K_DEVICE_SUPPORT": {}, "f:DB2_FMP_RUN_AS_CONNECTED_USER": {}, "f:DB2_WORKLOAD": {}}}, "f:partitionConfig": {".": {}, "f:total": {}}, "f:ssl": {".": {}, "f:allowSslOnly": {}, "f:certLabel": {}}}, "f:license": {".": {}, "f:accept": {}}, "f:nodes": {}, "f:podTemplate": {".": {}, "f:db2u": {".": {}, "f:resource": {".": {}, "f:db2u": {".": {}, "f:limits": {".": {}, "f:memory": {}}, "f:requests": {".": {}, "f:memory": {}}}}}}, "f:storage": {}, "f:version": {}}}, "manager": "OpenAPI-Generator", "operation": "Update", "time": "2026-09-01T00:08:47Z"}, {"apiVersion": "db2u.databases.ibm.com/v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:metadata": {"f:annotations": {"f:db2u/certs-api-cert": {}, "f:db2u/certs-api-key": {}, "f:db2u/certs-wv-rest": {}, "f:db2u/license": {}, "f:db2u/sshkeys-db2instusr": {}, "f:db2u/sshkeys-db2uadm": {}, "f:db2u/sshkeys-db2uhausr": {}}}, "f:spec": {"f:addOns": {}, "f:environment": {"f:authentication": {".": {}, "f:ldap": {".": {}, "f:blueAdminPassword": {".": {}, "f:value": {}}, "f:enabled": {}, "f:password": {".": {}, "f:value": {}}}}, "f:instance": {"f:password": {".": {}, "f:value": {}}}, "f:partitionConfig": {"f:dataOnMln0": {}, "f:volumePerPartition": {}}, "f:ssl": {"f:secretName": {}}}}}, "manager": "manager", "operation": "Update", "time": "2026-09-01T00:08:47Z"}, {"apiVersion": "db2u.databases.ibm.com/v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:spec": {"f:podTemplate": {"f:db2u": {"f:resource": {"f:db2u": {"f:limits": {"f:cpu": {}}, "f:requests": {"f:cpu": {}}}}}}}}, "manager": "Mozilla", "operation": "Update", "time": "2026-09-01T00:09:23Z"}, {"apiVersion": "db2u.databases.ibm.com/v1", "fieldsType": "FieldsV1", "fieldsV1": {"f:status": {".": {}, "f:conditions": {}, "f:maintenanceState": {}, "f:state": {}, "f:version": {}}}, "manager": "manager", "operation": "Update", "subresource": "status", "time": "2026-09-01T00:11:40Z"}], "name": "db2w-shared", "namespace": "db2u", "resourceVersion": "4211352", "uid": "bb872d49-1bcc-4b1d-9395-5f3dbcf13976"}, "spec": {"account": {"imagePullSecrets": ["ibm-registry"], "securityConfig": {"privilegedSysctlInit": true}}, "addOns": {}, "advOpts": {"timezone": "Asia/Seoul"}, "environment": {"authentication": {"ldap": {"blueAdminPassword": {"value": "[secure]"}, "enabled": true, "password": {"value": "[secure]"}}}, "databases": [{"dbConfig": {"APPLHEAPSZ": "8192 AUTOMATIC"}, "name": "BLUDB", "settings": {"dftTableOrg": "ROW"}}], "dbType": "db2wh", "instance": {"password": {"value": "[secure]"}, "registry": {"DB2AUTH": "OSAUTHDB,ALLOW_LOCAL_FALLBACK,PLUGIN_AUTO_RELOAD", "DB2_4K_DEVICE_SUPPORT": "ON", "DB2_FMP_RUN_AS_CONNECTED_USER": "NO", "DB2_WORKLOAD": "ANALYTICS"}}, "partitionConfig": {"dataOnMln0": true, "total": 1, "volumePerPartition": true}, "ssl": {"allowSslOnly": true, "certLabel": "CN=db2u", "secretName": "[secure]"}}, "license": {"accept": true}, "nodes": 1, "podTemplate": {"db2u": {"resource": {"db2u": {"limits": {"cpu": "2", "memory": "16Gi"}, "requests": {"cpu": "2", "memory": "8Gi"}}}}}, "storage": [{"name": "meta", "spec": {"accessModes": ["ReadWriteOnce"], "resources": {"requests": {"storage": "10Gi"}}, "storageClassName": "lvms-vg1-immediate"}, "type": "create"}, {"name": "backup", "spec": {"accessModes": ["ReadWriteMany"], "resources": {"requests": {"storage": "50Gi"}}, "storageClassName": "lvms-vg1-immediate"}, "type": "create"}, {"name": "data", "spec": {"accessModes": ["ReadWriteOnce"], "resources": {"requests": {"storage": "50Gi"}}, "storageClassName": "lvms-vg1-immediate"}, "type": "template"}, {"name": "tempts", "spec": {"accessModes": ["ReadWriteOnce"], "resources": {"requests": {"storage": "10Gi"}}, "storageClassName": "lvms-vg1-immediate"}, "type": "template"}, {"name": "activelogs", "spec": {"accessModes": ["ReadWriteOnce"], "resources": {"requests": {"storage": "10Gi"}}, "storageClassName": "lvms-vg1-immediate"}, "type": "template"}, {"name": "auditlogs", "spec": {"accessModes": ["ReadWriteOnce"], "resources": {"requests": {"storage": "10Gi"}}, "storageClassName": ""}, "type": "template"}, {"name": "archivelogs", "spec": {"accessModes": ["ReadWriteMany"], "resources": {"requests": {"storage": "10Gi"}}, "storageClassName": ""}, "type": "create"}], "version": "s12.1.4.0"}, "status": {"conditions": [{"lastTransitionTime": "2026-08-31T05:49:17Z", "message": "OK", "reason": "ReconcilingDueToPhaseChange", "status": "True", "type": "FormationStatus"}], "maintenanceState": "None", "state": "Ready", "version": "s12.1.4.0"}}]}

TASK [ibm.mas_devops.db2 : Set detected deployment type] ***********************
ok: [localhost] => {"ansible_facts": {"detected_db2u_kind": "db2uinstance"}, "changed": false}

TASK [ibm.mas_devops.db2 : Debug deployment type information] ******************
ok: [localhost] => {
    "msg": [
        "Requested DB2U_KIND .................... db2ucluster",
        "Detected deployment type ............... db2uinstance",
        "Existing Db2uCluster count ............. 0",
        "Existing Db2uInstance count ............ 1"
    ]
}

TASK [ibm.mas_devops.db2 : Validate DB2U_KIND matches existing deployment] *****
[ERROR]: Task failed: Action failed: DB2U_KIND MISMATCH DETECTED!

Requested DB2U_KIND: db2ucluster
Existing deployment: db2uinstance
Namespace:           db2u

ERROR: Cannot change deployment type during upgrade.

RESOLUTION:
- To upgrade existing Db2uCluster: Set DB2U_KIND=db2ucluster
- To upgrade existing Db2uInstance: Set DB2U_KIND=db2uinstance

Origin: /opt/app-root/lib64/python3.12/site-packages/ansible_collections/ibm/mas_devops/roles/db2/tasks/upgrade/main.yml:57:3

55 # 4. Validate DB2U_KIND matches existing deployment
56 # -------------------------------------------------------------------------
57 - name: "Validate DB2U_KIND matches existing deployment"
     ^ column 3

fatal: [localhost]: FAILED! => {
    "assertion": "db2u_kind == detected_db2u_kind",
    "changed": false,
    "evaluated_to": false,
    "msg": "DB2U_KIND MISMATCH DETECTED!\n\nRequested DB2U_KIND: db2ucluster\nExisting deployment: db2uinstance\nNamespace:           db2u\n\nERROR: Cannot change deployment type during upgrade.\n\nRESOLUTION:\n- To upgrade existing Db2uCluster: Set DB2U_KIND=db2ucluster\n- To upgrade existing Db2uInstance: Set DB2U_KIND=db2uinstance\n"
}

PLAY RECAP *********************************************************************
localhost                  : ok=8    changed=0    unreachable=0    failed=1    skipped=1    rescued=0    ignored=0