# Mac OS {% hint style="info" %} **Note**: Please check the [Installation](https://docs.cloudfabrix.io/rda/installation/..#prerequisites) Prerequisites before you proceed. {% endhint %} Run the below commands to verify currently installed RDA prerequisites. {% hint style="warning" %} **Note**: Please make sure the below commands are in the PATH variable in the user's login profile. {% endhint %} ``` docker --version ``` ``` docker-compose --version ``` ``` python3 --version ``` ``` pip3 --version ``` **Step 1**: Request software by contacting . 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 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 ``` ![RDA files extracted under rda-venv with the files](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-MZGWjITnA_uQtSAu_MA%2F-MZGdSCdTNWigojdLxb2%2FScreen%20Shot%202021-04-26%20at%209.45.44%20PM.png?alt=media\&token=6b521003-067e-4bff-92b1-955a7c1d730a) **Step 3**: Run setup.py python script as shown below. ![Successful installation and setup of RDA on Mac OS](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-MZGWjITnA_uQtSAu_MA%2F-MZGguoYjI26rOIGUslI%2FScreen%20Shot%202021-04-26%20at%2010.00.23%20PM.png?alt=media\&token=5cfb69d0-beec-4f59-a86c-5c6d67dba944) {% hint style="info" %} **Note:** The setup.py creates a directory called '**cfx**' under user's home directory for configuration files and exported files. (Ex: /home/\/cfx) {% endhint %} Below are the '**RDA**' directory locations and their purpose. **/home/\/cfx/cfxdx/config -->** Location of the **conf.yml** file where many datasource credentials and other settings are configured. **/home/\/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 **** {% hint style="info" %} Note: Access RDA using https\://\:9998/ The default user name is rdademo and the password is rdademo1234 {% endhint %} ![](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-MYNLHdz5WZfHSYW_DbO%2F-MYNMC4YMBEUnLOQYPKW%2FScreen%20Shot%202021-04-15%20at%206.47.40%20PM.png?alt=media\&token=d485579f-13a6-4350-9042-93d062683d30) {% hint style="info" %} Note: Default username/password can be changed from docker-compose.yml file under RDA install directory. {% endhint %} ![](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-MYNLHdz5WZfHSYW_DbO%2F-MYNNWNe1IYe8mY802Ht%2FScreen%20Shot%202021-04-15%20at%206.53.25%20PM.png?alt=media\&token=67123c03-ae70-40b0-81c1-19170d230d67) **Step 4**: Accessing RDA Page ![](https://gblobscdn.gitbook.com/assets%2F-MAygHzNCQ33zRR43qxF%2F-MU5fW7ACtSz0eFXwN_R%2F-MU5hvJLvlR70BiHpRus%2FScreen%20Shot%202021-02-21%20at%202.30.48%20PM.png?alt=media\&token=e686c01f-6347-4a08-b180-64b325bc040d) ![](https://gblobscdn.gitbook.com/assets%2F-MAygHzNCQ33zRR43qxF%2F-MU5fW7ACtSz0eFXwN_R%2F-MU5igvt250LEDag7g3y%2FScreen%20Shot%202021-02-21%20at%202.34.14%20PM.png?alt=media\&token=26e84ec8-5d6d-407a-be03-538f6824652a) ### Install RDA Datanetwork Components (Optional) The following steps explain how to install Kafka/Zookeeper components needed for RDA Data network bots.\ \ Download [docker-compose](https://macaw-amer.s3.amazonaws.com/rda/rda-components/kafka-zookeeper/docker-compose.yml) 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 \\ bash# \\ 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). ![](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-McQP9V-YKcPOuqssrU8%2F-McQV-kPl43rC8JmKIKU%2FScreen%20Shot%202021-06-17%20at%2012.43.28%20PM.png?alt=media\&token=945bceab-31ca-456a-85b9-51c15a17e054) Step 2: Go to the directory where RDA was previously installed. ![Goto directory where RDA was installed previously](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-McQV8lHVNVBu4e02GNo%2F-McQVQiuq7POK9lpj8Nq%2FScreen%20Shot%202021-06-17%20at%2012.45.21%20PM.png?alt=media\&token=cd261bc6-1944-48be-be0f-367f209bbc7b) Step 3: Make sure RDA is up and running. This can be verified by running the docker command as shown in the below screenshot. ![Make sure RDA (cfxdx) is up and running using the command 'docker ps -a' as shown above.](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-McQVSdqQMOJ0iNlWS9m%2F-McQW2nrLRvboet1mlId%2FScreen%20Shot%202021-06-17%20at%2012.47.28%20PM.png?alt=media\&token=fa837ace-0190-4a85-a1b4-d9e2be282401) Step 4: Go to the directory where RDA was installed and also, docker-compose.yml is available (as shown in the below screenshot). ![RDA directory with docker-compose.yml file ](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-McQWR6jH63BP6YciejA%2F-McQWg8Eg_OY-BxqvHXt%2FScreen%20Shot%202021-06-17%20at%2012.50.47%20PM.png?alt=media\&token=9eb56ad2-edd6-4d91-8792-8c0ff8f6039b) 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. ![docker-compose down will delete the old RDA containers (as shown above)](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-McQk1gVHBWUM2I7nopu%2F-McQkU85N-i2aSoCL__q%2FScreen%20Shot%202021-06-17%20at%201.55.27%20PM.png?alt=media\&token=a0469d27-9491-4e64-8935-7f64bc0bece0) Step 6: Using the docker-compose command, upgrade RDA using the 'docker-compose pull' command as shown in the below screenshot. ![docker-compose pull will download/install latest images from registry (as shown above)](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-McQksYMvwGOXtLgzyH3%2F-McQpQK-JK6WdABML11X%2FScreen%20Shot%202021-06-17%20at%202.16.41%20PM.png?alt=media\&token=9b7ca58d-eb2b-45de-aa8e-fe9ba93ea00b) Step 7: Start RDA upgraded instance using 'docker-compose up -d' as shown in the below screenshot. ![](https://2978683539-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhoMVYxiQlKXh6OxX98%2F-McQpgsGThXNW_OcPj_X%2F-McQq9_HfpfCeJrx-Rk1%2FScreen%20Shot%202021-06-17%20at%202.20.15%20PM.png?alt=media\&token=d94c55f2-dbd2-430c-a4d4-eab667c96975) Access RDA using **https\://\:9998** and verify the latest version.