Lightbits Over Ubuntu

AI Tools

This article describes installation on Ubuntu based storage targets in containerized versions of Lightbits storage. See the Lightbits Installation Guide Introduction for additional information.

Prerequisites

Note:

Before getting started, you should review the general prerequisites for any Lightbits installation. See General System Requirements for additional information.

  • Ubuntu 24.04

  • Netplan installed

  • Standard Fio utility installed and available in the default path

  • Standard ~/bin/bash utility installed and available in the default path

  • Podman installed and available in the default path

  • Entitlement to Cloudsmith

  • Network uses MTU 1500

  • Data (NICs) IPs configured correctly in the host_vars file.

Installation Steps

Cluster Side

Bring up a clean cluster using Ubuntu 24.04.

Installation Machine

  1. Bring up/use a dedicated server to run Ansible.

  2. Create a directory to run Ansible from:

    1. mkdir light-apps

    2. cd light-apps

  3. Fetch the release specific ansible tar:

curl -1 https://dl.lightbitslabs.com/<YOUR_TOKEN>/lightos-3-19-2-containers/raw/files/light-app-install-environment-v3.19.2b28724336105.tgz?accept_eula=1 -o light-app-install-environment-v3.19.2b28724336105.tgz tar -xvf light-app-install-environment-v3.19.2b28724336105.tgz
  1. Edit the all.yaml add path to containers and mode of operation:

vi ansible/inventories/cluster_example/group_vars/all.yml

Add these:

image_repo_prefix: docker.lightbitslabs.com/lightos-3-19-2-containers image_tag: 3.19.2 run_in_container: true install_podman: false registry_token: <YOUR_TOKEN>
  1. Edit the server files, and update the data IPs and other configs such as n devices, max devices, etc.

vi ansible/inventories/cluster_example/host_vars/server00.yml vi ansible/inventories/cluster_example/host_vars/server01.yml vi ansible/inventories/cluster_example/host_vars/server02.yml
  1. Fetch a Lightbits Ansible Docker image. This is optional; Docker will pull it automatically in the next step. If fetching manually, use at least Ansible v9.13.0-1.

  2. Run the Ansible installation:

docker run -it --rm --net=host \ -e UID=`id -u` \ -e GID=`id -g` \ -e UNAME=$USER \ -v `pwd`:/ansible \ -w /ansible \ -e ANSIBLE_LOG_PATH=/ansible/ansible.log \ docker.lightbitslabs.com/lightos-3-19-2-containers/lb-ansible:v9.13.0-1 \ sh -c 'ansible-playbook \ -e system_jwt_path=/ansible/lightos_jwt \ -e certificates_directory=/ansible/lightos-certificates \ -i ansible/inventories/cluster_example/hosts \ playbooks/deploy-lightos.yml -vvv'