Installation_Ubuntu

Installation on RHEL9 and Ubuntu 22.04

Installation on Ubuntu 22.04

BridgeCTL should technically work on any Linux distro with Python3.10 or newer and Docker or Podman installed. However, we only test on RHEL9, AmazonLinux2023 and latest Ubuntu LTS

Prerequisites

• Python >= 3.10
• Python3-venv
• Podman or Docker

Install Podman

Podman as a drop-in alternative to Docker available in Ubuntu repositories. Podman installation is easier and packages are maintained by Ubuntu maintainers. Podman is also fully compatible with Docker and all docker commands are available. However, if you prefer Docker, or already have it installed, skip to the next section.

sudo dnf -y install podman-docker

Running BridgeCTL as root is not the best idea. We need to allow current user to run Podman containers without root privileges. More details in Podman github tutorials

sudo usermod --add-subuids 100000-65536 --add-subgids 100000-65536 $USER

Also, ensure that podman socket enabled and running user and is exported as DOCKER_HOST

systemctl --user enable podman.socket
systemctl --user start podman.socket
systemctl --user status podman.socket
export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock

and finally add the export of DOCKER_HOST into users .bashrc (or any relevant rc file for your shel)

echo 'export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock' >> .bashrc

(Alternative) Install Docker

Follow official Docker documentation for installation on Ubuntu.

Running BridgeCTL as root is not the best idea. We need to allow current user to run Docker containers without root privileges, by adding user to the docker group

sudo usermod -a -G docker $USER
newgrp docker

Install Python3.10 ond venv

Ubuntu 22.04 comes with Python 3.10 pre-installed. However, Ubuntu does not bundle venv with Python3.10 anymore. You need to install it:

sudo apt update
sudo apt -y install python3-venv

Install BridgeCTL

BridgeCTL is easy to install. Just download and run the bridgectl_setup.py script using the following two commands:

curl -OL https://github.com/tab-se/bridgectl/releases/download/setup/bridgectl_setup.py
python3 bridgectl_setup.py

If installation is successful you should see menu bellow, you can head to the Usage section for more detail:

starting BridgeCTL
___________     ___.   .__                                
\__    ___/____ \_ |__ |  |   ____ _____   __ __ 
  |    |  \__  \ | __ \|  | _/ __ \\__  \ |  |  \ 
  |    |   / __ \| \_\ \  |_\  ___/ / __ \|  |  /
  |____|  (____  /___  /____/\___  >____  /____/ 
               \/    \/          \/     \/ 

Bridge CTL - A utility to build, run and monitor Tableau Bridge Agents in Containers
BridgeCTL version 2.3.19 is up-to-date

App settings not found. Creating new ...
created new config at /home/ubuntu/bridgectl/config/bridge_settings.yml
? Main Menu (Use arrow keys)
 » Start UI
   Stop UI
   Edit App Settings
   Help ->
   Quit