Preparing for software upgrade

Use this procedure to prepare for the software upgrade from Fabric Services System 22.8.x to Fabric Services System 22.8.y (where y > x).
  1. Display system information and status.
    Log in to the deployer VM using SSH.
    1. Verify that the Helm charts are running the current release.
      [root@fss-deployer ~]# export KUBECONFIG=/var/lib/fss/config.fss
      [root@fss-deployer ~]# helm list
      NAME    NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                                   APP VERSION
      prod    default         1               2022-10-27 17:53:04.124504577 +0000 UTC deployed        fss-FSS_22_8_B1-charts-v22.8.1-108      1.0
    2. Verify that the pods are all up and running.
      [root@fss-deployer ~]# kubectl get pods
      NAME                                                   READY   STATUS    RESTARTS        AGE
      prod-cp-kafka-0                                        2/2     Running   2 (6m31s ago)   9m10s
      prod-cp-kafka-1                                        2/2     Running   1 (6m45s ago)   8m5s
      prod-cp-kafka-2                                        2/2     Running   0               7m29s
      prod-cp-zookeeper-0                                    2/2     Running   0               9m10s
      prod-cp-zookeeper-1                                    2/2     Running   0               7m14s
      prod-cp-zookeeper-2                                    2/2     Running   0               6m51s
      prod-fss-alarmmgr-6678f4d49c-xz77v                     1/1     Running   0               9m7s
      prod-fss-auth-79ff5f495c-s4t7m                         1/1     Running   0               9m6s
      prod-fss-catalog-7658bc4ccf-wp7vn                      1/1     Running   0               9m9s
      prod-fss-cfggen-5d8f94f74b-57nd7                       1/1     Running   0               9m7s
      prod-fss-cfgsync-5b69b7f854-l9lx5                      1/1     Running   0               9m8s
      prod-fss-connect-75df8ff7f9-vwfgj                      1/1     Running   0               9m7s
      prod-fss-da-69f8676b6d-4kjsn                           1/1     Running   0               9m8s
      prod-fss-da-69f8676b6d-cp5v6                           1/1     Running   0               9m9s
      prod-fss-da-69f8676b6d-fj7db                           1/1     Running   0               9m8s
      prod-fss-da-69f8676b6d-mnz9b                           1/1     Running   0               9m8s
      prod-fss-da-69f8676b6d-ph42r                           1/1     Running   0               9m8s
      prod-fss-da-69f8676b6d-vgflj                           1/1     Running   0               9m9s
      prod-fss-da-69f8676b6d-zg2pb                           1/1     Running   0               9m9s
      prod-fss-da-69f8676b6d-zt7z6                           1/1     Running   0               9m8s
      prod-fss-deviationmgr-acl-d8949f794-2dl79              1/1     Running   0               9m8s
      prod-fss-deviationmgr-bfd-68f5d7988b-q8vks             1/1     Running   0               9m6s
      prod-fss-deviationmgr-interface-769c5d46f-l9wrc        1/1     Running   0               9m6s
      prod-fss-deviationmgr-netinst-6f455d75d5-gqftv         1/1     Running   0               9m9s
      prod-fss-deviationmgr-platform-589dd98c4f-l67dp        1/1     Running   0               9m10s
      prod-fss-deviationmgr-qos-567cbfc7ff-twblt             1/1     Running   0               9m6s
      prod-fss-deviationmgr-routingpolicy-7cbcfc858b-rxf7p   1/1     Running   0               9m10s
      prod-fss-deviationmgr-system-6549bc48ff-2qttp          1/1     Running   0               9m10s
      prod-fss-dhcp-c595df9fc-lx4ln                          1/1     Running   0               9m10s
      prod-fss-filemgr-687fc88b4d-hc8bz                      1/1     Running   0               9m8s
      prod-fss-imagemgr-7555dbbbdc-qb5ns                     1/1     Running   0               9m8s
      prod-fss-intentmgr-78fcdf84df-fzmzm                    1/1     Running   0               9m7s
      prod-fss-inventory-58f8579d6f-whbmf                    1/1     Running   0               9m6s
      prod-fss-labelmgr-7db67c68cf-482kw                     1/1     Running   0               9m10s
      prod-fss-maintmgr-76d755c8cc-m6njl                     1/1     Running   0               9m7s
      prod-fss-mgmtstack-68b8fc9fdf-6xt7f                    1/1     Running   0               9m10s
      prod-fss-oper-da-6556b58fc5-29tw6                      1/1     Running   0               9m10s
      prod-fss-oper-da-6556b58fc5-789nx                      1/1     Running   0               9m10s
      prod-fss-oper-da-6556b58fc5-bpnvg                      1/1     Running   0               9m9s
      prod-fss-oper-da-6556b58fc5-bvvkc                      1/1     Running   0               9m9s
      prod-fss-oper-da-6556b58fc5-k7xqz                      1/1     Running   0               9m10s
      prod-fss-oper-da-6556b58fc5-rlqlv                      1/1     Running   0               9m9s
      prod-fss-oper-da-6556b58fc5-wn2bb                      1/1     Running   0               9m9s
      prod-fss-oper-da-6556b58fc5-zvkx2                      1/1     Running   0               9m9s
      prod-fss-oper-topomgr-94b897c4f-r9tjt                  1/1     Running   0               9m5s
      prod-fss-topomgr-77cd566695-5w5mx                      1/1     Running   0               9m8s
      prod-fss-transaction-5756574f99-clfv5                  1/1     Running   0               9m6s
      prod-fss-version-b565f896-kcktt                        1/1     Running   0               9m10s
      prod-fss-web-5d5bbf4c67-gd6bf                          1/1     Running   0               9m9s
      prod-fss-workloadmgr-c99db6bb6-fft5q                   1/1     Running   0               9m10s
      prod-fss-ztp-59675c6ffd-pzpxj                          1/1     Running   0               9m10s
      prod-keycloak-0                                        1/1     Running   0               9m10s
      prod-mongodb-arbiter-0                                 1/1     Running   0               9m10s
      prod-mongodb-primary-0                                 1/1     Running   0               9m10s
      prod-mongodb-secondary-0                               1/1     Running   0               9m10s
      prod-neo4j-core-0                                      1/1     Running   0               9m10s
      prod-postgresql-0                                      1/1     Running   0               9m10s
      [root@fss-deployer ~]#
  2. Back up the necessary files from deployer VM.
    Copy the following files to a directory that is outside of the deployer VM:
    • SSH files

      /root/.ssh/id_rsa

      /root/.ssh/id_rsa.pub

      /root/.ssh/known_hosts

    • Input JSON configuration file that was used to install the Fabric Services System, for example:

      /root/customer-input.json

    • The HTTPS related certificate files that were used to install Fabric Services System, for instance:

      /root/tls.crt

      /root/tls.key

    • Optional files

      SRL image tar files that were added to the old deployer VM

  3. Back up the Fabric Services System.

    For instructions, see Backup and restore in the Fabric Services System User Guide.

  4. Shut down the old deployer VM.
    Note: Ensure that the old deployer VM is not configured to automatically restart.
  5. Create a new deployer VM using the image for the new release.
    For instructions, see Fabric Services System deployer VM creation. The new deployer should have the same network configuration and the same IP address of old deployer VM.
  6. Copy the files that you saved in Step 2 to the new deployer VM in the same locations.
Performing a software upgrade