Skip to content

Installing OIA (Operations Intelligence & Analytics)

This document provides instructions about fresh Installation & Upgrades for OIA application (Operations Intelligence & Analytics, a.k.a AIOps). It is an application that is installed on top of RDA Fabric platform.

1. Setup & Install

1.1 Online Install

Infra Services tag: 1.0.4

RDAF Platform: 8.2

AIOps (OIA) Application: 8.2

RDAF Deployment rdafk8s CLI: 1.5.0

RDAF Client rdac CLI: 8.2

Infra Services tag: 1.0.4

RDAF Platform: 8.2

OIA (AIOps) Application: 8.2

RDAF Deployment rdaf CLI: 1.5.0

RDAF Client rdac CLI: 8.2

1.1. Prerequisites

For VM deployment options, and post-OS/OVF configuration please follow this Document before beginning the RDAF Fresh Installation.

RDAF Deployment CLI Install:

Please follow the below given steps.

Note

Upgrade RDAF Deployment CLI on both on-premise docker registry VM and RDAF Platform's management VM if provisioned separately.

Login into the VM where rdaf deployment CLI was installed for docker on-premise registry and managing Kubernetes or Non-kubernetes deployment.

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

Run the below command to view the RDAF deployment CLI help

rdaf --help
Documented commands (type help <topic>):
========================================
app            geodr             logs                 registry         setup
backup         help              opensearch_external  reset            status
bulk_stats     infra             platform             restore          telegraf
event_gateway  install_rda_edge  prune_images         self_monitoring  validate
file_object    log_monitoring    rdac_cli             setregistry      worker

1.2 On-premise Docker Registry setup:

CloudFabrix support hosting an on-premise docker registry which will download and synchronize RDA Fabric's platform, infrastructure and application services from CloudFabrix's public docker registry that is securely hosted on AWS and from other public docker registries as well. For more information on on-premise docker registry, please refer Docker registry access for RDAF platform services.

Run rdaf registry --help to see available CLI options to deploy and manage on-premise docker registry.

rdaf registry --help

usage: ('registry',) [--insecure] [-h] [--debug]
                     {setup,upgrade,install,fetch,delete-images,list-tags} ...

Manage the Docker registry

