# Linux OS {% hint style="info" %} **Note**: Please check the [Installation](/rda/installation.md#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. ``` wget https://macaw-amer.s3.amazonaws.com/rda/rda-docker-compose-with-ssl.tar ``` **Step 2**: 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 related files](/files/-MYNJg4-GKfOjCbQQqJC) **Step 3**: Run setup.py python script as shown below. ![](/files/-MYNL9vsyBN3T7EbPSKo) {% 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/macaw/cfx) {% endhint %} Below are the '**RDA**' directory locations and their purpose. **/home/macaw/cfx/cfxdx/config -->** Location of the **conf.yml** file where many datasource credentials and other settings are configured. **/home/macaw/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 **** Note: If firewall service is running, enable port 9998/tcp to access RDA service through a browser. {% hint style="warning" %} **Note**: If firewall service is running, enable port 9998/tcp to access RDA service through a browser. {% endhint %} **CentOS:** ``` sudo firewall-cmd --add-port=9998/tcp --permanent ``` ``` sudo firewall-cmd --reload ``` **Ubuntu:** This section provides additional steps to deploy RDA on Ubuntu OS (Certified on 18.04). Using the currently logged-in user, run the following commands to make sure the user has sufficient permissions. ``` macaw@ubuntu-test-box: sudo groupadd docker macaw@ubuntu-test-box: sudo gpasswd -a $USER docker ``` ``` macaw@ubuntu-test-box: docker ps ``` * If the above command throws an error 'permission denied error', run the following command to provide sufficient privileges to the currently logged-in user to run docker (Skip this step if the command does not throw permission denied error or the user has sufficient privileges/permissions). ``` macaw@ubuntu-test-box: sudo chmod 666 /var/run/docker.sock ``` * Run the following commands to install docker-compose for the currently logged-in user. ``` macaw@ubuntu-test-box: sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose macaw@ubuntu-test-box: sudo chmod +x /usr/local/bin/docker-compose macaw@ubuntu-test-box: sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose ``` ``` macaw@ubuntu-test-box: sudo ufw allow 9998/tcp ``` {% hint style="info" %} Note: Access RDA using https\://\:9998/ The default user name is rdademo and the password is rdademo1234 {% endhint %} ![](/files/-MYNMC4YMBEUnLOQYPKW) {% hint style="info" %} Note: Default username/password can be changed from docker-compose.yml file under RDA install directory. {% endhint %} ![](/files/-MYNNWNe1IYe8mY802Ht) **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). ![docker-compose along with docker-compose.yml is available in user environment](/files/-McQAicqiFZbC3xCFd5T) Step 2: Go to the directory where RDA was previously installed. ![Directory location where RDA was installed (earlier)](/files/-McQBNsLxkX6pmeOEg4m) Step 3: Make sure RDA is up and running. This can be verified by running the docker command as shown in the below screen shot. ![RDA instance (cfxdx) is up and running](/files/-McQDNV0TKmUUlr3VpqD) Step 4: Go to the directory where RDA is installed and also, docker-compose.yml is available (as shown in the below screenshot). ![docker-compose.yml file is needed to upgrade RDA (as shown above)](/files/-McQDdb4SJgQfYYU43Qm) 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 will bring the services down as shown](/files/-McQGzMNVPQ7tr92fulw) 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 pull the latest images from docker registry and install that.](/files/-McQHWZbqXX-0MySaa3M) Step 7: Start RDA upgraded instance using 'docker-compose up -d' as shown in the below screen shot. ![docker-compose will start the latest containers as shown above](/files/-McQIMt_SeA3LgkPvWD1) Step 8: Verify the RDA docker instances to be up-and-running using the 'docker ps -a' command as shown below screenshot. ![docker ps -a will show the status of RDA (cfxdx) containers to be up and running after upgrade](/files/-McQJ4lAxDycMXpHndP5) Access RDA using **https\://\:9998** and verify the latest version. ### --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.cloudfabrix.io/rda/installation/rda-linux-os.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.