Skip to content

Upgrade From 8.2.1 to 8.2.2 Using Offline Bundles.

1. Upgrade From 8.2.1 to 8.2.2 Using Offline Bundles

  • RDAF Infra Upgrade: 1.0.4

  • RDAF Platform: From From 8.2.1 / 8.2.1.0.1 (Selected Services) to 8.2.2

  • OIA (AIOps) Application: From From 8.2.1 / 8.2.1.0.1 (Selected Services) to 8.2.2

  • RDAF Deployment rdaf CLI: From 1.5.1 to 1.5.2

  • RDAF Client rdac CLI: From 8.2.1 to 8.2.2

2. Prerequisites

Before proceeding with this upgrade, please make sure and verify the below prerequisites are met.

  • RDAF Deployment CLI version: 1.5.1

  • Infra Services tag: 1.0.4

  • Platform Services and RDA Worker tag: 8.2.1

  • OIA Application Services tag: 8.2.1

  • CloudFabrix recommends taking VMware VM snapshots where RDA Fabric infra/platform/applications are deployed

Important

  • If the Webhook URL is currently configured with port 7443, it should be updated to port 443. Below are the steps to update Webhook URL:

  • Login to UI → Click on AdministrationOrganization → click on Configure → click on Alert Endpoints → click on required Endpoint and edit to update the port (Note: Please ignore if the Alert Endpoint is already configured with port 443)

3. Upgrade Steps

Note

Check the disk space on all Platform and Service VMs using the following command.

df -kh

Important

Ensure that the highlighted disk size (Use% column) should be less than 50%. If any disk exceeds this percentage, consider taking appropriate actions like cleaning up unused files or expanding storage.

rdauser@oia-125-216:~/collab-3.7-upgrade$ df -kh
Filesystem                         Size  Used Avail Use% Mounted on
udev                                32G     0   32G   0% /dev
tmpfs                              6.3G  357M  6.0G   6% /run
/dev/mapper/ubuntu--vg-ubuntu--lv   48G   12G   34G  26% /
tmpfs                               32G     0   32G   0% /dev/shm
tmpfs                              5.0M     0  5.0M   0% /run/lock
tmpfs                               32G     0   32G   0% /sys/fs/cgroup
/dev/loop0                          64M   64M     0 100% /snap/core20/2318
/dev/loop2                          92M   92M     0 100% /snap/lxd/24061
/dev/sda2                          1.5G  309M  1.1G  23% /boot
/dev/sdf                            50G  3.8G   47G   8% /var/mysql
/dev/loop3                          39M   39M     0 100% /snap/snapd/21759
/dev/sdg                            50G  541M   50G   2% /minio-data
/dev/loop4                          92M   92M     0 100% /snap/lxd/29619
/dev/loop5                          39M   39M     0 100% /snap/snapd/21465
/dev/sde                            15G  140M   15G   1% /zookeeper
/dev/sdd                            30G  884M   30G   3% /kafka-logs
/dev/sdc                            50G  3.3G   47G   7% /opt
/dev/sdb                            50G   29G   22G  57% /var/lib/docker
/dev/sdi                            25G  294M   25G   2% /graphdb
/dev/sdh                            50G   34G   17G  68% /opensearch
/dev/loop6                          64M   64M     0 100% /snap/core20/2379

3.1 RDAF Deployment CLI Upgrade

Note

Upgrade the RDAF Deployment CLI on both the on-premise Docker registry VM and the RDAF Platform's management VM if they are provisioned separately.

Perform these steps on the VM where the RDAF Deployment CLI was installed, whether it is managing Docker registry or non-Kubernetes deployments.

Note

This process ensures the RDAF CLI is upgraded without requiring internet access on the management VM.

  • Download the RDAF Deployment CLI's newer version 1.5.2 bundle and copy it to RDAF management VM on which rdaf deployment CLI was installed.
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/rdaf-platform/1.5.2/offline-ubuntu-1.5.2.tar.gz
  • Extract the rdaf CLI software bundle contents
tar -xvzf offline-ubuntu-1.5.2.tar.gz
  • Change the directory to the extracted directory