positional arguments:
  {setup,upgrade,install,fetch,delete-images,import,list-tags,verify-from-file,r
    setup               Setup Docker Registry
    upgrade             Upgrade Registry locally
    install             Install Registry locally
    fetch               Fetch from configured Docker registries
    delete-images       Deletes tag(s) and corresponding docker images
    import              Import images(s) provided as tar file
    list-tags           Lists all the tags for all images in the docker registry
    verify-from-file    Verify images listed in a file
    reset               Reset the docker registry deployment

options:
  --insecure            Ignore SSL certificate issues when communicating with va
  -h, --help            show this help message and exit
  --debug               Enable debug logs for the CLI operations

Run rdaf registry setup --help to see available CLI options.

rdaf registry setup --help

usage: registry setup [-h] [--install-root INSTALL_ROOT]
                      [--docker-server-host DOCKER_SERVER_HOST]
                      [--docker-registry-source-host DOCKER_SOURCE_HOST]
                      [--docker-registry-source-port DOCKER_SOURCE_PORT]
                      [--docker-registry-source-project DOCKER_SOURCE_PROJECT]
                      [--docker-registry-source-user DOCKER_SOURCE_USER]
                      [--docker-registry-source-password DOCKER_SOURCE_PASSWORD]
                      [--no-prompt] [--offline]

options:
  -h, --help            show this help message and exit
  --install-root INSTALL_ROOT
                        Path to a directory where the Docker registry will be
                        installed and managed
  --docker-server-host DOCKER_SERVER_HOST
                        Host name or IP address of the host where the Docker
                        registry will be installed
  --docker-registry-source-host DOCKER_SOURCE_HOST
                        The hostname/IP of the source docker registry
  --docker-registry-source-port DOCKER_SOURCE_PORT
                        port of the docker registry
  --docker-registry-source-project DOCKER_SOURCE_PROJECT
                        project of the docker registry
  --docker-registry-source-user DOCKER_SOURCE_USER
                        The username to use while connecting to the source
                        docker registry
  --docker-registry-source-password DOCKER_SOURCE_PASSWORD
                        The password to use while connecting to the source
                        docker registry
  --no-prompt           Don't prompt for inputs
  --offline             Will ignore pulling image and docker login

Note

The username/password has not been provided in this documentation. If you need access credentials, please reach out to the Support Team at ([email protected])

Run the below command to setup and configure on-premise docker registry service. In the below command example, 192.168.108.131 is the machine on which on-premise registry service is going to installed.

docker2.cloudfabrix.io is the CloudFabrix's public docker registry hosted on AWS from which RDA Fabric docker images are going to be downloaded.

  • Run the below command for rdaf registry setup.
rdaf registry setup --docker-server-host 192.168.108.131 --docker-registry-source-host docker2.cloudfabrix.io --docker-registry-source-port 443 --docker-registry-source-user xxxxx --docker-registry-source-password xxxxxxxx --docker-registry-source-project external --no-prompt

1.3. Installation Steps

1.3.1 RDAF Registry Install

Run the below command to install the on-premise docker registry service.

rdaf registry install --tag 1.0.4
To check the status of the on-premise docker registry service, run the below command.

docker ps -a | grep docker-registry
836d5cf755c6   docker2.cloudfabrix.io:443/external/docker-registry:1.0.4   "/entrypoint.sh /bin…"   7 hours ago   Up 7 hours                                               deployment-scripts-docker-registry-1

1.3.2 RDAF Registry Fetch

Once on-premise docker registry service is installed, run the below command to download one or more tags to pre-stage the docker images for RDA Fabric services deployment for fresh install.

Login into the VM where rdaf deployment CLI was installed for docker on-premise registry and managing kubernetes & Non-kubernetes deployment.

Download the new docker image tags for RDAF Platform and OIA (AIOps) Application services and wait until all of the images are downloaded.

To fetch registry please use the below command.

rdaf registry fetch --tag 1.0.4,1.0.4.1,8.2

Minio object storage service image need to be downloaded explicitly using the below command.

rdaf registry fetch --minio-tag RELEASE.2024-12-18T13-15-44Z

To fetch registry please use the below command

rdaf registry fetch --tag 1.0.4,1.0.4.1,8.2

Minio object storage service image need to be downloaded explicitly using the below command.

rdaf registry fetch --minio-tag RELEASE.2024-12-18T13-15-44Z

Note

If the Download of the images fail, Please re-execute the above command

Run the below command to verify above mentioned tags are downloaded for all of the RDAF Platform and OIA (AIOps) Application services.

rdaf registry list-tags 

Please make sure 1.0.4 ,opensearch (1.0.4 & 1.0.4.1) Image tag is downloaded for the following services

  • nats - 1.0.4
  • minio-tag RELEASE.2024-12-18T13-15-44Z
  • mariadb - 1.0.4
  • opensearch - 1.0.4,1.0.4.1
  • kafka - 1.0.4
  • graphdb - 1.0.4
  • haproxy - 1.0.4
  • telegraph - 1.0.4
  • quadrant - 1.0.4 (Optional)

Please make sure 8.2 image tag is downloaded for the below RDAF Platform services.

  • rda-client-api-server
  • rda-registry
  • rda-scheduler
  • rda-collector
  • rda-identity
  • rda-fsm
  • rda-asm
  • rda-access-manager
  • rda-resource-manager
  • rda-user-preferences
  • onprem-portal
  • onprem-portal-nginx
  • rda-worker-all
  • onprem-portal-dbinit
  • cfxdx-nb-nginx-all
  • rda-event-gateway
  • rda-chat-helper
  • rdac
  • bulk_stats
  • opensearch_external

Please make sure 8.2 image tag is downloaded for the below RDAF OIA (AIOps) Application services.

  • cfx rda-app-controller
  • cfx rda-alert-processor
  • cfx rda-file-browser
  • cfx rda-smtp-server
  • cfx rda-ingestion-tracker
  • cfx rda-reports-registry
  • cfx rda-ml-config
  • cfx rda-event-consumer
  • cfx rda-webhook-server
  • cfx rda-irm-service
  • cfx rda-alert-ingester
  • cfx rda-collaboration
  • cfx rda-notification-service
  • cfx rda-configuration-service
  • cfx rda-alert-processor-companion

Configure Local Registry

  • Run the following command to configure the local registry connection, replacing the placeholders with your actual registry IP and certificate path.
rdaf setregistry --host <Host ip of onprem registry VM IP> --port 5000 --cert-path <path of the ca-cert>
rdaf setregistry --host 192.168.108.131 --port 5000 --cert-path /opt/rdaf-registry/registry-ca-cert.crt

Downloaded Docker images are stored under the below path.

/opt/rdaf-registry/data/docker/registry/v2/ or /opt/rdaf/data/docker/registry/v2/

Run the below command to check the filesystem's disk usage on offline registry VM where docker images are pulled.

df -h /opt

If necessary, older image tags that are no longer in use can be deleted to free up disk space using the command below.

Note

Run the command below if /opt occupies more than 80% of the disk space or if the free capacity of /opt is less than 25GB.

rdaf registry delete-images --tag <tag1,tag2>
  • Use the following command to setup fresh installation.
rdaf setup

1.2.2 Install RDAF Infra Services

  • Install infra service using below command.
rdafk8s infra install --tag 1.0.4
  • Run the command below to check the status of the pods in the rda-fabric namespace, filtering by the rdaf-infra app category. Ensure that the pods are in a running state.
kubectl get pods -n rda-fabric -l app_category=rdaf-infra
  • Execute the command below to install the qdrant service.

Note

This step is optional. Customers who wish to install qdrant service needs to mount a 10GB disk and can run the below command for HA. It will prompt for the deployment IPs, so please make sure to assign 3 IPs for the infrastructure VMs. For Non-HA Please assign one Infra VM IP.

rdafk8s infra install --tag 1.0.4 --service qdrant 
rdauser@k8sofflineregistry108113:~$ rdafk8s infra install --tag 1.0.4 --service qdrant
2026-02-04 04:40:24,668 [rdaf.cmd.infra] INFO     - Installing qdrant
What is the "host/path-on-host" where you want Qdrant to be provisioned?
Qdrant server host/path[192.168.108.117]: 192.168.108.114,192.168.108.115,192.168.108.116
persistentvolume/rda-qdrant-0 created
persistentvolume/rda-qdrant-1 created
persistentvolume/rda-qdrant-2 created
persistentvolumeclaim/qdrant-storage-rda-qdrant-0 created
persistentvolumeclaim/qdrant-storage-rda-qdrant-1 created
persistentvolumeclaim/qdrant-storage-rda-qdrant-2 created
NAME: rda-qdrant
LAST DEPLOYED: Wed Feb  4 04:40:46 2026
NAMESPACE: rda-fabric
STATUS: deployed
REVISION: 1
NOTES:
Qdrant v1.16.1 has been deployed successfully.

The full Qdrant documentation is available at https://qdrant.tech/documentation/.

To forward Qdrant's ports execute one of the following commands:
export POD_NAME=$(kubectl get pods --namespace rda-fabric -l "app.kubernetes.io/name=qdrant,app.kubernetes.io/instance=rda-qdrant" -o jsonpath="{.items[0].metadata.name}")

If you want to use Qdrant via http execute the following commands
kubectl --namespace rda-fabric port-forward $POD_NAME 6333:6333

If you want to use Qdrant via grpc execute the following commands
kubectl --namespace rda-fabric port-forward $POD_NAME 6334:6334

If you want to use Qdrant via p2p execute the following commands
kubectl --namespace rda-fabric port-forward $POD_NAME 6335:6335
2026-02-04 04:40:47,147 [rdaf.component.platform] INFO     - Updating Qdrant endpoint in network config
configmap/rda-network-config configured


2026-02-04 04:40:47,434 [rdaf.cmd.infra] INFO     - Please check infra pods status using -  kubectl get pods -n rda-fabric -l app_category=rdaf-infra
  • Install infra service using below command.
rdaf infra install --tag 1.0.4
  • Please use the below mentioned command to see infra services are up and in Running state
rdaf infra status
  • Execute the command below to install the qdrant service.

Note

This step is optional. Customers who wish to install qdrant service needs to mount a 10GB disk and can run the below command for HA. It will prompt for the deployment IPs, so please make sure to assign 3 IPs for the infrastructure VMs. For Non-HA Please assign one Infra VM IP.

rdaf infra install --tag 1.0.4 --service qdrant 
rdauser@user-infra13360:~$ rdaf infra install --tag 1.0.4 --service qdrant
2026-02-04 04:49:37,017 [rdaf.component] INFO     - Pulling qdrant images on host 192.168.133.60
1.0.4: Pulling from rda-platform-qdrant
d96c540105e0: Pull complete
4f4fb700ef54: Pull complete
e7e3b24edd4b: Pull complete
c34aec5dcf80: Pull complete
231dc95f1e77: Pull complete
c69c70becb6a: Pull complete
46054db6899d: Pull complete
c838b6ce71e9: Pull complete
b70c8f6a8444: Pull complete
Digest: sha256:c888e9ebb85318288da6753d2cca5e6a585b1c602fe9daf8c10544aabd18d05c
Status: Downloaded newer image for 192.168.133.60:5000/rda-platform-qdrant:1.0.4
192.168.133.60:5000/rda-platform-qdrant:1.0.4
2026-02-04 04:49:43,127 [rdaf.component] INFO     - Pulling qdrant images on host 192.168.133.61
2026-02-04 04:49:48,765 [rdaf.component] INFO     - 1.0.4: Pulling from rda-platform-qdrant
d96c540105e0: Pull complete
4f4fb700ef54: Pull complete
e7e3b24edd4b: Pull complete
c34aec5dcf80: Pull complete
231dc95f1e77: Pull complete
c69c70becb6a: Pull complete
46054db6899d: Pull complete
c838b6ce71e9: Pull complete
b70c8f6a8444: Pull complete
Digest: sha256:c888e9ebb85318288da6753d2cca5e6a585b1c602fe9daf8c10544aabd18d05c
Status: Downloaded newer image for 192.168.133.60:5000/rda-platform-qdrant:1.0.4
192.168.133.60:5000/rda-platform-qdrant:1.0.4

2026-02-04 04:49:48,788 [rdaf.component] INFO     - Pulling qdrant images on host 192.168.133.62
2026-02-04 04:49:54,557 [rdaf.component] INFO     - 1.0.4: Pulling from rda-platform-qdrant
d96c540105e0: Pull complete
4f4fb700ef54: Pull complete
e7e3b24edd4b: Pull complete
c34aec5dcf80: Pull complete
231dc95f1e77: Pull complete
c69c70becb6a: Pull complete
46054db6899d: Pull complete
c838b6ce71e9: Pull complete
b70c8f6a8444: Pull complete
Digest: sha256:c888e9ebb85318288da6753d2cca5e6a585b1c602fe9daf8c10544aabd18d05c
Status: Downloaded newer image for 192.168.133.60:5000/rda-platform-qdrant:1.0.4
192.168.133.60:5000/rda-platform-qdrant:1.0.4

2026-02-04 04:49:54,561 [rdaf.cmd.infra] INFO     - Installing qdrant
[+] Running 2/2
✔ Container infra-qdrant-1                                                                                               Started                               0.6s
! qdrant Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.                                       0.0s
[+] Running 2/29:59,553 [rdaf.component] INFO     -
✔ Container infra-qdrant-1                                                                                               Started2.2s
! qdrant Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap. 0.0s

[+] Running 2/20:02,975 [rdaf.component] INFO     -
✔ Container infra-qdrant-1                                                                                               Started2.1s
! qdrant Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap. 0.0s

2026-02-04 04:50:03,906 [rdaf.component.haproxy] INFO     - Updated HAProxy configuration at /opt/rdaf/config/haproxy/haproxy.cfg on 192.168.133.60
2026-02-04 04:50:04,287 [rdaf.component.haproxy] INFO     - Updated HAProxy configuration at /opt/rdaf/config/haproxy/haproxy.cfg on 192.168.133.61
2026-02-04 04:50:04,362 [rdaf.component.haproxy] INFO     - Restarting Haproxy on host: 192.168.133.61
[+] Restarting 1/15,111 [rdaf.component] INFO     -
✔ Container infra-haproxy-1  Started                                     10.4s

2026-02-04 04:50:15,221 [rdaf.component.haproxy] INFO     - Restarting Haproxy on host: 192.168.133.60
[+] Restarting 1/1
✔ Container infra-haproxy-1  Started                                                                                                                          10.3s
2026-02-04 04:50:25,709 [rdaf.component.platform] INFO     - Updating Qdrant endpoint in network config
2026-02-04 04:50:25,712 [rdaf.component.platform] INFO     - Creating directory /opt/rdaf/config/network_config
2026-02-04 04:50:26,438 [rdaf.component.platform] INFO     - Creating directory /opt/rdaf/config/network_config
2026-02-04 04:50:27,182 [rdaf.component.platform] INFO     - Creating directory /opt/rdaf/config/network_config
2026-02-04 04:50:27,987 [rdaf.component.platform] INFO     - Creating directory /opt/rdaf/config/network_config

Note

Starting from version 1.0.4 onwards, MetalLB Installation is mandatory.

1.2.3 Install RDAF Platform Services

  • Run the below command to initiate Installing RDAF Platform services.
rdafk8s platform install --tag 8.2
  • Please wait till all of the new platform PODs are in Running state and run the below command to verify their status and make sure all of them are running with 8.2 version.
rdafk8s platform status
+--------------------+----------------+-------------------+--------------+-----+
| Name               | Host           | Status            | Container Id | Tag |
+--------------------+----------------+-------------------+--------------+-----+
| rda-api-server     | 192.168.131.44 | Up 44 Minutes ago | a1b2c3d4e5f6 | 8.2 |
| rda-api-server     | 192.168.131.45 | Up 46 Minutes ago | b7c8d9e0f1a2 | 8.2 |
| rda-registry       | 192.168.131.45 | Up 46 Minutes ago | c3d4e5f6a7b8 | 8.2 |
| rda-registry       | 192.168.131.44 | Up 46 Minutes ago | d9e0f1a2b3c4 | 8.2 |
| rda-identity       | 192.168.131.44 | Up 46 Minutes ago | e5f6a7b8c9d0 | 8.2 |
| rda-identity       | 192.168.131.47 | Up 45 Minutes ago | f1a2b3c4d5e6 | 8.2 |
| rda-fsm            | 192.168.131.44 | Up 46 Minutes ago | a7b8c9d0e1f2 | 8.2 |
| rda-fsm            | 192.168.131.45 | Up 46 Minutes ago | b3c4d5e6f7a8 | 8.2 |
| rda-asm            | 192.168.131.44 | Up 46 Minutes ago | c9d0e1f2a3b4 | 8.2 |
| rda-asm            | 192.168.131.45 | Up 46 Minutes ago | d5e6f7a8b9c0 | 8.2 |
| rda-asm            | 192.168.131.47 | Up 2 Weeks ago    | e1f2a3b4c5d6 | 8.2 |
| rda-asm            | 192.168.131.46 | Up 2 Weeks ago    | f7a8b9c0d1e2 | 8.2 |
| rda-chat-helper    | 192.168.131.44 | Up 46 Minutes ago | a3b4c5d6e7f8 | 8.2 |
| rda-chat-helper    | 192.168.131.45 | Up 45 Minutes ago | b9c0d1e2f3a4 | 8.2 |
| rda-access-manager | 192.168.131.45 | Up 46 Minutes ago | c5d6e7f8a9b0 | 8.2 |
| rda-access-manager | 192.168.131.46 | Up 45 Minutes ago | d1e2f3a4b5c6 | 8.2 |
| rda-resource-      | 192.168.131.44 | Up 45 Minutes ago | e7f8a9b0c1d2 | 8.2 |
| manager            |                |                   |              |     |
| rda-resource-      | 192.168.131.45 | Up 45 Minutes ago | f3a4b5c6d7e8 | 8.2 |
| manager            |                |                   |              |     |
+--------------------+----------------+-------------------+--------------+-----+
  • Run the below command to check the rda-scheduler service is elected as a leader under Site column.
rdac pods
+-------+----------------------------------------+-------------+--------------+----------+-------------+-----------------+--------+--------------+---------------+--------------+
| Cat   | Pod-Type                               | Pod-Ready   | Host         | ID       | Site        | Age             |   CPUs |   Memory(GB) | Active Jobs   | Total Jobs   |
|-------+----------------------------------------+-------------+--------------+----------+-------------+-----------------+--------+--------------+---------------+--------------|
| Infra | api-server                             | True        | rda-api-server | 9c0484af |             | 11:41:50 |      8 |        31.33 |               |              |
| Infra | api-server                             | True        | rda-api-server | 196558ed |             | 11:40:23 |      8 |        31.33 |               |              |
| Infra | asm                                    | True        | rda-asm-5b8fb9 | bcbdaae5 |             | 11:42:26 |      8 |        31.33 |               |              |
| Infra | asm                                    | True        | rda-asm-5b8fb9 | 232a58af |             | 11:42:40 |      8 |        31.33 |               |              |
| Infra | collector                              | True        | rda-collector- | d06fb56c |             | 11:42:03 |      8 |        31.33 |               |              |
| Infra | collector                              | True        | rda-collector- | a4c79e4c |             | 11:41:59 |      8 |        31.33 |               |              |
| Infra | registry                               | True        | rda-registry-6 | 2fd69950 |             | 11:42:03 |      8 |        31.33 |               |              |
| Infra | registry                               | True        | rda-registry-6 | fac544d6 |             | 11:41:59 |      8 |        31.33 |               |              |
| Infra | scheduler                              | True        | rda-scheduler- | b98afe88 | *leader*    | 11:42:01 |      8 |        31.33 |               |              |
| Infra | scheduler                              | True        | rda-scheduler- | e25a0841 |             | 11:41:56 |      8 |        31.33 |               |              |
| Infra | worker                                 | True        | rda-worker-5b5 | 99bd054e | rda-site-01 | 11:33:40 |      8 |        31.33 | 0             | 0            |
| Infra | worker                                 | True        | rda-worker-5b5 | 0bfdcd98 | rda-site-01 | 11:33:34 |      8 |        31.33 | 0             | 0            |
+-------+----------------------------------------+-------------+----------------+----------+-------------+----------+--------+--------------+---------------+--------------+
  • Run the below command to check if all services has ok status and does not throw any failure messages.
rdac healthcheck
  • Run the below command to initiate Installing RDAF Platform services.
rdaf platform install --tag 8.2
  • Please wait till all of the new platform services are in Up state and run the below command to verify their status and make sure all of them are running with 8.2 version.
rdaf platform status
+--------------------------+----------------+-------------------------------+--------------+-------+
| Name                     | Host           | Status                        | Container Id | Tag   |
+--------------------------+----------------+-------------------------------+--------------+-------+
| rda_api_server           | 192.168.108.51 | Up 4 hours                    | 2a3b4c5d6e7f | 8.2   |
| rda_api_server           | 192.168.108.52 | Up 4 hours                    | 9g0h1i2j3k4l | 8.2   |
| rda_registry             | 192.168.108.51 | Up 4 hours                    | 4m5n6o7p8q9r | 8.2   |
| rda_registry             | 192.168.108.52 | Up 4 hours                    | 1s2t3u4v5w6x | 8.2   |
| rda_scheduler            | 192.168.108.51 | Up 4 hours                    | 7y8z9a0b1c2d | 8.2   |
| rda_scheduler            | 192.168.108.52 | Up 4 hours                    | 4e5f6g7h8i9j | 8.2   |
| rda_collector            | 192.168.108.51 | Up 4 hours                    | 1k2l3m4n5o6p | 8.2   |
| rda_collector            | 192.168.108.52 | Up 4 hours                    | 8q9r0s1t2u3v | 8.2   |
| rda_identity             | 192.168.108.51 | Up 4 hours                    | 5w6x7y8z9a0b | 8.2   |
| rda_identity             | 192.168.108.52 | Up 4 hours                    | 2c3d4e5f6g7h | 8.2   |
| rda_asm                  | 192.168.108.51 | Up 4 hours                    | 9i0j1k2l3m4n | 8.2   |
| rda_asm                  | 192.168.108.52 | Up 4 hours                    | 6o7p8q9r0s1t | 8.2   |
| rda_fsm                  | 192.168.108.51 | Up 4 hours                    | 3u4v5w6x7y8z | 8.2   |
| rda_fsm                  | 192.168.108.52 | Up 4 hours                    | 0a1b2c3d4e5f | 8.2   |
+--------------------------+----------------+-------------------------------+--------------+-------+

Run the below command to check the rda-scheduler service is elected as a leader under Site column.

rdac pods

Run the below command to check if all services has ok status and does not throw any failure messages.

rdac healthcheck
+-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-------------------------------------------------------------+
| Cat       | Pod-Type                               | Host         | ID       | Site        | Health Parameter                                    | Status   | Message                                                     |
|-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-------------------------------------------------------------|
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | service-status                                      | ok       |                                                             |
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | 192.168-connectivity                                  | ok       |                                                             |
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | service-dependency:configuration-service            | ok       | 2 pod(s) found for configuration-service                    |
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | service-initialization-status                       | ok       |                                                             |
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | kafka-connectivity                                  | ok       | Cluster=NTc1NWU1MTQxYmY3MTFlZg, Broker=1, Brokers=[1, 2, 3] |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | service-status                                      | ok       |                                                             |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | 192.168-connectivity                                  | ok       |                                                             |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | service-dependency:configuration-service            | ok       | 2 pod(s) found for configuration-service                    |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | service-initialization-status                       | ok       |                                                             |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | kafka-connectivity                                  | ok       | Cluster=NTc1NWU1MTQxYmY3MTFlZg, Broker=3, Brokers=[1, 2, 3] |
| rda_app   | alert-processor                        | c6cc7b04ab33 | b4ebfb06 |             | service-status                                      | ok       |                                                             |
| rda_app   | alert-processor                        | c6cc7b04ab33 | b4ebfb06 |             | 192.168-connectivity                                  | ok       |                                                             |
+-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-------------------------------------------------------------+

1.2.4 Install rdac CLI

Run the below command to Install the rdac CLI

rdafk8s rdac_cli install --tag 8.2

Run the below command to Install the rdac CLI

rdaf rdac_cli install --tag 8.2

1.2.5 Install RDA Worker Services

Note

If the worker was deployed in a HTTP proxy environment, please make sure the required HTTP proxy environment variables are added in /opt/rdaf/deployment-scripts/values.yaml file under rda_worker configuration section as shown below before upgrading RDA Worker services.

rda_worker:
  terminationGracePeriodSeconds: 300
  replicas: 6
  sizeLimit: 1024Mi
  privileged: true
  resources:
    requests:
      memory: 100Mi
    limits:
      memory: 24Gi
  env:
    WORKER_GROUP: rda-prod-01
    CAPACITY_FILTER: cpu_load1 <= 7.0 and mem_percent < 95
    MAX_PROCESSES: '1000'
    RDA_ENABLE_TRACES: 'no'
    WORKER_PUBLIC_ACCESS: 'true'
    DISABLE_REMOTE_LOGGING_CONTROL: 'no'
    RDA_SELF_HEALTH_RESTART_AFTER_FAILURES: 3
  extraEnvs:
  - name: http_proxy
    value: http://test:[email protected]:3128
  - name: https_proxy
    value: http://test:[email protected]:3128
  - name: HTTP_PROXY
    value: http://test:[email protected]:3128
  - name: HTTPS_PROXY
    value: http://test:[email protected]:3128
  ....
  ....
  • Please run the below command to initiate Installing the RDA Worker service PODs.
rdafk8s worker install --tag 8.2
  • Please wait for 120 seconds to let the newer version of RDA Worker service PODs join the RDA Fabric appropriately. Run the below commands to verify the status of the newer RDA Worker service PODs.
rdac pods | grep rda-worker
rdafk8s worker status
+------------+----------------+---------------+--------------+-------+
| Name       | Host           | Status        | Container Id | Tag   |
+------------+----------------+---------------+--------------+-------+
| rda-worker | 192.168.108.17 | Up 1 Hour ago | a1b2c3d4e5f0 | 8.2   |
| rda-worker | 192.168.108.18 | Up 1 Hour ago | f9e8d7c6b5a4 | 8.2   |
+------------+----------------+---------------+--------------+-------+
  • Run the below command to check if all RDA Worker services has ok status and does not throw any failure messages.
rdac healthcheck

Note

If the worker was deployed in a HTTP proxy environment, please make sure the required HTTP proxy environment variables are added in /opt/rdaf/deployment-scripts/values.yaml file under rda_worker configuration section as shown below before upgrading RDA Worker services.

rda_worker:
  mem_limit: 8G
  memswap_limit: 8G
  privileged: false
  environment:
    RDA_ENABLE_TRACES: 'no'
    RDA_SELF_HEALTH_RESTART_AFTER_FAILURES: 3
    http_proxy:  "http://test:[email protected]:3128"
    https_proxy: "http://test:[email protected]:3128"
    HTTP_PROXY:  "http://test:[email protected]:3128"
    HTTPS_PROXY: "http://test:[email protected]:3128"

Please run the below command to initiate Installing the RDA Worker Service

rdaf worker install --tag 8.2

Please wait for 120 seconds to let the newer version of RDA Worker service containers join the RDA Fabric appropriately. Run the below commands to verify the status of the newer RDA Worker service containers.

rdac pods | grep worker
| Infra | worker      | True        | 6eff605e72c4 | a318f394 | rda-site-01 | 13:45:13 |      4 |        31.21 | 0             | 0            |
| Infra | worker      | True        | ae7244d0d10a | 554c2cd8 | rda-site-01 | 13:40:40 |      4 |        31.21 | 0             | 0            |

rdaf worker status

+------------+----------------+------------+--------------+---------+
| Name       | Host           | Status     | Container Id | Tag     |
+------------+----------------+------------+--------------+---------+
| rda_worker | 192.168.108.53 | Up 4 hours | 97486bd27309 | 8.2     |
| rda_worker | 192.168.108.54 | Up 4 hours | 88d9d76ca5e1 | 8.2     |
+------------+----------------+------------+--------------+---------+
Run the below command to check if all RDA Worker services has ok status and does not throw any failure messages.

rdac healthcheck
+-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-----------------------------------------------------------------------------------------------------------------------------+
| Cat       | Pod-Type                               | Host         | ID       | Site        | Health Parameter                                    | Status   | Message                                                                                                                     |
|-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-----------------------------------------------------------------------------------------------------------------------------|
| rda_infra | api-server                             | 1b0542719618 | 1845ae67 |             | service-status                                      | ok       |                                                                                                                             |
| rda_infra | api-server                             | 1b0542719618 | 1845ae67 |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_infra | api-server                             | d4404cffdc7a | a4cfdc6d |             | service-status                                      | ok       |                                                                                                                             |
| rda_infra | api-server                             | d4404cffdc7a | a4cfdc6d |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_infra | asm                                    | 8d3d52a7a475 | 418c9dc1 |             | service-status                                      | ok       |                                                                                                                             |
| rda_infra | asm                                    | 8d3d52a7a475 | 418c9dc1 |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_infra | asm                                    | ab172a9b8229 | 2ac1d67a |             | service-status                                      | ok       |                                                                                                                             |
| rda_infra | asm                                    | ab172a9b8229 | 2ac1d67a |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | asset-dependency                       | 6ac69ca1085c | c2e9dcb9 |             | service-status                                      | ok       |                                                                                                                             |
| rda_app   | asset-dependency                       | 6ac69ca1085c | c2e9dcb9 |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | asset-dependency                       | 58a5f4f460d3 | 0b91caac |             | service-status                                      | ok       |                                                                                                                             |
| rda_app   | asset-dependency                       | 58a5f4f460d3 | 0b91caac |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | authenticator                          | 9011c2aef498 | 9f7efdc3 |             | service-status                                      | ok       |                                                                                                                             |
| rda_app   | authenticator                          | 9011c2aef498 | 9f7efdc3 |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | authenticator                          | 9011c2aef498 | 9f7efdc3 |             | DB-connectivity                                     | ok       |                                                                                                                             |
| rda_app   | authenticator                          | 148621ed8c82 | dbf16b82 |             | service-status                                      | ok       |                                                                                                                             |
| rda_app   | authenticator                          | 148621ed8c82 | dbf16b82 |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | authenticator                          | 148621ed8c82 | dbf16b82 |             | DB-connectivity                                     | ok       |                                                                                                                             |
| rda_app   | cfx-app-controller                     | 75ec0f30cfa3 | 1198fdee |             | service-status                                      | ok       |                                                                                                                             |
| rda_app   | cfx-app-controller                     | 75ec0f30cfa3 | 1198fdee |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | cfx-app-controller                     | 75ec0f30cfa3 | 1198fdee |             | service-initialization-status                       | ok       |                                                                                                                             |
| rda_app   | cfx-app-controller                     | 75ec0f30cfa3 | 1198fdee |             | DB-connectivity                                     | ok       |                          
+-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-----------------------------------------------------------------------------------------------------------------------------+

Important

For detailed instructions, refer to Configure OIA Services for Specific Deployment Requirements, which outlines how to tailor OIA service configurations based on users deployment's unique needs.

1.2.6 Install OIA Application Services

  • Run the below commands to initiate Installing RDAF OIA Application services
rdafk8s app install --tag 8.2
  • Please wait till all of the new OIA application service PODs are in Running state and run the below command to verify their status and make sure they are running with 8.2 version.
rdafk8s app status
+--------------------+----------------+-------------------+--------------+-------+
| Name               | Host           | Status            | Container Id | Tag   |
+--------------------+----------------+-------------------+--------------+-------+
| rda-alert-ingester | 192.168.131.47 | Up 54 Minutes ago | a1b2c3d4e5f6 | 8.2   |
| rda-alert-ingester | 192.168.131.49 | Up 49 Minutes ago | b7c8d9e0f1a2 | 8.2   |
| rda-alert-         | 192.168.131.49 | Up 44 Minutes ago | c3d4e5f6a7b8 | 8.2   |
| processor          |                |                   |              |       |
| rda-alert-         | 192.168.131.50 | Up 54 Minutes ago | d9e0f1a2b3c4 | 8.2   |
| processor          |                |                   |              |       |
| rda-alert-         | 192.168.131.47 | Up 54 Minutes ago | e5f6a7b8c9d0 | 8.2   |
| processor-         |                |                   |              |       |
| companion          |                |                   |              |       |
| rda-alert-         | 192.168.131.49 | Up 48 Minutes ago | f1a2b3c4d5e6 | 8.2   |
| processor-         |                |                   |              |       |
| companion          |                |                   |              |       |
| rda-app-controller | 192.168.131.47 | Up 54 Minutes ago | a7b8c9d0e1f2 | 8.2   |
| rda-app-controller | 192.168.131.46 | Up 54 Minutes ago | b3c4d5e6f7a8 | 8.2   |
| rda-collaboration  | 192.168.131.49 | Up 43 Minutes ago | c9d0e1f2a3b4 | 8.2   |
| rda-collaboration  | 192.168.131.50 | Up 53 Minutes ago | d5e6f7a8b9c0 | 8.2   |
| rda-configuration- | 192.168.131.46 | Up 54 Minutes ago | e1f2a3b4c5d6 | 8.2   |
| service            |                |                   |              |       |
| rda-configuration- | 192.168.131.49 | Up 51 Minutes ago | f7a8b9c0d1e2 | 8.2   |
| service            |                |                   |              |       |
+--------------------+----------------+-------------------+--------------+-------+
  • Run the below command to verify all OIA application services are up and running.
rdac pods
+-------+----------------------------------------+-------------+----------------+----------+-------------+----------+--------+--------------+---------------+--------------+
| Cat   | Pod-Type                               | Pod-Ready   | Host           | ID       | Site        | Age      |   CPUs |   Memory(GB) | Active Jobs   | Total Jobs   |
|-------+----------------------------------------+-------------+----------------+----------+-------------+----------+--------+--------------+---------------+--------------|
| App   | alert-ingester                         | True        | rda-alert-inge | 6a6e464d |             | 19:19:06 |      8 |        31.33 |               |              |
| App   | alert-ingester                         | True        | rda-alert-inge | 7f6b42a0 |             | 19:19:23 |      8 |        31.33 |               |              |
| App   | alert-processor                        | True        | rda-alert-proc | a880e491 |             | 19:19:51 |      8 |        31.33 |               |              |
| App   | alert-processor                        | True        | rda-alert-proc | b684609e |             | 19:19:48 |      8 |        31.33 |               |              |
| App   | alert-processor-companion              | True        | rda-alert-proc | 874f3b33 |             | 19:18:54 |      8 |        31.33 |               |              |
| App   | alert-processor-companion              | True        | rda-alert-proc | 70cadaa7 |             | 19:18:35 |      8 |        31.33 |               |              |
| App   | asset-dependency                       | True        | rda-asset-depe | bde06c15 |             | 19:44:20 |      8 |        31.33 |               |              |
| App   | asset-dependency                       | True        | rda-asset-depe | 47b9eb02 |             | 19:44:08 |      8 |        31.33 |               |              |
| App   | authenticator                          | True        | rda-identity-d | faa33e1b |             | 19:44:22 |      8 |        31.33 |               |              |
| App   | authenticator                          | True        | rda-identity-d | 36083c36 |             | 19:44:16 |      8 |        31.33 |               |              |
| App   | cfx-app-controller                     | True        | rda-app-contro | 5fd3c3f4 |             | 19:19:39 |      8 |        31.33 |               |              |
| App   | cfx-app-controller                     | True        | rda-app-contro | d66e5ce8 |             | 19:19:26 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-access-manager       | True        | rda-access-man | ecbb535c |             | 19:44:16 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-access-manager       | True        | rda-access-man | 9a05db5a |             | 19:44:06 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-collaboration        | True        | rda-collaborat | 61b3c53b |             | 19:18:48 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-collaboration        | True        | rda-collaborat | 09b9474e |             | 19:18:27 |      8 |        31.33 |               |              |
+-------+----------------------------------------+-------------+----------------+----------+-------------+-------------------+--------+-----------------------------+--------------+
  • Run the below command to check if all services has ok status and does not throw any failure messages.
rdac healthcheck
+-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-----------------------------------------------------------------------------------------------------------------------------+
| Cat       | Pod-Type                               | Host         | ID       | Site        | Health Parameter                                    | Status   | Message                                                                                                                     |
|-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-----------------------------------------------------------------------------------------------------------------------------|
| rda_app   | alert-ingester                         | rda-alert-in | 6a6e464d |             | service-status                                      | ok       |                                                                                                                             |
| rda_app   | alert-ingester                         | rda-alert-in | 6a6e464d |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | alert-ingester                         | rda-alert-in | 6a6e464d |             | service-dependency:configuration-service            | ok       | 2 pod(s) found for configuration-service                                                                                    |
| rda_app   | alert-ingester                         | rda-alert-in | 6a6e464d |             | service-initialization-status                       | ok       |                                                                                                                             |
| rda_app   | alert-ingester                         | rda-alert-in | 6a6e464d |             | kafka-connectivity                                  | ok       | Cluster=dKnnkaYSPELK8DBUk0rPig, Broker=0, Brokers=[0, 1, 2]                                                                 |
| rda_app   | alert-ingester                         | rda-alert-in | 6a6e464d |             | kafka-consumer                                      | ok       | Health: [{'387c0cb507b84878b9d0b15222cb4226.inbound-events': 0, '387c0cb507b84878b9d0b15222cb4226.mapped-events': 0}, {}]   |
| rda_app   | alert-ingester                         | rda-alert-in | 7f6b42a0 |             | service-status                                      | ok       |                                                                                                                             |
| rda_app   | alert-ingester                         | rda-alert-in | 7f6b42a0 |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | alert-ingester                         | rda-alert-in | 7f6b42a0 |             | service-dependency:configuration-service            | ok       | 2 pod(s) found for configuration-service                                                                                    |
| rda_app   | alert-ingester                         | rda-alert-in | 7f6b42a0 |             | service-initialization-status                       | ok       |                                                                                                                             |
| rda_app   | alert-ingester                         | rda-alert-in | 7f6b42a0 |             | kafka-consumer                                      | ok       | Health: [{'387c0cb507b84878b9d0b15222cb4226.inbound-events': 0, '387c0cb507b84878b9d0b15222cb4226.mapped-events': 0}, {}]   |
| rda_app   | alert-ingester                         | rda-alert-in | 7f6b42a0 |             | kafka-connectivity                                  | ok       | Cluster=dKnnkaYSPELK8DBUk0rPig, Broker=1, Brokers=[0, 1, 2]                                                                 |
| rda_app   | alert-processor                        | rda-alert-pr | a880e491 |             | service-status                                      | ok       |                                                                                                                             |
| rda_app   | alert-processor                        | rda-alert-pr | a880e491 |             | 192.168-connectivity                                  | ok       |                                                                                                                             |
| rda_app   | alert-processor                        | rda-alert-pr | a880e491 |             | service-dependency:cfx-app-controller               | ok       | 2 pod(s) found for cfx-app-controller                                                                                       |
| rda_app   | alert-processor                        | rda-alert-pr | a880e491 |             | service-dependency:configuration-service            | ok       | 2 pod(s) found for configuration-service                                                                                    |
| rda_app   | alert-processor                        | rda-alert-pr | a880e491 |             | service-initialization-status                       | ok       |                                                                                                                             |
| rda_app   | alert-processor                        | rda-alert-pr | a880e491 |             | kafka-connectivity                                  | ok       | Cluster=dKnnkaYSPELK8DBUk0rPig, Broker=1, Brokers=[0, 1, 2]                                                                 |
| rda_app   | alert-processor                        | rda-alert-pr | a880e491 |             | DB-connectivity                                     | ok       |                                                                                                                             |
+-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-------------------------------------------------------------+
  • Run the below commands to initiate Installing the RDA Fabric OIA Application services.
rdaf app install --tag 8.2
  • Please wait till all of the new OIA application service containers are in Up state and run the below command to verify their status and make sure they are running with 8.2 version.
rdaf app status
+-----------------------------------+----------------+------------+--------------+-------+
| Name                              | Host           | Status     | Container Id | Tag   |
+-----------------------------------+----------------+------------+--------------+-------+
| cfx-rda-app-controller            | 192.168.108.51 | Up 3 hours | a1b2c3d4e5f0 | 8.2   |
| cfx-rda-app-controller            | 192.168.108.52 | Up 3 hours | f9e8d7c6b5a4 | 8.2   |
| cfx-rda-reports-registry          | 192.168.108.51 | Up 4 hours | c7d8e9f0a1b2 | 8.2   |
| cfx-rda-reports-registry          | 192.168.108.52 | Up 4 hours | a3b4c5d6e7f8 | 8.2   |
| cfx-rda-notification-service      | 192.168.108.51 | Up 4 hours | b9c0d1e2f3a4 | 8.2   |
| cfx-rda-notification-service      | 192.168.108.52 | Up 4 hours | c5d6e7f8a9b0 | 8.2   |
| cfx-rda-file-browser              | 192.168.108.51 | Up 4 hours | d1e2f3a4b5c6 | 8.2   |
| cfx-rda-file-browser              | 192.168.108.52 | Up 4 hours | e7f8a9b0c1d2 | 8.2   |
| cfx-rda-configuration-service     | 192.168.108.51 | Up 4 hours | f3a4b5c6d7e8 | 8.2   |
| cfx-rda-configuration-service     | 192.168.108.52 | Up 4 hours | a9b0c1d2e3f4 | 8.2   |
| cfx-rda-alert-ingester            | 192.168.108.51 | Up 4 hours | b5c6d7e8f9a0 | 8.2   |
| cfx-rda-alert-ingester            | 192.168.108.52 | Up 4 hours | c1d2e3f4a5b6 | 8.2   |
| cfx-rda-webhook-server            | 192.168.108.51 | Up 4 hours | d7e8f9a0b1c2 | 8.2   |
| cfx-rda-webhook-server            | 192.168.108.52 | Up 4 hours | e3f4a5b6c7d8 | 8.2   |
| cfx-rda-smtp-server               | 192.168.108.51 | Up 4 hours | f9a0b1c2d3e4 | 8.2   |
| cfx-rda-smtp-server               | 192.168.108.52 | Up 4 hours | a5b6c7d8e9f0 | 8.2   |
+-----------------------------------+----------------+------------+--------------+-------+

Run the below command to verify all OIA application services are up and running.

rdac pods
+-------+----------------------------------------+-------------+----------------+----------+-------------+----------+--------+--------------+---------------+--------------+
| Cat   | Pod-Type                               | Pod-Ready   | Host           | ID       | Site        | Age      |   CPUs |   Memory(GB) | Active Jobs   | Total Jobs   |
|-------+----------------------------------------+-------------+----------------+----------+-------------+----------+--------+--------------+---------------+--------------|
| App   | alert-ingester                         | True        | rda-alert-inge | 6a6e464d |             | 19:22:36 |      8 |        31.33 |               |              |
| App   | alert-ingester                         | True        | rda-alert-inge | 7f6b42a0 |             | 19:22:53 |      8 |        31.33 |               |              |
| App   | alert-processor                        | True        | rda-alert-proc | a880e491 |             | 19:23:21 |      8 |        31.33 |               |              |
| App   | alert-processor                        | True        | rda-alert-proc | b684609e |             | 19:23:18 |      8 |        31.33 |               |              |
| App   | alert-processor-companion              | True        | rda-alert-proc | 874f3b33 |             | 19:22:24 |      8 |        31.33 |               |              |
| App   | alert-processor-companion              | True        | rda-alert-proc | 70cadaa7 |             | 19:22:05 |      8 |        31.33 |               |              |
| App   | asset-dependency                       | True        | rda-asset-depe | bde06c15 |             | 19:47:50 |      8 |        31.33 |               |              |
| App   | asset-dependency                       | True        | rda-asset-depe | 47b9eb02 |             | 19:47:38 |      8 |        31.33 |               |              |
| App   | authenticator                          | True        | rda-identity-d | faa33e1b |             | 19:47:52 |      8 |        31.33 |               |              |
| App   | authenticator                          | True        | rda-identity-d | 36083c36 |             | 19:47:46 |      8 |        31.33 |               |              |
| App   | cfx-app-controller                     | True        | rda-app-contro | 5fd3c3f4 |             | 19:23:09 |      8 |        31.33 |               |              |
| App   | cfx-app-controller                     | True        | rda-app-contro | d66e5ce8 |             | 19:22:56 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-access-manager       | True        | rda-access-man | ecbb535c |             | 19:47:46 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-access-manager       | True        | rda-access-man | 9a05db5a |             | 19:47:36 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-collaboration        | True        | rda-collaborat | 61b3c53b |             | 19:22:18 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-collaboration        | True        | rda-collaborat | 09b9474e |             | 19:21:57 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-file-browser         | True        | rda-file-brows | 00495640 |             | 19:22:45 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-file-browser         | True        | rda-file-brows | 640f0653 |             | 19:22:29 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-irm_service          | True        | rda-irm-servic | 27e345c5 |             | 19:21:43 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-irm_service          | True        | rda-irm-servic | 23c7e082 |             | 19:21:56 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-notification-service | True        | rda-notificati | bbb5b08b |             | 19:23:20 |      8 |        31.33 |               |              |
| App   | cfxdimensions-app-notification-service | True        | rda-notificati | 9841bcb5 |             | 19:23:02 |      8 |        31.33 |               |              |
+-------+----------------------------------------+-------------+----------------+----------+-------------+----------+--------+--------------+---------------+--------------+

Run the below command to check if all services has ok status and does not throw any failure messages.

rdac healthcheck
+-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-------------------------------------------------------------+
| Cat       | Pod-Type                               | Host         | ID       | Site        | Health Parameter                                    | Status   | Message                                                     |
|-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-------------------------------------------------------------|
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | service-status                                      | ok       |                                                             |
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | 192.168-connectivity                                  | ok       |                                                             |
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | service-dependency:configuration-service            | ok       | 2 pod(s) found for configuration-service                    |
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | service-initialization-status                       | ok       |                                                             |
| rda_app   | alert-ingester                         | 7f75047e9e44 | daa8c414 |             | kafka-connectivity                                  | ok       | Cluster=NTc1NWU1MTQxYmY3MTFlZg, Broker=1, Brokers=[1, 2, 3] |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | service-status                                      | ok       |                                                             |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | 192.168-connectivity                                  | ok       |                                                             |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | service-dependency:configuration-service            | ok       | 2 pod(s) found for configuration-service                    |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | service-initialization-status                       | ok       |                                                             |
| rda_app   | alert-ingester                         | f9ec55862be0 | f9b9231c |             | kafka-connectivity                                  | ok       | Cluster=NTc1NWU1MTQxYmY3MTFlZg, Broker=2, Brokers=[1, 2, 3] |
| rda_app   | alert-processor                        | c6cc7b04ab33 | b4ebfb06 |             | service-status                                      | ok       |                                                             |
| rda_app   | alert-processor                        | c6cc7b04ab33 | b4ebfb06 |             | 192.168-connectivity                                  | ok       |                                                             |
+-----------+----------------------------------------+--------------+----------+-------------+-----------------------------------------------------+----------+-------------------------------------------------------------+

1.2.7 Install Event Gateway Services

Note

If a user deployed the event gateway using the RDAF CLI, follow Step 1 and skip Step 2 or if the user did not deploy event gateway in RDAF CLI go to Step 2

Install Event Gateway Using RDAF CLI

  • To install the event gateway, log in to the rdaf cli VM and execute the following command.
rdafk8s event_gateway install --tag 8.2
  • Use the command given below to find the Event Gateway status
 rdafk8s event_gateway status
+-------------------+-----------------+---------------+--------------+-------------+
| Name              | Host            | Status        | Container Id | Tag         |
+-------------------+-----------------+---------------+--------------+-------------+
| rda-event-gateway | 192.168.108.118 | Up 1 Days ago | 75e8baae6bbc | 8.2         |
| rda-event-gateway | 192.168.108.117 | Up 1 Days ago | 53ea97a898c0 | 8.2         |
+-------------------+-----------------+---------------+--------------+-------------+ 

Note

If a user deployed the event gateway using the RDAF CLI, follow Step 1 and skip Step 2 or if the user did not deploy event gateway in RDAF CLI go to Step 2

Install Event Gateway Using RDAF CLI

  • To install the event gateway, log in to the rdaf cli VM and execute the following command.
rdaf event_gateway install --tag 8.2
  • Use the command given below to find the Event Gateway status
rdaf event_gateway status
+-------------------+-----------------+---------------+--------------+-------------+
| Name              | Host            | Status        | Container Id | Tag         |
+-------------------+-----------------+---------------+--------------+-------------+
| rda-event-gateway | 192.168.108.127 | Up 1 Days ago | 7f7261b086bf | 8.2         |
| rda-event-gateway | 192.168.108.128 | Up 1 Days ago | 5bc4d041a02f | 8.2         |
+-------------------+-----------------+---------------+--------------+-------------+ 

1.2.9 Install RDAF Bulkstats Services

Note

This service is applicable for Non-K8s only.

Note

The RDAF Bulkstats service is optional and only necessary if the Bulkstats data ingestion feature is required. Otherwise, you may ignore the steps below and go to next section.

Run the below command to install bulk_stats services

rdaf bulk_stats install --tag 8.2 --host <ip> --ssh-password <pwd>

A comma can be used to identify two hosts for HA Setups.

rdaf bulk_stats install --tag 8.2 --host 192.168.108.17,192.168.108.18 

Note

When deploying bulk stats on New VM, make sure the username and password matches with the existing VM's

kubectl get pods -n rda-fabric -l app_component=rda-bulk-stats

Run the below command to get the bulk_stats status

rdaf bulk_stats status
+----------------+----------------+-------------+--------------+-------+
| Name           | Host           | Status      | Container Id | Tag   |
+----------------+----------------+-------------+--------------+-------+
| rda_bulk_stats | 192.168.133.96 | Up 4 days   | 67da2301d30c | 8.2   |
| rda_bulk_stats | 192.168.133.92 | Up 46 hours | 32179032bb97 | 8.2   |
+----------------+----------------+-------------+--------------+-------+

1.2.9.1 Install RDAF File Object Services

Note

This service is applicable for Non-K8s only, The RDAF File Object service is optional and only necessary if the Bulkstats data ingestion feature is required. Otherwise, you may ignore the steps below and go to next section

Run the below command to install File Object services and provision service instances across multiple hosts, ensuring that all VMs use the same username and password.

rdaf file_object install --host <ip> --host <ip> --ssh-password <pwd> --tag 8.2

Log in to each file object node and update the permissions for the /opt/public folder.

ssh rdauser@<ip> sudo chown rdauser:rdauser /opt/public
ssh [email protected] sudo chown rdauser:rdauser /opt/public

Run the below command to get the file_object status

+-----------------+----------------+-----------+--------------+-------+
| Name            | Host           | Status    | Container Id | Tag   |
+-----------------+----------------+-----------+--------------+-------+
| rda_file_object | 192.168.108.50 | Up 7 days | 47d1a68c2bf2 | 8.2   |
| rda_file_object | 192.168.108.51 | Up 7 days | 6ce10218c204 | 8.2   |
+-----------------+----------------+-----------+--------------+-------+

1.2.10 Install External Opensearch

Note

This service is applicable for Non-K8s only

  • To Install External Opensearch please follow this Document

1.2.11 Setup & Install Self Monitoring

This service helps monitor the functional health of RDAF platform services and sends notifications via Slack, Webex Teams, or other collaboration tools.

For detailed information, please refer CFX Self Monitor Service

  • Please run the below command to setup Self Monitoring
rdafk8s self_monitoring setup 

The user must enter the necessary parameters as indicated in the screenshot below Example.

Self_Monitoring

  • Run the below command to install Self Monitoring
rdafk8s self_monitoring install --tag 8.2
  • Run the below command to verify the status
rdafk8s self_monitoring status
+------------------+----------------+-------------+--------------+---------+
| Name             | Host           | Status      | Container Id | Tag     |
+------------------+----------------+-------------+--------------+---------+
| cfx_self_monitor | 192.168.108.20 | Up 2  hours | 501de41db006 | 8.2     |
+------------------+----------------+-------------+--------------+---------+
  • Please run the below command to setup Self Monitoring
rdaf self_monitoring setup 

The user must enter the necessary parameters as indicated in the screenshot below Example.

Self_Monitoring

  • Run the below command to install Self Monitoring
rdaf self_monitoring install --tag 8.2
  • Run the below command to verify the status
rdaf self_monitoring status
+------------------+----------------+---------------+--------------+---------+
| Name             | Host           | Status        | Container Id | Tag     |
+------------------+----------------+---------------+--------------+---------+
| cfx_self_monitor | 192.168.109.24 | Up 11 seconds | 5c468d35f3d4 | 8.2     |
+------------------+----------------+---------------+--------------+---------+

1.2.12 Install Log Monitoring

rdafk8s log_monitoring install command is used to deploy / install RDAF log monitoring services. Run the below command to view the available CLI options.

rdafk8s log_monitoring install -h
usage: log_monitoring install [-h] --log-monitoring-host LOG_MONITORING_HOST
                            --tag TAG
log_monitoring install: error: the following arguments are required: --log-monitoring-host, --tag

To deploy all RDAF log monitoring services, execute the following command. Please note that it is mandatory to specify the host for the Logstash service deployment using the --log-monitoring-host option.

Note

Below shown Logstash host ip address is for a reference only. For the latest log monitoring services tag, please contact CloudFabrix support team at [email protected].

rdafk8s log_monitoring install --tag 1.0.4 --log-monitoring-host 192.168.125.52
{"status":"CREATED","message":"'rdaf-log-monitoring' created."}
{"status":"CREATED","message":"'role-log-monitoring' created."}
{"status":"OK","message":"'rdaf-log-monitoring' updated."}
{"status":"CREATED","message":"'role-log-monitoring' created."}
2023-10-31 09:04:33,752 [rdaf.component.log_monitoring] INFO     - Creating rdaf_services_logs pstream...
{
"retention_days": 15,
"timestamp": "@timestamp",
"search_case_insensitive": true,
"_settings": {
    "number_of_shards": 3,
    "number_of_replicas": 1,
    "refresh_interval": "60s"
}
}
Persistent stream saved.

2023-10-31 09:04:41,064 [rdaf.component.log_monitoring] INFO     - Successfully installed and configured rdaf log monitoring...

Run the below command to see the status of all of the deployed RDAF log monitoring services.

rdafk8s log_monitoring status
+---------------------+------------------------+---------------------------+-------------------------+---------+
| Name                | Host                   | Status                    | Container Id            | Tag     |
+---------------------+------------------------+---------------------------+-------------------------+---------+
| rda-filebeat        | 192.168.125.52         | Up 18 Hours ago           | 92e83de200a2            | 1.0.4   |
| rda-logstash        | 192.168.125.52         | Up 18 Hours ago           | 00c1929fdea4            | 1.0.4   |
+---------------------+------------------------+---------------------------+-------------------------+---------+

Below are the Kubernetes Cluster commands to check the status of RDA Fabric log monitoring services.

kubectl get pods -n rda-fabric -l app_component=rda-logstash
kubectl get pods -n rda-fabric -l app_component=rda-filebeat

---------------------------------------------------------------------------------------------------------------------------
rda-logstash-796f9d9f75-vchpq       1/1     Running   0          14m
rda-filebeat-9clrn                  1/1     Running   0          15m
---------------------------------------------------------------------------------------------------------------------------

Run the following commands to obtain additional details of the deployed RDAF log monitoring services (PODs), including information about the node(s) on which they were deployed.

kubectl get pods -n rda-fabric -o wide -l app_component=rda-logstash
kubectl get pods -n rda-fabric -o wide -l app_component=rda-filebeat

To get the detailed status of each RDAF log monitoring service POD, run the below command.

kubectl describe pod <logstash-pod-name> -n rda-fabric
kubectl describe pod <fluent-bit-pod-name> -n rda-fabric
---------------------------------------------------------------------------------------------------------------------------
Name:         rda-logstash-796f9d9f75-vchpq
Namespace:    rda-fabric
Priority:     0
Node:         k8workernode/192.168.125.52
Start Time:   Tue, 31 Oct 2023 09:04:40 +0000
Labels:       app=rda-fabric-services
            app_category=rdaf-infra
            app_component=rda-logstash
            pod-template-hash=796f9d9f75
Annotations:  cni.projectcalico.org/containerID: 0e4208d848db8c99fb977e5bf3f32876b31a090b29e632385dddb2c7cbed599c
            cni.projectcalico.org/podIP: 192.168.75.76/32
            cni.projectcalico.org/podIPs: 192.168.75.76/32
Status:       Running
IP:           192.168.75.76
IPs:
IP:           192.168.75.76

...
...

QoS Class:                   Burstable
Node-Selectors:              rdaf_monitoring_services=allow
Tolerations:                 node.kubernetes.io/not-ready:NoExecute op=Exists for 300s
                            node.kubernetes.io/unreachable:NoExecute op=Exists for 300s
                            pod-type=rda-tenant:NoSchedule
Events:
Type    Reason     Age   From               Message
----    ------     ----  ----               -------
Normal  Scheduled  16m   default-scheduler  Successfully assigned rda-fabric/rda-logstash-796f9d9f75-vchpq to k8workernode
Normal  Pulling    16m   kubelet            Pulling image "docker1.cloudfabrix.io:443/rda-platform-logstash:1.0.4"
Normal  Pulled     15m   kubelet            Successfully pulled image "docker1.cloudfabrix.io:443/rda-platform-logstash:1.0.4" in 1m6.675838828s
Normal  Created    15m   kubelet            Created container rda-logstash
Normal  Started    15m   kubelet            Started container rda-logstash
------------------------------------------------------------------------------------------------------------------------------------------

rdaf log_monitoring install command is used to deploy / install RDAF log monitoring services. Run the below command to view the available CLI options.

rdaf log_monitoring install -h
usage: log_monitoring install [-h] --log-monitoring-host LOG_MONITORING_HOST
                            --tag TAG [--no-prompt]
log_monitoring install: error: the following arguments are required: --log-monitoring-host, --tag

To deploy all RDAF log monitoring services, execute the following command. Please note that it is mandatory to specify the host for the Logstash service deployment using the --log-monitoring-host option.

Note

Below shown Logstash host ip address is for a reference only. For the latest log monitoring services tag, please contact CloudFabrix support team at [email protected].

rdaf log_monitoring install --tag 1.0.4 --log-monitoring-host 192.168.125.52
{"status":"CREATED","message":"'rdaf-log-monitoring' created."}
{"status":"CREATED","message":"'role-log-monitoring' created."}
{"status":"OK","message":"'rdaf-log-monitoring' updated."}
{"status":"CREATED","message":"'role-log-monitoring' created."}
{
"retention_days": 15,
"timestamp": "@timestamp",
"search_case_insensitive": true,
"_settings": {
    "number_of_shards": 3,
    "number_of_replicas": 1,
    "refresh_interval": "60s"
}
}
Persistent stream saved.
2025-02-05 05:04:08,842 [rdaf.component.haproxy] INFO     - Updated HAProxy configuration at /opt/rdaf/config/haproxy/haproxy.cfg on 192.168.125.53
...
...
[+] Running 1/1
⠿ Container filebeat-filebeat-1  Started                                                                                                                                            0.4s
2025-02-05 05:06:05,138 [rdaf.component.log_monitoring] INFO     - Restarting logstash services on host 192.168.125.53
[+] Running 1/1
⠿ Container logstash-logstash-1  Started                                                                                                                                               0.4s
2025-02-05 05:06:05,617 [rdaf.component.log_monitoring] INFO     - Restarting filebeat services on host 192.168.125.53
[+] Running 1/1
⠿ Container filebeat-filebeat-1  Started                                                                                                                                           10.8s
2025-02-05 05:06:16,488 [rdaf.component.minio] INFO     - configuring minio services logs
Successfully applied new settings.
Successfully applied new settings.
2025-02-05 05:06:16,936 [rdaf.component.log_monitoring] INFO     - Successfully installed and configured rdaf log streaming

Run the below command to see the status of all of the deployed RDAF log monitoring services.

rdaf log_monitoring status
+---------------------+----------------------+---------------------------+-------------------------+---------+
| Name                | Host                 | Status                    | Container Id            | Tag     |
+---------------------+----------------------+---------------------------+-------------------------+---------+
| logstash            | 192.168.125.53       | Up About a minute         | 62b3b7c81472            | 1.0.4   |
| filebeat            | 192.168.125.53       | Up About a minute         | c5f8a6f340b3            | 1.0.4   |
+---------------------+----------------------+---------------------------+-------------------------+---------+

1.2 Offline Install

Onpremise Setup With Offline Bundles

Use the procedures outlined in this section to install the RDAF platform using offline bundles. This installation method is recommended for environments without internet access or when connectivity to RDAF online repositories is unavailable.

1.1.1 Downloading RDAF Deployment CLI 1.5.0 Bundle

Methods for Downloading RDAF Offline Bundles

  • RDAF offline bundles can be downloaded to any jump host within the client environment that has internet access, and then copied to the VM hosting the RDAF registry server role. Ensure that network connectivity exists between the jump host and the target VM to enable the transfer of the offline bundles.

  • If the client environment has restrictions preventing the download of RDAF offline bundles, coordinate with the client to identify a suitable method for securely sharing the pre-downloaded bundles from your end.

Note

RDAF offline tag bundles for Platform and App version 8.2 are available exclusively for ubuntu operating systems.

  • Download the RDAF Deployment CLI's newer version 1.5.0 bundle and copy it to RDAF CLI 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/offline-ubuntu-1.5.0.tar.gz
  • Extract the rdaf CLI software bundle contents
tar -xvzf offline-ubuntu-1.5.0.tar.gz
  • Change the directory to the extracted directory
cd offline-ubuntu-1.5.0
  • Install the rdaf CLI to version 1.5.0
pip install --user rdafcli-1.5.0.tar.gz -f ./ --no-index
  • Verify the installed rdaf CLI version
rdaf --version

2. RDAF Registry Setup

  • Configure the registry using the below given command
rdaf registry setup -h
usage: registry setup [-h] [--install-root INSTALL_ROOT] [--docker-server-host DOCKER_SERVER_HOST] [--docker-registry-source-host DOCKER_SOURCE_HOST]
                      [--docker-registry-source-port DOCKER_SOURCE_PORT] [--docker-registry-source-project DOCKER_SOURCE_PROJECT]
                      [--docker-registry-source-user DOCKER_SOURCE_USER] [--docker-registry-source-password DOCKER_SOURCE_PASSWORD] [--no-prompt]

options:
  -h, --help            show this help message and exit
  --install-root INSTALL_ROOT
                        Path to a directory where the Docker registry will be installed and managed
  --docker-server-host DOCKER_SERVER_HOST
                        Host name or IP address of the host where the Docker registry will be installed
  --docker-registry-source-host DOCKER_SOURCE_HOST
                        The hostname/IP of the source docker registry
  --docker-registry-source-port DOCKER_SOURCE_PORT
                        port of the docker registry
  --docker-registry-source-project DOCKER_SOURCE_PROJECT
                        project of the docker registry
  --docker-registry-source-user DOCKER_SOURCE_USER
                        The username to use while connecting to the source docker registry
  --docker-registry-source-password DOCKER_SOURCE_PASSWORD
                        The password to use while connecting to the source docker registry
  --no-prompt           Don't prompt for inputs
  • For an offline installation of the registry, use the command
rdaf registry setup --docker-server-host <registry server ip> --docker-registry-source-host docker2.cloudfabrix.io --docker-registry-source-port 443 --docker-registry-source-user username --docker-registry-source-password xxxxxxxxx --docker-registry-source-project external --no-prompt --offline

Note

The username/password has not been provided in this documentation. If you need access credentials, please reach out to the Support Team at ([email protected])

rdauser@hariofflineregistry108131:~$ rdaf registry setup --offline
2025-07-23 05:16:15,913 [rdaf.cmd.dockerregistry] INFO     - Creating directory /opt/rdaf and setting ownership to user 1001 and group to group 1001
2025-07-23 05:16:16,016 [rdaf.cmd.dockerregistry] INFO     - Creating directory /opt/rdaf-registry/ and setting ownership to user 1001 and group to group 1001
2025-07-23 05:16:16,090 [rdaf.cmd.dockerregistry] INFO     - Creating directory /opt/rdaf-registry/config and setting ownership to user 1001 and group to group 1001
2025-07-23 05:16:16,164 [rdaf.cmd.dockerregistry] INFO     - Creating directory /opt/rdaf-registry/data and setting ownership to user 1001 and group to group 1001
2025-07-23 05:16:16,236 [rdaf.cmd.dockerregistry] INFO     - Creating directory /opt/rdaf-registry/log and setting ownership to user 1001 and group to group 1001
2025-07-23 05:16:16,318 [rdaf.cmd.dockerregistry] INFO     - Creating directory /opt/rdaf-registry/import and setting ownership to user 1001 and group to group 1001
2025-07-23 05:16:16,388 [rdaf.cmd.dockerregistry] INFO     - Creating directory /opt/rdaf-registry/deployment-scripts and setting ownership to user 1001 and group to group 1001
2025-07-23 05:16:16,470 [rdaf.cmd.dockerregistry] INFO     - Gathering inputs for proxy
2025-07-23 05:16:16,470 [rdaf.cmd.dockerregistry] INFO     - Gathering inputs for docker-registry
What is the host on which you want the Docker registry mirror server to be provisioned?
Docker registry server host[hariofflineregistry108131.engr.cloudfabrix.com]: 192.168.108.131
What is the hostname/IP of the docker registry whose contents need to be mirrored?
Docker registry source host: docker2.cloudfabrix.io
What is the port for the docker registry whose contents need to be mirrored?
Docker registry source port[]: 443
What is the project of the docker registry whose contents need to be mirrored?
Docker registry source project: external
What is the username for the docker registry whose contents need to be mirrored?
Docker registry source user[]: macaw
What is the password for the docker registry whose contents need to be mirrored?
Docker registry source password[]:
Re-enter Docker registry source password[]:
2025-07-23 05:17:17,984 [rdaf.cmd.dockerregistry] INFO     - Doing setup for proxy
2025-07-23 05:17:17,984 [rdaf.cmd.dockerregistry] INFO     - Doing setup for docker-registry
2025-07-23 05:17:20,031 [rdaf.component.dockerregistrymirror] INFO     - Created Docker registry configuration at /opt/rdaf-registry/config/docker-registry-config.yml on 192.168.108.131
2025-07-23 05:17:20,037 [rdaf.cmd.dockerregistry] INFO     - Setup completed successfully, configuration written to /opt/rdaf-registry/rdaf-registry.cfg

3. Downloading Infrastructure Bundle

  • Please download the 'All-Infra.tar.gz' file from the following URL
https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2/All-Infra.tar.gz
  • Please download the 'External Opensearch' file from the following URL
https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2/rda-platform-opensearch-1.0.4.1.tar.gz

Note

  • If you have already downloaded the software in step given download section ignore the above step.
  • Copy the downloaded offline infra bundles to /opt/cfx_software on VM hosting RDAF registry server role.
  • Untar the 'All-Infra.tar.gz' file by running the following given command
tar -xvzf All-Infra.tar.gz

All-Infra.tar.gz  - 4.306160542 gigabyte

rda-platform-opensearch.tar.gz  - 1029.852369 megabyte
rda-platform-haproxy.tar.gz - 182.07278 megabyte
rda-platform-busybox.tar.gz  - 2.149061 megabyte
rda-platform-kubectl.tar.gz  -  109.690924 megabyte
rda-platform-kafka.tar.gz  - 229.351941 megabyte
rda-platform-mariadb.tar.gz  - 133.30942 megabyte
rda-platform-nats.tar.gz - 12.396015 megabyte
rda-platform-prometheus-nats-exporter.tar.gz  - 7.565907 megabyte
rda-platform-nats-box.tar.gz  - 41.139901 megabyte
rda-platform-telegraf.tar.gz  - 222.317013 megabyte
rda-platform-logstash.tar.gz  - 1023.630364 megabyte
rda-platform-kube-arangodb.tar.gz  -  66.64376 megabyte
rda-platform-nats-boot-config.tar.gz  - 12.971209 megabyte
docker-registry.tar.gz  - 295.227198 megabyte
rda-platform-filebeat.tar.gz  - 285.381289 megabyte
minio.tar.gz  - 61.436229 megabyte
rda-platform-arangodb-starter.tar.gz  - 12.01858 megabyte
rda-platform-arangodb.tar.gz  - 240.012853 megabyte
mc-RELEASE.2024-11-21T17-21-54Z.tar  - 227.08992 megabyte
4. Loading Docker Image

  • Load the Docker image from the archive using the following command
docker load -i docker-registry.tar.gz
  • Run the following command to list the available Docker images
docker images
rdauser@hariofflineregistry108131:~$ docker load -i docker-registry.tar.gz
ec34fcc1d526: Loading layer [==================================================>]  5.811MB/5.811MB
7b35f2def65d: Loading layer [==================================================>]  736.3kB/736.3kB
f93fff1ab6f7: Loading layer [==================================================>]  18.09MB/18.09MB
6a4340199717: Loading layer [==================================================>]  4.096kB/4.096kB
4977497eb9c0: Loading layer [==================================================>]  2.048kB/2.048kB
39dbfc8f73cb: Loading layer [==================================================>]  6.144kB/6.144kB
7e6538a47f65: Loading layer [==================================================>]  673.4MB/673.4MB
2219e255dd2d: Loading layer [==================================================>]  34.67MB/34.67MB
a33e534d7d88: Loading layer [==================================================>]  252.2MB/252.2MB
789bacf5468f: Loading layer [==================================================>]  3.072kB/3.072kB
bcabefa6aac9: Loading layer [==================================================>]  3.072kB/3.072kB
87c19978dcb7: Loading layer [==================================================>]   2.56kB/2.56kB
Loaded image: docker2.cloudfabrix.io:443/external/docker-registry:1.0.4

5. Install On-Premise Docker Registry

  • Run the below command to install the on-premise docker registry service.
rdaf registry install --tag 1.0.4
rdauser@hariofflineregistry108131:~$ rdaf registry install --tag 1.0.4
2025-07-23 05:19:02,787 [rdaf.cmd.dockerregistry] INFO     - Installing docker-registry
2025-07-23 05:19:03,726 [rdaf.component.dockerregistrymirror] INFO     - Generating cert for docker registry that will run on host 192.168.108.131
2025-07-23 05:19:03,726 [rdaf.component.cert] INFO     - Creating self-signed certificate for rdaf

rdaf-info:    Certificate for: Self Signed CA
rdaf-info:    Location: /opt/rdaf-registry/cert/ca
rdaf-info:    Copying RDAF Platform Self-Signed CA certificate
rdaf-info:    Importing RDAF Trusted CAs into Trust store
rdaf-info:    Updating CA Certificates into Trust store
rdaf-info:    CA Certificate generation - Success

rdaf-info:    Certificate for: rdaf
rdaf-info:    Location: /opt/rdaf-registry/cert/rdaf
rdaf-info:    Certificate generation - Success
2025-07-23 05:19:06,791 [rdaf.component.dockerregistrymirror] INFO     - Installing docker registry on host 192.168.108.131
[+] Running 1/1
 ✔ Container deployment-scripts-docker-registry-1  Started                            

Note

Starting from version 1.0.4 onwards, MetalLB Installation is mandatory.

6. Downloading Remaining Offline Bundles

  • User can now retrieve all the image tar files using the following commands
https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2/All-Platform-tarfiles.tar.gz
https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2/All-OIA-tarfiles.tar.gz
https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2/All-onprem-tarfiles.tar.gz

Note

This step is optional. Customers who wish to install qdrant service needs to mount a 10GB disk and can run the below command to download the image.

https://macaw-amer.s3.us-east-1.amazonaws.com/releases/RDA/8.2/rda-platform-qdrant_1.0.4.tar.gz
  • Copy all the above tar files from /opt/cfx_software directory to /opt/rdaf-registry/import/ on the VM hosting RDAF registry server role.

7. Importing Registry Tags

  • Please run the registry import command to fetch the tags
rdaf registry import --file (filename)

Note

Infra is imported separately, while platform and application imports are handled using running tar files

User can find examples below that show how to import the various tar files

rdaf registry import --file rda-platform-opensearch.tar.gz
rdaf registry import --file rda-platform-haproxy.tar.gz
rdaf registry import --file rda-platform-busybox.tar.gz
rdaf registry import --file rda-platform-kafka.tar.gz
rdaf registry import --file rda-platform-mariadb.tar.gz
rdaf registry import --file rda-platform-nats.tar.gz
rdaf registry import --file rda-platform-prometheus-nats-exporter.tar.gz
rdaf registry import --file rda-platform-nats-box.tar.gz
rdaf registry import --file rda-platform-telegraf.tar.gz
rdaf registry import --file rda-platform-logstash.tar.gz
rdaf registry import --file rda-platform-nats-boot-config.tar.gz
rdaf registry import --file rda-platform-filebeat.tar.gz
rdaf registry import --file minio.tar.gz
rdaf registry import --file mc-RELEASE.2024-11-21T17-21-54Z.tar
rdaf registry import --file rda-platform-arangodb-starter.tar.gz
rdaf registry import --file rda-platform-arangodb.tar.gz
rdaf registry import --file All-onprem.tar.gz
rdaf registry import --file All-Platform.tar.gz
rdaf registry import --file All-OIA.tar.gz
rdaf registry import --file rda-platform-opensearch-1.0.4.1.tar.gz
rdauser@xxxxxofflineregistry108131:/opt/rdaf-registry/import$ rdaf registry import --file All-onprem.tar.gz
2025-07-23 05:20:50,467 [rdaf.component.dockerregistrymirror] INFO - time="2025-07-23T05:20:50Z" level=warning msg="'--tls-verify' is deprecated, instead use: --src-tls-verify, --dest-tls-verify"
2025-07-23 05:20:50,472 [rdaf.component.dockerregistrymirror] INFO - Getting image source signatures
2025-07-23 05:20:50,489 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:ae1044361ff90277acdff1df652e5ff6d17fcbacca8d882087b61fa182583424
2025-07-23 05:20:50,492 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:ba00d7ee869aa882b481fdf4f967c54d03b563cfe2e3dbd69041b1b27f8fe09f
2025-07-23 05:20:50,494 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:0a2b8c3196853140a53af2b0dc69285be4c5c9c828ebe69eba3c5555451d975d
2025-07-23 05:20:50,495 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:45a01f98e78ce09e335b30d7a3080eecab7f50dfa0b38ca44a9dee2654ac0530
2025-07-23 05:20:50,497 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:9b2f6cc150f3bfeec5c23c12207154f603fb96639716de6e79dc31504afa692b
2025-07-23 05:20:50,850 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:eb737cd85ee58700d190e494a94c6a693c4486796db229c67900aff4a976db8d
2025-07-23 05:20:50,880 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:1cc11c48346b02b144a2c01361d1d56ec8104d1f962886b6d3a91a06a29e3091
2025-07-23 05:20:50,922 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:5d0898d5b34c673613dd5f2483030ab737cbe596dee20ee9428dc7f2d1fd8fe8
2025-07-23 05:20:50,922 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:8da16bb4f401b5a114c8ec7c8ff8c67bebfceca9a6d21176990e5a54f2e6764b
2025-07-23 05:20:51,111 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:f8a9c0aac94f19ff7d4e73c1cba3a49a95fd47c3b00febb03f24a9c6dc5174a8
2025-07-23 05:20:51,172 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:c4b4acc3be846d689dd9b133369bda72e02de382bd4a0cf8f1334720bb3fcbcd
2025-07-23 05:20:51,635 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:6acdfccf5e3a569884fdf209c6e7cb4acffbdd21c6290d5c48c6f30dfb7e60ef
2025-07-23 05:20:52,252 [rdaf.component.dockerregistrymirror] INFO - Copying blob sha256:c2f846dedb2d88186d5923666ccddb897e664f9266f7cf3e5
rdauser@xxxxxxofflineregistry108131:/opt/rdaf-registry/import$ rdaf registry import --file minio.tar.gz
2025-07-23 05:40:50,882 [rdaf.component.dockerregistrymirror] INFO     - time="2025-07-23T05:40:50Z" level=warning msg="'--tls-verify' is deprecated, instead use: --src-tls-verify, --dest-tls-verify"
2025-07-23 05:40:52,308 [rdaf.component.dockerregistrymirror] INFO     - Getting image source signatures
2025-07-23 05:40:52,374 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:2c7299920ae3b8d5db618a90b7b44e948a149930edf732b8ca16a32e7cb6d9b9
2025-07-23 05:40:52,375 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:ec1a77f0e77fe32165e1fa965549ba899584e56b1d55b791179064cdf5be8332
2025-07-23 05:40:52,376 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:36fda48010fa806784cacec939f66ae7d19da3f6c06362555889f80c0fc09423
2025-07-23 05:40:52,378 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:842a0d83dc0c23a136ff7fd23e162e14b06f40cc679e949cb37b8ec569d54c70
Copying blob sha256:a96652cdc1e0e649d79bf62f3e3484ab9dc2f76a2f3ad127876b593440af466e
Copying blob sha256:a1da066d4129db3de796cf16c70f0903e6e1115961b2ab6d416527800f42762c
2025-07-23 05:40:52,704 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:44ceba3f418207d712158b5cf4e4e6088bc8dfe32bb1203d383b9cf897fe07ab
2025-07-23 05:40:52,761 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:94c5e9798ec9e2b0e12411cb45717683b424f7eb3ae0a2ea4fcb11d04d5dab6c
2025-07-23 05:40:52,838 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:3fe7735471bf841e0bcd495dbf70615b1cc4938f23d5a1bbaf5673f1b47a6343
2025-07-23 05:40:53,460 [rdaf.component.dockerregistrymirror] INFO     - Copying config sha256:6aed1b6949018d1659310e66dc076711c9a9efeffa578b337ac3d1b82e0e9153
2025-07-23 05:40:53,496 [rdaf.component.dockerregistrymirror] INFO     - Writing manifest to image destination
2025-07-23 05:40:53,508 [rdaf.component.dockerregistrymirror] INFO     - Storing signatures
2025-07-23 05:40:53,560 [rdaf.component.dockerregistrymirror] INFO     - Docker import of minio:RELEASE.2024-12-18T13-15-44Z completed.
rdauser@xxxxxxofflineregistry108131:/opt/rdaf-registry/import$ rdaf registry import --file rda-platform-arangodb-starter.tar.gz
2025-07-23 05:41:31,108 [rdaf.component.dockerregistrymirror] INFO     - time="2025-07-23T05:41:31Z" level=warning msg="'--tls-verify' is deprecated, instead use: --src-tls-verify, --dest-tls-verify"
2025-07-23 05:41:31,368 [rdaf.component.dockerregistrymirror] INFO     - Getting image source signatures
2025-07-23 05:41:31,383 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:0e182002b05f2ab123995821ef14f1cda765a0c31f7a6d260221558f6466535e
Copying blob sha256:d79ae28765475f5ee5d3e831efc534b5fd474dab2ba9a3ab9e89b4ff745adc3a
2025-07-23 05:41:31,384 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:5f70bf18a086007016e948b04aed3b82103a36bea41755b6cddfaf10ace3c6ef
2025-07-23 05:41:31,387 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:2cb34ec7f80fab525b16432a13fffd03a4d82e90b10a1ace31271ad0b0fe0384
2025-07-23 05:41:31,679 [rdaf.component.dockerregistrymirror] INFO     - Copying config sha256:7b4181d737af1e3abd3e1e2b0dfccd4a93e997e6ccd49f5686c45f9e87ea9c63
2025-07-23 05:41:31,715 [rdaf.component.dockerregistrymirror] INFO     - Writing manifest to image destination
2025-07-23 05:41:31,729 [rdaf.component.dockerregistrymirror] INFO     - Storing signatures
2025-07-23 05:41:31,748 [rdaf.component.dockerregistrymirror] INFO     - Docker import of rda-platform-arangodb-starter:1.0.4 completed.
rdauser@xxxxxxxofflineregistry108131:/opt/rdaf-registry/import$ rdaf registry import --file rda-platform-busybox.tar.gz
2025-07-23 05:43:43,547 [rdaf.component.dockerregistrymirror] INFO     - time="2025-07-23T05:43:43Z" level=warning msg="'--tls-verify' is deprecated, instead use: --src-tls-verify, --dest-tls-verify"
2025-07-23 05:43:43,602 [rdaf.component.dockerregistrymirror] INFO     - Getting image source signatures
2025-07-23 05:43:43,615 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:068f50152bbc6e10c9d223150c9fbd30d11bcfd7789c432152aa0a99703bd03a
2025-07-23 05:43:43,617 [rdaf.component.dockerregistrymirror] INFO     - Copying blob sha256:4bad8cdda880d9729944e25be9d42930a17d80333818885dd80922f3ad46622c
2025-07-23 05:43:43,760 [rdaf.component.dockerregistrymirror] INFO     - Copying config sha256:7212784b5ff0afb5cde16af913d5d6e225899796188331097cbcee54c6d96502
2025-07-23 05:43:43,810 [rdaf.component.dockerregistrymirror] INFO     - Writing manifest to image destination
2025-07-23 05:43:43,827 [rdaf.component.dockerregistrymirror] INFO     - Storing signatures
2025-07-23 05:43:43,835 [rdaf.component.dockerregistrymirror] INFO     - Docker import of rda-platform-busybox:1.0.4 completed.
  • Verify that all required tags have been successfully fetched, by using below given command
rdaf registry list-tags
  • If required, please delete old image-tags from the onpremise-registry, which are no longer used using the following command
rdaf registry delete-images --tag (tag1,tag2)

Note

If you are unable to fetch tags during the setup, please follow the steps below to configure the VMs to use the RDAF Registry Server

8. Configure VMs to Use the RDAF Registry Server

  • Log in to each VM hosting various RDAF roles (Infra, Platform, App, Worker, Event-Gateway, RDAF Studio, RDAF CLI, etc.).

  • Edit the Docker daemon configuration

sudo vi /etc/docker/daemon.json
  • Add the following line just above the last line in the daemon.json file
"insecure-registries" : ["<RDAF registry server IP:5000"]
  • Apply the changes by running the following commands
sudo systemctl daemon-reload
sudo systemctl restart docker
  • Use the following command to verify the configuration
sudo docker info
docker info
Operating System: Ubuntu 22.04.5 LTS
OSType: linux
Architecture: x86_64
CPUs: 12
Total Memory: 69.88GiB
Name: abcd
ID: 97b67371-541e-47ba-b879-e9b046394943
Docker Root Dir: /var/lib/docker
Debug Mode: false
Experimental: false
Insecure Registries:
X.X.X.X:5000
127.0.0.0/8
Live Restore Enabled: true

Note

Ensure port 5000 is allowed in firewall on all the VMs

9. Configure Firewall and Set Up Registry Access

sudo ufw allow 5000/tcp
sudo ufw reload
  • Copy the registry CA certificate using the below command
scp rdauser@<RDAF registry server IP>:/opt/rdaf-registry/cert/ca/ca.crt /opt/rdaf-registry/registry-ca-cert.crt
  • Configure the RDAF CLI to use the registry using the below command
rdaf setregistry --host <RDAF registry server IP> --port 5000 --cert-path /opt/rdaf-registry/registry-ca-cert.crt

10. Install RDAF Platform using the Downloaded Bundles

Install the RDAF platform using the downloaded bundles, and once all the tags are listed, begin the RDAF deployment by following the steps outlined in the link

2. Upgrades(Applications)

Please refer to the following documents for guidance on upgrading the OIA (AIOps) application services to the newer version.

2.1 Latest Version(Online Install)

2.2 Latest Version(Offline Install)

2.3 Previous Versions

2.4 Archived Versions

3. Upgrades (Operating System)