Upgrade from 8.2.0.1 to 8.2.0.2 Using Offline Bundles.
1. Upgrade From 8.2.0.1 to 8.2.0.2 Using Offline Bundles
-
RDAF Platform: From 8.2.0.1 to 8.2.0.2(Selected Services)
-
OIA (AIOps) Application: From 8.2.0.1 to 8.2.0.2(Selected Services)
-
RDAF Deployment
rdafCLI: From 1.5.0.1 to 1.5.0.2
2. Prerequisites
Before proceeding with this upgrade, please make sure and verify the below prerequisites are met.
-
RDAF Deployment CLI version: 1.5.0.1
-
Infra Services tag: 1.0.4
-
Platform Services and RDA Worker tag: 8.2.0.1
-
OIA Application Services tag: 8.2.0.1
-
CloudFabrix recommends taking VMware VM snapshots where RDA Fabric infra/platform/applications are deployed
3. Upgrade Steps
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.0.2 bundle and copy it to RDAF management VM on which
rdafdeployment CLI was installed.
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/rdaf-platform/1.5.0.2/offline-ubuntu-1.5.0.2.tar.gz
- Extract the
rdafCLI software bundle contents
- Change the directory to the extracted directory
- Upgrade the
rdafCLI to version 1.5.0.2
- Verify the installed
rdafCLI version
3.2 Python Script Upgrade Steps
Please download the below python script (rdaf_upgrade_1501_1502.py)
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/rdaf-platform/1.5.0.2/rdaf_upgrade_1501_1502.py
This below given command will execute the upgrade process after user has downloaded the script.
rdauser@k8sofflineregistry108113:~$ python rdaf_upgrade_1501_1502.py upgrade
Fetching index name from rdaf_services_logs pstream...
Found pstream index_name: c114a9d904cf41e58cee762e6099f689-stream-rdaf-services-logs
Updating OpenSearch role-log-monitoring...
Applying updated role to OpenSearch host 10.95.108.121...
{"status":"OK","message":"'role-log-monitoring' updated."}
Successfully updated role-log-monitoring.
Please download the below python script (rdaf_upgrade_1501_1502.py)
wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/rdaf-platform/1.5.0.2/rdaf_upgrade_1501_1502.py
This below given command will execute the upgrade process after user has downloaded the script.
rdauser@xxxxxx-infra13360:~$ python rdaf_upgrade_1501_1502.py upgrade
Fetching index name from rdaf_services_logs pstream...
Found pstream index_name: d889fbc0d1fa467fa2cdc1b60860c942-stream-rdaf-services-logs
Updating OpenSearch role-log-monitoring...
Applying updated role to OpenSearch host 192.168.133.60...
{"status":"OK","message":"'role-log-monitoring' updated."}
Successfully updated role-log-monitoring.
Updating /opt/rdaf/logstash/config/pipelines.yml on logstash hosts...
Backed up existing /opt/rdaf/logstash/config/pipelines.yml on 192.168.133.62
Backed up existing /opt/rdaf/logstash/config/pipelines.yml on 192.168.133.63
pipelines.yml update completed.
Updating /opt/rdaf/logstash/pipeline/filebeats_docker.conf on logstash hosts...
Backed up existing /opt/rdaf/logstash/pipeline/filebeats_docker.conf on 192.168.133.62
Backed up existing /opt/rdaf/logstash/pipeline/filebeats_docker.conf on 192.168.133.63
filebeats_docker.conf update completed.
Updating /opt/rdaf/file-beat/config/filebeat.yml on all known hosts...
Backed up existing /opt/rdaf/file-beat/config/filebeat.yml on 192.168.133.65
Backed up existing /opt/rdaf/file-beat/config/filebeat.yml on 192.168.133.66
Backed up existing /opt/rdaf/file-beat/config/filebeat.yml on 192.168.133.63
Backed up existing /opt/rdaf/file-beat/config/filebeat.yml on 192.168.133.61
Backed up existing /opt/rdaf/file-beat/config/filebeat.yml on 192.168.133.60
Backed up existing /opt/rdaf/file-beat/config/filebeat.yml on 192.168.133.64
Backed up existing /opt/rdaf/file-beat/config/filebeat.yml on 192.168.133.62
filebeat.yml update completed.
Removing old /opt/rdaf/file-beat/log_config directory on all hosts...
Removed /opt/rdaf/file-beat/log_config
Removed /opt/rdaf/file-beat/log_config
Removed /opt/rdaf/file-beat/log_config
Removed /opt/rdaf/file-beat/log_config
Removed /opt/rdaf/file-beat/log_config
Removed /opt/rdaf/file-beat/log_config
Removed /opt/rdaf/file-beat/log_config
Cleanup of /opt/rdaf/file-beat/log_config completed
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.2/cfx-onprem-portal-dbinit.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/cfx-onprem-portal.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/cfx-rda-alert-processor.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/cfx-rda-configuration-service.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/cfx-rda-webhook-server.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/onprem-portal-nginx.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/ubuntu-cfxdx-nb-nginx-all.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/ubuntu-rda-bulkstats.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/ubuntu-rda-chat-helper.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/ubuntu-rda-client-api-server.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/ubuntu-rda-collector.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/ubuntu-rda-event-gateway.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/ubuntu-rda-worker-all.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/ubuntu-cfx-self-monitor.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/rda-platform-filebeat-1.0.4.1.tar.gz wget https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2.0.2/rda-platform-logstash-1.0.4.1.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 cfx-onprem-portal-dbinit.tar.gz
rdaf registry import --file cfx-onprem-portal.tar.gz
rdaf registry import --file cfx-rda-alert-processor.tar.gz
rdaf registry import --file cfx-rda-configuration-service.tar.gz
rdaf registry import --file cfx-rda-webhook-server.tar.gz
rdaf registry import --file onprem-portal-nginx.tar.gz
rdaf registry import --file ubuntu-cfxdx-nb-nginx-all.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-event-gateway.tar.gz
rdaf registry import --file ubuntu-rda-worker-all.tar.gz
rdaf registry import --file ubuntu-cfx-self-monitor.tar.gz
rdaf registry import --file rda-platform-filebeat
rdaf registry import --file rda-platform-logstash
- To view the list of tags available in the registry, use the below given command
+-------------------------------------+---------+
| Service-Name | Tags |
|-------------------------------------|---------|
| cfx-onprem-portal-dbinit | 8.2.0.2 |
| cfx-onprem-portal | 8.2.0.2 |
| cfx-rda-alert-processor | 8.2.0.2 |
| cfx-rda-configuration-service | 8.2.0.2 |
| cfx-rda-webhook-server | 8.2.0.2 |
| onprem-portal-nginx | 8.2.0.2 |
| ubuntu-cfxdx-nb-nginx-all | 8.2.0.2 |
| ubuntu-rda-bulkstats | 8.2.0.2 |
| ubuntu-rda-chat-helper | 8.2.0.2 |
| ubuntu-rda-client-api-server | 8.2.0.2 |
| ubuntu-rda-collector | 8.2.0.2 |
| ubuntu-rda-event-gateway | 8.2.0.2 |
| ubuntu-rda-worker-all | 8.2.0.2 |
| ubuntu-cfx-self-monitor | 8.2.0.2 |
| rda-platform-filebeat | 8.2.0.2 |
| rda-platform-logstash | 8.2.0.2 |
+-------------------------------------+---------+
- If necessary, kindly remove outdated image tags from the on-premise registry that are no longer in use by executing the following command:
- Please proceed with the full upgrade following the instructions in this Document