Skip to content

Offline upgrade 8.1.0.x to 8.1.0.6

1. Upgrade From 8.1.0.x to 8.1.0.6 Using Offline Bundles

RDAF Platform: From 8.1.0.x to 8.1.0.6 (Selected Services)

RDAF Deployment rdaf CLI: From 1.4.1 to 1.4.1.2

OIA (AIOps) Application: From 8.1.0.x to 8.1.0.6 (Selected Services)

2. Prerequisites

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

  • RDAF Deployment CLI version: 1.4.1

  • Infra Services tag: 1.0.4

  • Platform Services and RDA Worker tag: 8.1.0.x

  • OIA Application Services tag: 8.1.0.x

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

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. Upgrade Steps

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.4.1.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.4.1.2/offline-ubuntu-1.4.1.2.tar.gz
  • Extract the rdaf CLI software bundle contents
tar -xvzf offline-ubuntu-1.4.1.2.tar.gz
  • Change the directory to the extracted directory
cd offline-ubuntu-1.4.1.2
  • Upgrade the rdafCLI to version 1.4.1.2
pip install --user rdafcli-1.4.1.2.tar.gz -f ./ --no-index
  • Verify the installed rdaf CLI version
rdaf --version
RDAF CLI version: 1.4.1.2

3.2 Python Script Upgrade Steps

Please download the below python script (rdaf_upgrade_1411_1412.py)

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

This below given command will execute the upgrade process after user has downloaded the script.

python rdaf_upgrade_1411_1412.py upgrade
rdauser@infra108122:~$ python rdaf_upgrade_1411_1412.py upgrade
Creating backup of haproxy.cfg on 192.168.108.122
Updating haproxy configuration on 192.168.108.122
HAProxy configuration updated on 192.168.108.122
Creating backup of haproxy.cfg on 192.168.108.123
Updating haproxy configuration on 192.168.108.123
HAProxy configuration updated on 192.168.108.123
Creating backup of my_custom.cnf on 192.168.108.122
Updating MariaDB configuration on 192.168.108.122
MariaDB configuration updated on 192.168.108.122
Creating backup of my_custom.cnf on 192.168.108.123
Updating MariaDB configuration on 192.168.108.123
MariaDB configuration updated on 192.168.108.123
Creating backup of my_custom.cnf on 192.168.108.124
Updating MariaDB configuration on 192.168.108.124
MariaDB configuration updated on 192.168.108.124
rdauser@infra108122:~$ 

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.1.0.6/cfx-rda-access-manager.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/cfx-rda-alert-processor.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/cfx-rda-app-controller.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/cfx-onprem-portal-dbinit.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/cfx-onprem-portal.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/onprem-portal-nginx.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/cfx-rda-irm-service.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/ubuntu-cfxdx-nb-nginx-all.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/ubuntu-rda-client-api-server.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/ubuntu-rda-collector.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/ubuntu-rda-fsm.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/ubuntu-rda-scheduler.tar.gz
    wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.1.0.6/ubuntu-rda-worker-all.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>
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-app-controller.tar.gz
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-irm-service.tar.gz
rdaf registry import --file ubuntu-cfxdx-nb-nginx-all.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-fsm.tar.gz
rdaf registry import --file ubuntu-rda-scheduler.tar.gz
rdaf registry import --file ubuntu-rda-worker-all.tar.gz
  • To view the list of tags available in the registry, use the below given command
rdaf registry list-tags 
+-------------------------------------+---------+
| Service-Name                        | Tags    |
|-------------------------------------|---------|
| cfx-rda-access-manager              | 8.1.0.6 |
| cfx-rda-alert-processor             | 8.1.0.6 |
| cfx-rda-app-controller              | 8.1.0.6 |
| cfx-onprem-portal-dbinit            | 8.1.0.6 |
| cfx-onprem-portal                   | 8.1.0.6 |
| onprem-portal-nginx                 | 8.1.0.6 |
| cfx-rda-irm-service                 | 8.1.0.6 |
| ubuntu-cfxdx-nb-nginx-all           | 8.1.0.6 |
| ubuntu-rda-client-api-server        | 8.1.0.6 |
| ubuntu-rda-collector                | 8.1.0.6 |
| ubuntu-rda-fsm                      | 8.1.0.6 |
| ubuntu-rda-scheduler                | 8.1.0.6 |
| ubuntu-rda-worker-all               | 8.1.0.6 |
+-------------------------------------+---------+
  • 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