Mac OS

Run the below commands to verify currently installed RDA prerequisites.

docker --version

docker-compose --version

python3 --version

pip3 --version

Step 1: Request software by contacting [email protected]. The following procedure assumes you received the download link.

Download the 'rda-docker-compose-with-ssl.tar' software package.

Step 2: Create a virtual environment using python3

python3 -m venv <name of the environment>
eg.
$ python3 -m venv rda-venv 

Step 3: Source virtual env that was created in Step 2 as shown below.

$ cd rda-venv 
$ source bin/activate
(rda-venv)$  

Step 4: Install docker-compose tool needed to install RDA as shown below

(rda-venv)$  pip3 install docker-compose
(rda-venv)$  docker-compose --version
docker-compose version 1.29.0, build 07737305

Note: Make sure docker-compose is installed properly

Step 5: Extract the 'rda-docker-compose-with-ssl.tar' software package under the user's home directory or some other directory.

tar -xvf rda-docker-compose-with-ssl.tar

Step 3: Run setup.py python script as shown below.

Below are the 'RDA' directory locations and their purpose.

/home/<userid>/cfx/cfxdx/config --> Location of the conf.yml file where many datasource credentials and other settings are configured.

/home/<userid>/cfx/cfxdx/output --> Location of the exported CSV / Excel / JSON files

Step 4: To access 'RDA' interface, open up a browser and enter the URL as https://ipaddress:9998

Step 4: Accessing RDA Page

Install RDA Datanetwork Components (Optional)

The following steps explain how to install Kafka/Zookeeper components needed for RDA Data network bots. Download docker-compose file required to install Kafka/Zookeeper and use the below steps to start Kafka/zookeeper docker instances (these instances in turn will be used by RDA runtime) bash# cd /home/macaw/ bash# mkdir -p kafka-zookeeper bash# cd kafka-zookeeper bash# wget <docker-compose-file> bash# <edit the file and add the ipaddress or FQDN of RDA machine> bash# docker-compose pull bash# docker-compose up -d In addition to the above steps, make sure you enable the following ports

sudo firewall-cmd --add-port=2181/tcp --permanent
sudo firewall-cmd --add-port=9092/tcp --permanent

sudo firewall-cmd --reload

Upgrade RDA

Step 1: Make sure the docker (desktop) environment is intact as per RDA installation prereqs. Also, docker-compose is available to the user (as shown in the below screenshot).

Step 2: Go to the directory where RDA was previously installed.

Step 3: Make sure RDA is up and running. This can be verified by running the docker command as shown in the below screenshot.

Step 4: Go to the directory where RDA was installed and also, docker-compose.yml is available (as shown in the below screenshot).

Step 5: Using the docker-compose command 'docker-compose down' and bring down the RDA instances that are running in your environment as shown in the below screenshot.

Step 6: Using the docker-compose command, upgrade RDA using the 'docker-compose pull' command as shown in the below screenshot.

Step 7: Start RDA upgraded instance using 'docker-compose up -d' as shown in the below screenshot.

Access RDA using https://<IPAddress>:9998 and verify the latest version.