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.5 in order to upgrade to version 7.6. Patching, however, is possible in between any two 7.6 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.

1. For cloud installations only, if you are upgrading ASM, update PostgreSQL to version 15.4 following the instructions in the AWS documentation.

2. Download the ASM 7.6 distribution.

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

3. 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.

4. Navigate to the kubernetes folder and add the axiomatics_ASM.license license file.

5. 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.

6. Upgrade the Helm charts.

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