Version: 7.8

Upgrade on a Kubernetes environment

The Axiomatics Services Manager (ASM) upgrading process can only be performed between two consecutive minor versions, meaning that you must be running version 7.7 in order to upgrade to version 7.8. Patching, however, is possible in between any two 7.8 patches.

note

Upgrading or patching ASM will cause downtime for the application and consequently a temporary loss of service. As a result, the upgrade should be planned accordingly.

The instructions below apply to both local and cloud environments when upgrading or patching ASM.

Download the ASM 7.8 distribution.

aws s3api get-object --bucket axiomatics-customer-artifacts --key releases/com/axiomatics/axiomatics-services-manager/axiomatics-services-manager/7.8.4-0/axiomatics-services-manager-7.8.4-0.zip axiomatics-services-manager-7.8.4-0.zip

Extract the contents of the downloaded ZIP file.

tip
Optionally, if you want to build your own images, navigate to the docker/ folder and build the images following the instructions provided here. This also applies if you are using custom Attribute Connectors, including the older http-pip and/or parser-pip.
Navigate to the kubernetes folder and add the axiomatics_ASM.license license file.
Open the kubernetes/asmcharts/values.yaml file and set the appropriate configuration values that correspond to the original installation.

tip
Alternatively, you can skip this step and use the --set flag in the command below to pass directly the appropriate configuration values.
If the asm-core-credentials secret does not already exist, create it.
```
kubectl create secret generic asm-core-credentials \
 --from-literal=clientSecret=<ASM_CORE_CLIENT_SECRET> \
 -n axiomatics-asm
```
note
Replace <ASM_CORE_CLIENT_SECRET> with the OAuth2 client secret for the asm-core Keycloak client. This value must match the client secret configured in the Keycloak realm. You can find it in Keycloak Admin Console under Clients > asm-core > Credentials > Client Secret.

Upgrade the Helm charts.

helm upgrade -n axiomatics-asm asm -f asmcharts/values.yaml asmcharts