Upgrade from 8.2 to 8.2.0.1 Using Offline Bundles.

1. Upgrade From 8.2 to 8.2.0.1 Using Offline Bundles

RDAF Platform: From 8.2 to 8.2.0.1(Selected Services)
OIA (AIOps) Application: From 8.2 to 8.2.0.1(Selected Services)
RDAF Deployment rdaf CLI: From 1.5.0 to 1.5.0.1
RDAF Client rdac CLI: From 8.2 to 8.2.0.1

2. Prerequisites

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

RDAF Deployment CLI version: 1.5.0
Infra Services tag: 1.0.4
Platform Services and RDA Worker tag: 8.2
OIA Application Services tag: 8.2
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 Administration → Organization → 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.

Example Output

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.

Without Internet Access

Download the RDAF Deployment CLI's newer version 1.5.0 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.0.1/offline-ubuntu-1.5.0.1.tar.gz

Extract the rdaf CLI software bundle contents

tar -xvzf offline-ubuntu-1.5.0.1.tar.gz

Change the directory to the extracted directory

cd offline-ubuntu-1.5.0.1

Upgrade the rdafCLI to version 1.5.0

pip install --user rdafcli-1.5.0.1.tar.gz -f ./ --no-index

Verify the installed rdaf CLI version

rdaf --version

Example Output

RDAF CLI version: 1.5.0.1

3.2 Python Script Upgrade Steps

KubernetesNon-Kubernetes

Please download the below given python script

Note

This is applicable only in environments where Agentic AI is deployed and specifically for HA deployments.

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/rdaf-platform/1.5.0.1/pre_upgrade.py

Please run the below python upgrade script

python pre_upgrade.py upgrade

Example Output

Successfully scaled rda-portal to 2

Please download the below python script (rdaf_upgrade_150_1501.py)

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/rdaf-platform/1.5.0.1/rdaf_upgrade_150_1501.py

Please run the downloaded python upgrade script rdaf_upgrade_150_1501.py as shown below

python rdaf_upgrade_150_1501.py -h

Note

The above command will show the available options for the upgrade script

rdauser@infra108122:~$ python rdaf_upgrade_150_1501.py -h
usage: rdaf_upgrade_150_1501.py [-h] {upgrade} ...

options:
-h, --help  show this help message and exit

options:
{upgrade}   Available options
    upgrade   upgrade the setup

This below given command will execute the upgrade process after user has downloaded the script and reviewed the available options with the help command.

python rdaf_upgrade_150_1501.py upgrade

Example Output

Portal token updated for user creation (sub=portal_token).
Admin user already exists; platform UI is accessible.
Processing nginx.conf on host 192.168.108.114
/opt/rdaf/config/nginx_config/nginx.conf does not exist, skipping changes
Processing nginx.conf on host 192.168.108.115
/opt/rdaf/config/nginx_config/nginx.conf does not exist, skipping changes

Please download the below given python script

Note

This is applicable only in environments where Agentic AI is deployed and specifically for HA deployments.

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/rdaf-platform/1.5.0.1/pre_upgrade.py

Please run the below python upgrade script

python pre_upgrade.py upgrade

Example Output

Creating backup of existing haproxy.cfg on host 192.168.133.60
Restarting HAProxy on host: 192.168.133.60
Container infra-haproxy-1  Restarting
Container infra-haproxy-1  Started

HAProxy restarted successfully on 192.168.133.60
Creating backup of existing haproxy.cfg on host 192.168.133.61
Restarting HAProxy on host: 192.168.133.61
[+] Restarting 1/1
✔ Container infra-haproxy-1  Started                                     10.6s

HAProxy restarted successfully on 192.168.133.61

Please download the below python script (rdaf_upgrade_150_1501.py)

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/rdaf-platform/1.5.0.1/rdaf_upgrade_150_1501.py

Please run the downloaded python upgrade script rdaf_upgrade_150_1501.py as shown below

python rdaf_upgrade_150_1501.py -h

Note

The above command will show the available options for the upgrade script

