Chapter 3. Upgrading AMQ Online

AMQ Online supports upgrades between minor versions using cloud-native tools. When upgrading, applying the configuration change automatically triggers the upgrade process to begin.

Using the same method that was used to initially install AMQ Online to upgrade to a newer version of AMQ Online is recommended.

Upgrading AMQ Online is accomplished by applying the YAML files for the new version.

3.1. Upgrading AMQ Online using a YAML bundle

Prerequisites

Procedure

  1. Log in as a service operator:

    oc login -u system:admin
  2. Select the project where AMQ Online is installed:

    oc project amq-online-infra
  3. Apply the new release bundle:

    oc apply -f install/bundles/amq-online
  4. Monitor pods while they are restarted:

    oc get pods -w

    The pods restart and become active within several minutes.

  5. Delete api-server resources not needed after upgrade:

    oc delete sa api-server -n amq-online-infra
    oc delete clusterrolebinding enmasse.io:api-server-amq-online-infra
    oc delete clusterrole enmasse.io:api-server
    oc delete rolebinding api-server -n amq-online-infra
    oc delete role enmasse.io:api-server -n amq-online-infra

3.2. Upgrading AMQ Online using Ansible

Prerequisites

Procedure

  1. Log in as a service operator:

    oc login -u system:admin
  2. Run the Ansible playbook from the new release:

    ansible-playbook -i inventory-file ansible/playbooks/openshift/deploy_all.yml
  3. Monitor pods while they are restarted:

    oc get pods -w

    The pods restart and become active within several minutes.

  4. Delete api-server resources not needed after upgrade:

    oc delete sa api-server -n amq-online-infra
    oc delete clusterrolebinding enmasse.io:api-server-amq-online-infra
    oc delete clusterrole enmasse.io:api-server
    oc delete rolebinding api-server -n amq-online-infra
    oc delete role enmasse.io:api-server -n amq-online-infra