Table of Contents

v4.4.19

Common

Note

Security update: Mitigate a high-severity vulnerability by upgrading all products.

Change Type Description
Security As part of our ongoing commitment to product security and stability, we've implemented several improvements in this release:
• Mitigated high-severity CVE-2025-27598 in App Designer, Data Stream Designer, and AI Designer by upgrading SixLabors.ImageSharp from 3.1.5 to 3.1.7.
• Expanded the automated test coverage for Recommendations.
Security Ubuntu 20.04 LTS will reach its end of standard support on 31 May 2025. Running the XMPro Stream Host on an unsupported operating system may expose your environment to security vulnerabilities and compliance risks.

XMPro strongly recommends using the Docker-based Stream Host as the preferred method for all new installations and upgrades, and is supported on a wide range of modern platforms, including newer Ubuntu LTS releases.
Fix A change in v4.4.18 caused SSO integration with Azure AD to behave differently for guest accounts, and users are requested to link them again.
This has been resolved without requiring any changes to the guest username.

However, you need to make two configuration changes in Azure AD SSO to avoid AADSTS50146 authentication errors:
1. Open the app Manifest.
2. Set "acceptMappedClaims": true
Documentation The installation content for AWS and Windows Server 2022 (previously known as "On-Prem") have been updated.

When upgrading XMPro instances that use AI Notebooks installed via ARM deployments, you may encounter known issues with the automated upgrade process. The Azure installation has been updated with manual workarounds.

Integrations

Agents

Change Type Name Description
New Timeseries Logger v1.00 Allows you to capture timeseries data for selected parameters.
Enhancement Ollama GenAI v2.02 Replaced Python backend with REST API.
Enhancement Binary Classification ML v1.08 Support Linux Stream Hosts & upgrade the Microsoft.ML NuGet package.
Fix Meta Action Agent v1.14 Fixed backward compatibility issue introduced in v1.12. However, logging to the Data Stream Logs will take effect when used with Stream Host v4.4.19+.

Package Manager

v4.4.19. From this release onwards, the Package Manager version will align with the product version.

Change Type Description
Fix Several errors introduced in v1.13.18 were addressed:
• Crashes when saving new Connector
• Empty XMP files generated when saving an Agent

App Designer

Change Type Description
Documentation The Metablock documentation was updated to clarify that only plain text values are supported for encrypted Server Variables value mapping.

Stream Host

Change Type Description
Enhancement Configuration Simplification Gateway ID and Gateway Name are now optional parameters. If not provided, the system will auto-generate a GUID for Gateway ID and use the format [Image-Version]-[Gateway Id] for Gateway Name, reducing required configuration steps.
Enhancement Unified Container Repository All Stream Host images are now consolidated under the single xmpro.azurecr.io/stream-host repository. The previous separate xmprocontrib.azurecr.io repository has been eliminated for simplified image management.
Enhancement Streamlined Image Variants Reduced image complexity from 4+ variants to 3 clear options with version-specific tagging that includes base OS and Python version, making it easier to choose the right container image for your deployment:
4.4.19-bookworm-slim (Debian)
4.4.19-bookworm-slim-python3.12 (Debian with Python)
4.4.19-alpine3.21 (Alpine)
Enhancement Simplified Deployment Experience Minimum required environment variables reduced from 6 to 3 for basic setup. Basic deployment examples no longer require separate .env files, making initial configuration more straightforward.
Documentation Improved Documentation and Examples Added hardware requirements sizing guidelines, shell-specific examples for PowerShell and Bash/Terminal, improved Docker Compose YAML structure with better commenting, and Git Bash compatibility support with MSYS_NO_PATHCONV=1 for Windows users, providing clearer setup guidance and reducing deployment troubleshooting time.

NuGet Packages

Agent Development

XMPro.XMIoT.Framework

Change Type Description
Enhancement The IAgentLogger interface was added so that Agents can log errors, information, and warning messages to the Data Stream Logs, whereas the existing IPublishError publishes to the output error endpoint.

Connector Development

No changes.


Last modified: February 04, 2026