Skip to main content
Version: 7.5

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

Important

For local installations only, it is crucial to backup your system before proceeding with an ASM upgrade due to a major PostgreSQL update. Failing to do so will lead to data loss and and render the system inoperable.

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

    aws s3api get-object --bucket axiomatics-customer-artifacts --key releases/com/axiomatics/axiomatics-services-manager/axiomatics-services-manager/7.5.0-0/axiomatics-services-manager-7.5.0-0.zip axiomatics-services-manager-7.5.0-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

  7. For local installations only, if you are upgrading ASM, restore your backed up data.