Skip to main content
Version: v2.8.0

Installation

Ensure the desired server meets the minimum requirements.

License is Required

Bitstreams Software requires a valid license. Without a valid license the Software will operate in read-only mode.

To apply a new or updated license see the License section in the User Guide.

Install Dependencies​

  1. Install the following required dependencies

    sudo apt install -y unzip nvme-cli sysfsutils

Install Docker​

  1. Install Docker using the apt repository as per the instructions provided by Docker

    warning

    If docker has not been installed, or installed incorrectly the Bitstreams will not properly install.

  2. Add the current user to the docker group

    sudo usermod -aG docker $USER

  3. Log out and log back in so that your group membership is re-evaluated.

Download Release​

  1. Download the Bitstreams Release

    Download: x86_64 / amd64 

    wget https://releases.netint.com/edge/5F4HFJPAPWM39HP/Bitstreams_Edge_v2.8.0_x86.zip

  2. Extract the software package and enter the directory.

    unzip Bitstreams_Edge_v2.8.0_x86.zip
    cd  ~/Bitstreams_Edge_v2.8.0_x86

Install Script​

  1. Use the quick install script as shown below:

    warning

    The quick install script requires Python 3.8+

    # Basic usage
    ./edge_quick_install.py <ipv4Addr> {http,https}

    # Example installation
    ./edge_quick_install.py 10.0.100.10 http

    # For advanced features and to view all options
    ./edge_quick_install.py -h
    Installing on Akamai

    If you are installing Bitstreams on VM hosted by Akamai, you will need to skip the firmware upgrade with the --skip-firmware-upgrade parameter.

    ./edge_quick_install.py <ipv4Addr> {http,https} --skip-firmware-upgrade

  2. Run the installation script using the basic install process ./edge_quick_install.py 10.0.100.10 http, where you replace 10.0.100.10 with your server's IP address.

  3. Follow the instructions in the installation script to complete the process.

  4. Once the installation is complete and successful, you should see:

[+] Running 12/12
✔ Container configs-stream-live-1             Started             0.6s
✔ Container configs-redis-endpoint-1          Healthy             11.1s
✔ Container configs-etcd-1                    Healthy             31.7s
✔ Container configs-nginx-1                   Started             0.6s
✔ Container configs-mysql-1                   Healthy             31.1s
✔ Container configs-minio-1                   Started             0.6s
✔ Container configs-gateway-1                 Started             0.6s
✔ Container configs-db-migration-1            Started             31.0s
✔ Container configs-stream-trans-1            Healthy             31.5s
✔ Container configs-lms-1                     Healthy             42.0s
✔ Container configs-nvs-1                     Healthy             51.7s
✔ Container configs-notification-1            Started             51.8s

Completed.

  1. Check the status using docker ps, the output should look similar to the one below.
CONTAINER ID   IMAGE                                                                                  COMMAND                  CREATED        STATUS                PORTS     NAMES
2e3258ff9e26   yyz1harbor01.netint.ca/bitstreams/notification:release_v2.8.0_RC1                      "./notification --co…"   8 days ago     Up 8 days (healthy)             configs-notification-1
73e606d31b0d   yyz1harbor01.netint.ca/bitstreams/nvs:release_v2.8.0_RC1                               "./nvs --config conf…"   8 days ago     Up 8 days (healthy)             configs-nvs-1
4a31d4c05e37   yyz1harbor01.netint.ca/bitstreams/lms:release_v2.8.0_RC3-bqe                           "./lms --config conf…"   8 days ago     Up 8 days (healthy)             configs-lms-1
18d80c2dc52b   yyz1harbor01.netint.ca/bitstreams/stream-trans:release_v2.8.0_RC4-release_v2.8.0_RC4   "./stream-trans --co…"   8 days ago     Up 8 days (healthy)             configs-stream-trans-1
5caa7b6e3bee   yyz1harbor01.netint.ca/bitstreams/gateway:release_v2.8.0_RC3-release_v2.8.0_RC3-bqe    "/bin/sh -c 'crond &…"   8 days ago     Up 8 days (healthy)             configs-gateway-1
c76d5658857b   yyz1harbor01.netint.ca/bitstreams/mysql:8.0                                            "/opt/bitnami/script…"   8 days ago     Up 8 days (healthy)             configs-mysql-1
a275245c180f   yyz1harbor01.netint.ca/bitstreams/nginx:1.26.3                                         "/docker-entrypoint.…"   8 days ago     Up 8 days (healthy)             configs-nginx-1
066f10901130   yyz1harbor01.netint.ca/bitstreams/minio:2024.7.15                                      "/opt/bitnami/script…"   8 days ago     Up 8 days (healthy)             configs-minio-1
8929cfefbe23   yyz1harbor01.netint.ca/bitstreams/stream-live:release_v2.8.0_RC1                       "./start_srs.sh"         8 days ago     Up 8 days (healthy)             configs-stream-live-1
1680ce547a62   yyz1harbor01.netint.ca/bitstreams/etcd:3.5.7                                           "/opt/bitnami/script…"   8 days ago     Up 8 days (healthy)             configs-etcd-1
04a082c6781b   yyz1harbor01.netint.ca/bitstreams/redis:7.2.5                                          "/opt/bitnami/script…"   2 months ago   Up 8 days (healthy)             configs-redis-endpoint-1

Access User Interface​

  1. Log into the Bitstreams User Interface using the server IP that you entered during the installation, eg: http://10.0.100.10.

    info

    Bitstreams has only one default user and currently does not support creating additional users.

    UsernamePassword
    Bitstreams UI[email protected]user.Bitstreams.NETINT
    warning

    It is recommended to change the default password.

User Guide​

User Guide

User Guide

Bitstreams User Guide.

License

License

Obtain a License