cd offline-ubuntu-1.5.2
  • Upgrade the rdafCLI to version 1.5.2
pip install --user rdafcli-1.5.2.tar.gz -f ./ --no-index
  • Verify the installed rdaf CLI version
rdaf --version
RDAF CLI version: 1.5.2

3.2 Fetching Latest Tags

To update to the latest tags, ensure that all files are copied into the directory /opt/rdaf-registry/import.

3.2.1 Fetching Platform Tags

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-access-manager.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-resource-manager.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-user-preferences.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-cfx-app-svc-base-min-ng_311.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-cfx-self-monitor.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-cfxdx-nb-nginx-all.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-asm.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-bulkstats.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-chat-helper.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-client-api-server.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-collector.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-edge-management.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-event-gateway.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-file-object.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-fsm.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-generic-pod-base.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-geodr-api-server.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-geomap-web-service.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-go-base.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-identity.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-playground.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-registry.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-scheduler.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-synthesizer.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rda-worker-all.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu-rdac.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/ubuntu24.04-python312.tar.gz

3.2.2 Fetching Onprem Portal Tags

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-onprem-portal-dbinit.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-onprem-portal.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/onprem-portal-nginx.tar.gz

3.2.3 Fetching SaaS Portal Tags

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfxportaldbinit.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfxportal.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/portalnginx.tar.gz

3.2.4 Fetching OIA Services Tags

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-alert-ingester.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-alert-processor-companion.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-alert-processor.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-app-controller.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-collaboration.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-configuration-service.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-event-consumer.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-file-browser.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-ingestion-tracker.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-irm-service.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-ml-config.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-notification-service.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-reports-registry.tar.gz

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-webhook-server.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/cfx-rda-smtp-server.tar.gz

3.2.5 Fetching Infra Service Tag

Note

Applicable only for External OpenSearch

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.2/rda-platform-opensearch.tar.gz

4. Running the Registry Import to Fetch Tags

  • Use the following command to import each package or tag file into the registry.
rdaf registry import --file <filename>
rdaf registry import --file cfx-onprem-portal-dbinit.tar.gz
rdaf registry import --file cfx-onprem-portal.tar.gz
rdaf registry import --file cfx-rda-access-manager.tar.gz
rdaf registry import --file cfx-rda-alert-ingester.tar.gz
rdaf registry import --file cfx-rda-alert-processor-companion.tar.gz
rdaf registry import --file cfx-rda-alert-processor.tar.gz
rdaf registry import --file cfx-rda-app-controller.tar.gz
rdaf registry import --file cfx-rda-collaboration.tar.gz
rdaf registry import --file cfx-rda-configuration-service.tar.gz
rdaf registry import --file cfx-rda-event-consumer.tar.gz
rdaf registry import --file cfx-rda-file-browser.tar.gz
rdaf registry import --file cfx-rda-ingestion-tracker.tar.gz
rdaf registry import --file cfx-rda-irm-service.tar.gz
rdaf registry import --file cfx-rda-ml-config.tar.gz
rdaf registry import --file cfx-rda-notification-service.tar.gz
rdaf registry import --file cfx-rda-reports-registry.tar.gz
rdaf registry import --file cfx-rda-resource-manager.tar.gz
rdaf registry import --file cfx-rda-smtp-server.tar.gz
rdaf registry import --file cfx-rda-user-preferences.tar.gz
rdaf registry import --file cfxportal.tar.gz
rdaf registry import --file cfxportaldbinit.tar.gz
rdaf registry import --file onprem-portal-nginx.tar.gz
rdaf registry import --file portalnginx.tar.gz
rdaf registry import --file ubuntu-cfx-app-svc-base-min-ng_311.tar.gz
rdaf registry import --file ubuntu-cfx-self-monitor.tar.gz
rdaf registry import --file ubuntu-cfxdx-nb-nginx-all.tar.gz
rdaf registry import --file ubuntu-rda-asm.tar.gz
rdaf registry import --file ubuntu-rda-bulkstats.tar.gz
rdaf registry import --file ubuntu-rda-chat-helper.tar.gz
rdaf registry import --file ubuntu-rda-client-api-server.tar.gz
rdaf registry import --file ubuntu-rda-collector.tar.gz
rdaf registry import --file ubuntu-rda-edge-management.tar.gz
rdaf registry import --file ubuntu-rda-event-gateway.tar.gz
rdaf registry import --file ubuntu-rda-file-object.tar.gz
rdaf registry import --file ubuntu-rda-fsm.tar.gz
rdaf registry import --file ubuntu-rda-generic-pod-base.tar.gz
rdaf registry import --file ubuntu-rda-geodr-api-server.tar.gz
rdaf registry import --file ubuntu-rda-geomap-web-service.tar.gz
rdaf registry import --file ubuntu-rda-go-base.tar.gz
rdaf registry import --file ubuntu-rda-identity.tar.gz
rdaf registry import --file ubuntu-rda-playground.tar.gz
rdaf registry import --file ubuntu-rda-registry.tar.gz
rdaf registry import --file ubuntu-rda-scheduler.tar.gz
rdaf registry import --file ubuntu-rda-synthesizer.tar.gz
rdaf registry import --file ubuntu-rda-worker-all.tar.gz
rdaf registry import --file ubuntu-rdac.tar.gz
rdaf registry import --file ubuntu24.04-python312.tar.gz
rdaf registry import --file rda-platform-opensearch.tar.gz
rdaf registry import --file cfx-rda-webhook-server.tar.gz
  • To view the list of tags available in the registry, use the below given command
