Installation
Ensure the desired server meets the minimum requirements.
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
-
Install the following required dependencies
sudo apt install -y unzip nvme-cli sysfsutils
Install Docker
-
Install Docker using the apt repository as per the instructions provided by Docker
warningIf docker has not been installed, or installed incorrectly the Bitstreams will not properly install.
-
Add the current user to the
dockergroupsudo usermod -aG docker $USER -
Log out and log back in so that your group membership is re-evaluated.
Download Release
- x86_64 / amd64
- ARM
-
Download the Bitstreams Release
Download: x86_64 / amd64wget https://releases.netint.com/edge/IWTIP40WQVX5AHZ/Bitstreams_Edge_v2.10.0_x86.zip -
Extract the software package and enter the directory.
unzip Bitstreams_Edge_v2.10.0_x86.zipcd ~/Bitstreams_Edge_v2.10.0_x86
This release is recommended for x86 / AMD processors. If you would like to use this release on an ARM processor please contact support.
-
Download the Bitstreams Release
Download: arm64 / aarch64wget https://releases.netint.com/edge/IWTIP40WQVX5AHZ/Bitstreams_Edge_v2.10.0_arm.zip -
Extract the software package and enter the directory.
unzip Bitstreams_Edge_v2.10.0_arm.zipcd ~/Bitstreams_Edge_v2.10.0_arm
Install Script
-
Use the quick install script as shown below:
warningThe 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 -
Run the installation script using the basic install process
./edge_quick_install.py 10.0.100.10 http, where you replace10.0.100.10with your server's IP address. -
Follow the instructions in the installation script to complete the process.
-
Once the installation is complete and successful, you should see something similar to ths:
Starting Bitstreams services...
[+] up 13/13
✔ Volume configs_shared-tmpfs Created 0.0s
✔ Container configs-mysql-1 Healthy 31.9s
✔ Container configs-nginx-1 Created 1.2s
✔ Container configs-gateway-1 Created 1.2s
✔ Container configs-etcd-1 Healthy 32.4s
✔ Container configs-redis-endpoint-1 Healthy 11.9s
✔ Container configs-stream-live-1 Created 1.2s
✔ Container configs-minio-1 Created 1.2s
✔ Container configs-stream-trans-1 Healthy 31.2s
✔ Container configs-db-migration-1 Created 0.0s
✔ Container configs-lms-1 Healthy 41.8s
✔ Container configs-nvs-1 Healthy 51.8s
✔ Container configs-notification-1 Created
Completed.
The Quadra VPUs are upgraded from within one of the docker containers. Do not reboot until the upgrade has been completed
- The Quadra VPUs are automatically upgraded and managed by the docker container. The upgrade may be required. Login into the UI to check the progress. After the upgrade has been completed it is recommended to reboot the server.
Once the upgrade has been completed, the warning banner will automatically disappear.
- Check the status using
docker ps, the output should look similar to the one below.
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
a9b7e39e322e yyz1harbor01.netint.ca/bitstreams/notification:release_v2.10.0_RC1 "./notification --co…" 24 hours ago Up 24 hours (healthy) configs-notification-1
865c5156ec83 yyz1harbor01.netint.ca/bitstreams/nvs:release_v2.10.0_RC1 "./nvs --config conf…" 24 hours ago Up 24 hours (healthy) configs-nvs-1
db0ba081df52 yyz1harbor01.netint.ca/bitstreams/lms:release_v2.10.0_RC2-bqe "./lms --config conf…" 24 hours ago Up 24 hours (healthy) configs-lms-1
5d8dcb170fa1 yyz1harbor01.netint.ca/bitstreams/stream-trans:release_v2.10.0_RC2-release_v2.10.0_RC2 "./stream-trans --co…" 24 hours ago Up 24 hours (healthy) configs-stream-trans-1
012c0f2e8dac yyz1harbor01.netint.ca/bitstreams/gateway:release_v2.10.0_RC1-release_v2.10.0_RC2-bqe "/bin/sh -c 'crond &…" 24 hours ago Up 24 hours (healthy) configs-gateway-1
f980e041f293 yyz1harbor01.netint.ca/bitstreams/nginx:1.26.3 "/docker-entrypoint.…" 24 hours ago Up 24 hours (healthy) configs-nginx-1
cb377dd6b167 yyz1harbor01.netint.ca/bitstreams/redis:7.2.5 "/opt/bitnami/script…" 24 hours ago Up 24 hours (healthy) configs-redis-endpoint-1
a58514f4481b yyz1harbor01.netint.ca/bitstreams/mysql:8.0 "/opt/bitnami/script…" 24 hours ago Up 24 hours (healthy) configs-mysql-1
9215f96c56ff yyz1harbor01.netint.ca/bitstreams/stream-live:release_v2.10.0_RC1 "./start_srs.sh" 24 hours ago Up 24 hours (healthy) configs-stream-live-1
72b86c8322d7 yyz1harbor01.netint.ca/bitstreams/minio:2024.7.15 "/opt/bitnami/script…" 24 hours ago Up 24 hours (healthy) configs-minio-1
cbfb39fb22d8 yyz1harbor01.netint.ca/bitstreams/etcd:3.5.7 "/opt/bitnami/script…" 24 hours ago Up 24 hours (healthy) configs-etcd-1
Access User Interface
-
Log into the Bitstreams User Interface using the server IP that you entered during the installation, eg:
http://10.0.100.10.infoBitstreams has only one default user and currently does not support creating additional users.
Username Password Bitstreams UI [email protected]user.Bitstreams.NETINTwarningIt is recommended to change the default password.