rdauser@infra108122:~$ python rdaf_upgrade_150_1501.py -h
usage: rdaf_upgrade_150_1501.py [-h] {upgrade} ...

options:
-h, --help  show this help message and exit

options:
{upgrade}   Available options
    upgrade   upgrade the setup

This below given command will execute the upgrade process after user has downloaded the script and reviewed the available options with the help command.

Note

When an infra node goes down and the VM is restarted, GraphDB does not start automatically. The script below addresses this issue by ensuring GraphDB starts properly.

python rdaf_upgrade_150_1501.py upgrade

Example Output

Portal token updated for user creation (sub=portal_token).
Admin user already exists; platform UI is accessible.
Processing nginx.conf on host 192.168.133.60
/opt/rdaf/config/nginx_config/nginx.conf does not exist, skipping changes
Processing nginx.conf on host 192.168.133.61
/opt/rdaf/config/nginx_config/nginx.conf does not exist, skipping changes

4. Fetching Latest Tags

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

Please download the following tar files.

wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/cfx-onprem-portal-dbinit.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/cfx-onprem-portal.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/onprem-portal-nginx.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/cfx-rda-access-manager.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/cfx-rda-alert-processor.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/cfx-rda-collaboration.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/cfx-rda-resource-manager.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-rda-bulkstats.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-cfxdx-nb-nginx-all.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-rda-chat-helper.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-rda-client-api-server.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-rda-collector.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-rda-event-gateway.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-rda-scheduler.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-rda-worker-all.tar.gz
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.1/ubuntu-rdac.tar.gz

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

Example

rdaf registry import --file cfx-onprem-portal-dbinit.tar.gz
rdaf registry import --file cfx-onprem-portal.tar.gz
rdaf registry import --file onprem-portal-nginx.tar.gz
rdaf registry import --file cfx-rda-access-manager.tar.gz
rdaf registry import --file cfx-rda-alert-processor.tar.gz
rdaf registry import --file cfx-rda-collaboration.tar.gz
rdaf registry import --file cfx-rda-resource-manager.tar.gz
rdaf registry import --file ubuntu-rda-bulkstats.tar.gz
rdaf registry import --file ubuntu-cfxdx-nb-nginx-all.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-event-gateway.tar.gz
rdaf registry import --file ubuntu-rda-scheduler.tar.gz
rdaf registry import --file ubuntu-rda-worker-all.tar.gz
rdaf registry import --file ubuntu-rdac.tar.gz

To view the list of tags available in the registry, use the below given command

rdaf registry list-tags

Example

+------------------------------------------+--------------------------------------------------+
| Service-Name                             | Tags                                             |
+------------------------------------------+--------------------------------------------------+
| ubuntu-cfxdx-nb-nginx-all                | 8.2.0.1                                          |
| ubuntu-rda-collector                     | 8.2.0.1                                          |
| ubuntu-rda-chat-helper                   | 8.2.0.1                                          |
| cfx-onprem-portal                        | 8.2.0.1                                          |
| ubuntu-rdac                              | 8.2.0.1                                          |
| cfx-rda-collaboration                    | 8.2.0.1                                          |
| cfx-rda-alert-processor                  | 8.2.0.1                                          |
| cfx-rda-access-manager                   | 8.2.0.1                                          |
| cfx-rda-resource-manager                 | 8.2.0.1                                          |
| cfx-onprem-portal-dbinit                 | 8.2.0.1                                          |
| ubuntu-rda-client-api-server             | 8.2.0.1                                          |
| onprem-portal-nginx                      | 8.2.0.1                                          |
| ubuntu-rda-bulkstats                     | 8.2.0.1                                          |
| ubuntu-rda-worker-all                    | 8.2.0.1                                          |
| ubuntu-rda-scheduler                     | 8.2.0.1                                          |
| ubuntu-rda-event-gateway                 | 8.2.0.1                                          |
+------------------------------------------+--------------------------------------------------+

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 proceed with the full upgrade following the instructions in this Document