Installing a Stream Host

In this section of the guide, we are going to install the stream host. Start by unzipping the installer .zip file you’ve downloaded in the previous section and follow the steps below.

Step 1: Wizard Start

Open the Gateway.Host.Console.Setup.msi file as administrator. When the installation wizard opens, click Next. Read and accept the license agreement by selecting the check box at the bottom and click Next.

Step 2: Select the Destination Folder

Choose a location where the stream host should be installed by clicking on the Change button and browsing to the directory you would like to use. You may also leave the default option as is. Click Next.

Step 3: Host Type

Select the type of host you would like to install and click Next. You can either install the stream host as a Windows Service or as a Console application.

The host type you need to choose will depend on your requirements. If you are installing the stream host for testing purposes, choose Console Application. If you are installing it to use it in a production environment, it is recommended that you choose to install it as a Windows Service.

Please note that a Windows Service will automatically start after installation completes. The Console application; however, needs to be run as administrator from the Start menu.

If you installed the stream host as a Console application, the stream host will be listed in the Start menu under the name “XMPro Stream Host“. If the stream host was installed as a Windows Service, the name of the service will be the same as the “Device Name” you specified when you downloaded the connection profile file or manually added the name to the installer.

Step 4: Configure Connection Settings

Select your preferred setup mode. If you choose to set up the stream host using a connection profile, choose Connection Profile. Otherwise, select Manual. Click Next.

Uploading a Collection Profile

If you selected Connection Profile, upload the connection profile file you’ve downloaded earlier in the guide. Click Next again and let the wizard install the stream host. If you selected Manual, see the section below for instructions on how to set it up.

Manually Providing Connection Settings

If you decide to manually set up the connection settings for the stream host, you can find the values you need by following the steps below.

Choose a name for the device.
Log into XMPro IoT and open the Collections page from the left-hand menu.
Select the collection you wish to use.
Copy the ID of the collection from XMPro IoT to your clipboard by clicking on the copy button and paste it in the Collection Id field in the installer.
Copy the Key field in XMPro IoT to your clipboard by clicking on the copy button and paste it in the Collection Secret field in the installer.
Add the Server URL for XMPro IoT in the installer, for example “http://localhost/xmiot/“.
Add an encryption key that can be used in the Encryption Key field in the installer.
Click Next and let the wizard install the stream host.