rdaf registry list-tags 
rdauser@xxxxofflineregistry108131:/opt/rdaf-registry/import$ rdaf registry list-tags
2026-08-24 13:54:24,772 [rdaf.component.dockerregistrymirror] INFO     - querying for tags of all images...
+------------------------------------------+------------------------------------------------------------------+
| Service-Name                             | Tags                                                             |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-opensearch                  | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-worker-all                    | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rdac-full                         |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| frrouting/frr                            |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-arangodb-starter            | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| metallb/speaker                          |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| cfxcollector                             |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-collaboration                    | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-access-manager                   | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-onprem-portal                        | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-collector                     | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-k8s-haproxy                 |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-smtp-server                      | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rdac                              | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-bulkstats                     | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-file-browser                     | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-nats-server-config-reloader | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-filebeat                    | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-alert-ingester                   | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| mc                                       | RELEASE.2025-08-13T08-35-41Z, RELEASE.2025-08-13T08-35-41Z-cpuv1 |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-telegraf                    |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-file-object                   | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-kube-arangodb               |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-alert-processor                  | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-prometheus-nats-exporter    |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-reports-registry                 | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-registry                      | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-alert-processor-companion        | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-mariadb                     | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-resource-manager                 | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-identity                      | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-fsm                           | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-chat-helper                   | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-kubectl                     |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-ingestion-tracker                | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-geodr-api-server              | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-nginx                       | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-arangodb                    | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-client-api-server             | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-ml-config                        | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-nats                        | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-kafka                       | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| minio                                    | RELEASE.2025-09-07T16-13-09Z                                     |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-haproxy                     | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-event-gateway                 | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-irm-service                      | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-qdrant                      | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-asm                           | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-onprem-portal-dbinit                 | 8.2.2                                                            |--------------------------------------------------------------------------------------------------------------+
| cfx-rda-app-controller                   | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-user-preferences                 | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| onprem-portal-nginx                      | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-busybox                     |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| metallb/controller                       |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-configuration-service            | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-rda-scheduler                     | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-webhook-server                   | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-nats-boot-config            |                                                                  |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-notification-service             | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-cfxdx-nb-nginx-all                | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| cfx-rda-event-consumer                   | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-logstash                    | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| rda-platform-nats-box                    | 1.0.5                                                            |
+------------------------------------------+------------------------------------------------------------------+
| ubuntu-cfx-self-monitor                  | 8.2.2                                                            |
+------------------------------------------+------------------------------------------------------------------+
  • If necessary, kindly remove outdated image tags from the on-premise registry that are no longer in use by executing the following command:
rdaf registry delete-images --tag <tag1,tag2>
  • Please click here for further upgrade steps from 8.2.1 to 8.2.2