Ubuntu 20.04 x64

Prerequisites

Downloads

Follow the instructions in the Install Stream Host guide to download the connection profile and installer.

Hardware and Software

XMPro Stream Host requires certain hardware and software specifications in order to install and run.

Refer to the hardware requirements and the software requirements in the 1. Preparation guide.

Software Install Commands

Install required dependencies using the following commands:

sudo apt-get update
sudo apt-get install -y wget liblttng-ust0 libkrb5-3 zlib1g uuid-runtime systemd 

# Install Dotnet Runtime
wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install -y aspnetcore-runtime-8.0
sudo apt-get install -y dotnet-runtime-8.0

# Install Libssl
wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl1.0/libssl1.0.0_1.0.2n-1ubuntu5_amd64.deb
sudo dpkg -i libssl1.0.0_1.0.2n-1ubuntu5_amd64.deb

# Downgrade Libcurl
sudo apt-get remove -y libcurl4
wget http://archive.ubuntu.com/ubuntu/pool/main/c/curl3/libcurl3_7.58.0-2ubuntu2_amd64.deb
sudo dpkg -i libcurl3_7.58.0-2ubuntu2_amd64.deb
sudo apt-mark hold libcurl3

Install

When you are ready, you may install the Stream Host by using the following command:

sudo dpkg -i /home/adminuser/xmpro-stream-host.deb

During the installation process, you will be asked a few questions:

  • Enter a Friendly Name for this Stream Host

    This is the name that appears when you view the Stream Hosts online.

  • Enter Server Url to connect to

    This is the server where Data Stream Designer is hosted, for example: “https://mysampleserver/datastreamdesigner/“. Please note that this URL needs to end in a forward slash.

  • Enter Collection Id

    This is the ID of your Collection and can be copied from Data Stream Designer.

  • Enter collection secret Key

    This is the secret key of your Collection and can be copied from Data Stream Designer.

  • Enter encryption key

    This is the key that the Stream Host will use to encrypt or decrypt secure user settings, for example, a SQL Server password.

These settings can be found in Data Stream Designer:

Uninstall

To uninstall a Stream Host, use the following command:

sudo dpkg -r xmpro-stream-host

The Stream Host will then be removed. Some files, such as logs, may not be removed because they were created after the installation.

Next Step: Agents & Connectors

The stream host installation is complete. Please click below to install the default Agents & Connectors:

Install Agents & Connectors

Last updated