Install Stream Host

Want to run Stream Host in Docker? Please jump to "Docker instructions for Stream Host".

Download the Connection Profile

Each Data Stream created in Data Stream Designer must belong to a Collection. You can download the information in a Collection as a file, known as a Connection Profile. This profile includes the device name, collection ID, server URL, secret, and key.

To simplify installing a Stream Host (also called a device), download the Connection Profile to avoid manually copying Collection details from Data Stream Designer to the installer.

To obtain a Connection Profile, follow the steps below.

1. Log into Data Stream Designer and open the Collections page from the left-hand menu.

2. Select the Collection you wish to use. If there isn’t a Collection available, you can create one by clicking the New button, choosing a name for the collection, and clicking Ok.

3. Click on Connection Profile.

4. Choose a name for the device.

5. Enter the File Key.

6. Click Ok. The Connection Profile will automatically begin to download.

Fig 1. Steps to Set Up a Connection Profile

Download the Installer

Follow the steps below to download the XMPro Stream Host installer. From v4.4.7 onwards, ensure your network policy allows access to the download.app.xmpro.com domain.

1. Log into Data Stream Designer and open the Collections page from the left-hand menu.

2. Select the collection you wish to use.

3. Click on Download Host.

4. Select your desired platform.

5. Click on the Download button to begin the download.

Fig 2. Steps to Download the Installer

Choose your Platform

Choose the platform where you will install the Stream Host:

Windows x64Azure Web JobUbuntu 20.04 x64Docker

Troubleshooting

If your Stream Host is not appearing in a Data Stream Collection, follow these steps to troubleshoot:

1. Check the Stream Host logs:

   • By default, the Stream Host writes logs to STDOUT on the platform where it's running.

   • Review these logs for details on why your Stream Host is unable to connect.

2. Configure additional logging:

   • For more detailed information, you can configure additional logging for the Stream Host.

3. Verify Stream Host settings:

   • Ensure the Stream Host is properly configured with the correct endpoint and credentials.

4. Check system requirements:

   • Confirm that your system meets the minimum requirements for running the Stream Host.

5. Ensure accurate date and time settings:

   • Verify that the date and time on the Stream Host platform are exactly synchronized with the XMPro server time.

   • Even a one-minute discrepancy can cause authorization issues and prevent the Stream Host from connecting.

6. Common issues to look for:

   • Network connectivity problems

   • Incorrect configuration settings

   • Authentication issues

   • Time synchronization errors

7. If issues persist:

   • If you're still experiencing problems after checking these points, contact XMPro support for further assistance.