Stream Host
A Stream Host is an application that can either be installed as a Windows Service or as a Console Application. Stream Hosts enable Data Streams to run and execute actions and are also responsible for getting the configurations of Non-Virtual Agents.
It is recommended that you read the article listed below to improve your understanding of Stream Host.
How to Install a Stream Host
To install a Stream Host, follow the steps below:
Open the Collection page.
Select the Collection.
Click the Connection Profile button.
Enter Device Name.
Enter File Key.
Confirm the action.
7. Click the Download Host button. 8. Select the Platform. 9. Confirm the action.
After the download is finished, follow the installation wizard and use the Connection Profile which was downloaded in Steps 3-6.
Logs
How to Check Logs
To check the logs for a Steam Host, follow the steps below:
Open the Collection page.
Select the Collection.
Click the Stream Hosts button.
Select the desired Stream Host.
How to Set the Log Level
You can change the Log level to either Info or Trace. To change the Log Level, follow the steps below:
Open the Collection page.
Select the Collection.
Click the Stream Hosts button.
Select the desired Stream Host.
5. Click on Set Log level. 6. From the dropdown, select either Info or Trace.
7. Click on OK.
How to Filter Log Levels
You can filter and narrow down the errors and messages that have already been logged in the table. For example, if you filter for Info errors, only info level errors will be displayed. To filter the log level for a Steam Host, follow the steps below:
Open the Collection page.
Select the Collection.
Click the Stream Hosts button.
Select the desired Stream Host.
5. Click the icon next to the Level column. 6. Select the Log Level. 7. Click OK.
How to Clean the Logs
To clean the logs for a Steam Host, follow the steps below:
Open the Collection page.
Select the Collection.
Click the Stream Hosts button.
Select the desired Stream Host.
5. Click the Delete Logs button. 6. Confirm your action.
How to Export Logs
To export the logs for a Steam Host, follow the steps below:
Open the Collection page.
Select the Collection.
Click the Stream Hosts button.
Select the desired Stream Host.
Click the "three dots" button.
Click Export all data or Export Selected rows.
How to Find Online Hosts
To find online Stream Hosts, follow the steps below:
Open the Collection page.
Select the Collection.
Click the Stream Hosts button.
How to Override Variables
Although each Stream Host in a given Collection downloads the same definition of a Data Stream, the Variables defined in Data Stream Designer can be overridden by the individual Stream Host to provide the unique configuration e.g. per Asset, site, or OPC IP Address.
Retrieving variable values is evaluated in the following order:
Environment Variable, if no match then...
Variables.xv File, if no match then...
Local Variables (i.e. as detailed in Using a Variable)
To override variables for a Stream Host, see the following options
Using Environment Variables
v4.4.2
This option can be applied to any Stream Host install scenario, although it is better suited for when running Stream Host on Docker.
Create an environment variable that is applied to a running Stream Host instance, prefixing the name of the variable that should be overridden with xmvariable__
Using Variables.xv file
This option is not supported when running Stream Host on Docker.
Open the Collection page.
Select the Collection.
Hover on More.
Click Variables.
Click Select file and upload the encrypted variables.xv file, found in the Data folder of the Stream Host's installation directory e.g. "C:\Program Files\XMPro Stream Host\Data".
You can enter overrides for any Variables.
Click Download to get the updated file.
Replace the original file in your Stream Host folder with the new one.
Restart your Stream Host to load the updated variables.
Last updated
