Installation_Ubuntu

Installation on RHEL9 and Ubuntu 22.04

Installation on RHEL9 and 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 and latest Ubuntu LTS (currently 22.04).

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, you can also use Docker if you prefer it, skip to the next section.

sudo apt -y update
sudo apt -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-165536 --add-subgids 100000-165536 $USER

(Alternatively) Install Docker

Follow official Docker Instructions for 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:

Download BridgeCTL:

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