Post Upgrade Steps

The following actions must be taken to avoid any post-migration errors listed below.

  1. Loss of Mongo replica set priority configurations
    During installation, mongodb is freshly set up with the latest upgraded versions. The previous replicaset configurations such as replicaset priorities will not be taken ahead and hence have to be re-configured. High latency customers must perform the following step:
    1. Configure the parameters OPTIMISE_ROUTING_FOR_LATENCY and PREFERRED_DEFAULT_DC in the appviewx.conf
    2. Re-trigger the plugins_install.sh to change the configurations.
  2. Custom changes

    If the custom_changes.yaml, custom_vm_args.conf are present and updated in the custom changes, then the custom changes will be persistent. Any of the custom changes that may have been done specifically for the customer as noted in the prerequisites will not be present if the above mentioned files are not updated with this configuration.

  3. External web cert is not upgraded from 2022.1.0 to 2023.1.0

    To update the external CA web certificate, execute the command below:

    ./appviewx.sh --update-web-cert
    The following prompts will be displayed:
    • Enter the absolute path of external cert file:
    • Enter the absolute path of external key file:

    Enter both the values to proceed. Once the cert upgrade is completed, restart the gateway and web.

  4. Set the ELASTIC_ENABLE as True in the Statistics Configuration. There are two ways to do it, choose from either the command prompt (a) or from the management console UI (b).
    Note: Elastic insight must be reinstalled. Application upgrade will take care of installing insight if it's already there in the existing setup, but this won't be taken care automatically in the fresh install. Hence, install insight before step b.
    1. Execute the command
      kubectl edit configmaps -n <Datacenter1>
      Search for the keyword as Elastic and set ELASTIC_ENABLE as True and below params should have default values as below
      ELASTIC_ENABLE=TRUE
      ELASTIC_CLUSTER_NAME=elasticsearch
      ELASTIC_HOST=elasticsearch-insight.statistics.svc.cluster.local
      ELASTIC_PORT=9200
      ELASTIC_HTTPS=FALSE
      ELASTIC_TRANSPORT_PORT=9300
      
    2. Login to management console >> Search for the namespace with the configured DC >> Search for avx-common-config in config maps >> Click on Edit and search for Elastic >> Set as True and give as update as shown below.