Chat now with support
Chat with Support

On Demand Global Settings Current - User Guide

Working with On Demand Overview of On Demand Signing up for On Demand Managing organizations and regions Adding users to an organization Managing your Microsoft Entra tenants and on-premises domains On Demand Home page Configuring settings Documentation roadmap Technical Support

On-premises agent prerequisites

You must meet the following prerequisites to download and install an agent for on-premises data collection from specified domains:

•
You must have the On Demand Organization Admin role and specifically must have the Can Configure Agents (core.configureAgents) permission.
•
You must have a passphrase, which you create on the How to Add an Agent page, that you enter when installing the agent.
•
You must have a valid paid subscription for the On Demand module with which you are using the agent.
•
The login account that you use to run the agent setup program must have local administrator rights.

The agent setup program will prompt you for service account credentials (username and password) that are used to run the agent service. The agent service account must be a domain account and must have local administrator rights on the computer on which the agent is being installed. Also, for License Management, the service account must have Write Members permissions on the directory group objects.

On-premises agent supported operating systems

Installation platforms (x64) supported for the following versions:

•
Windows Server 2016
•
Windows Server 2019
•
Windows Server 2022
•
Windows Server 2025

On-premises agent system configuration requirements

The agent requires:

•
LDAP (TCP 389) connectivity to all domain controllers in the local domain.
•
SMB TCP port 445 open on the domain controllers.
•
The following Windows services running:
•
DNS client
•
Remote Procedure Call (RPC)
•
Windows event log

The agent uses:

•
The Windows (Internet Explorer) Proxy Server settings applied to the service account or computer where it is installed.
•
MQTT over WebSockets - TCP 443 for IoT Hub communication.
•
HTTPS - TCP 443 for upload/download of files.
•
The login account that you use to run the agent setup program must have the Windows (Internet Explorer) Proxy Server settings configured if your environment requires a Proxy Server to access the Internet.

The agent footprint:

•
Estimated hard disk space used: 160 MB + log size.
•
By default, up to 10 MB of log files are retained.
•
Estimated physical memory (RAM) used: 25 to 50 MB.

On-premises agent endpoint requirements

The agent must be able to access the following endpoints associated with the region where your On Demand organization resides.

•
Australia:
•
Agent updates: odjrsauprodauiotinst--odjrsauprodauiotacct.b.nlu.dl.adu.microsoft.com
•
HTTP - TCP 80
•
Agent connection to On Demand: odjrs-auprod-au-iothub.azure-devices.net
•
MQTT over WebSockets - TCP 443
•
Agent and package download: https://odjrsauprodaugrssto.blob.core.windows.net
•
HTTPS - TCP 443
•
Agent data upload: https://odjrsauprodausto.blob.core.windows.net
•
HTTPS - TCP 443
•
Canada:
•
Agent updates: odjrscaprodcaiotinst--odjrscaprodcaiotacct.b.nlu.dl.adu.microsoft.com
•
HTTP - TCP 80
•
Agent connection to On Demand: odjrs-caprod-ca-iothub.azure-devices.net
•
MQTT over WebSockets (TCP 443)
•
Agent and package download: https://odjrscaprodcagrssto.blob.core.windows.net
•
HTTPS - TCP 443
•
Agent data upload: https://odjrscaprodcasto.blob.core.windows.net
•
HTTPS - TCP 443
•
Europe:
•
Agent updates: odjrseuprodeuiotinst--odjrseuprodeuiotacct.b.nlu.dl.adu.microsoft.com
•
HTTP - TCP 80
•
Agent connection to On Demand: odjrs-euprod-eu-iothub.azure-devices.net
•
MQTT over WebSockets (TCP 443)
•
Agent and package download: https://odjrseuprodeugrssto.blob.core.windows.net
•
HTTPS - TCP 443
•
Agent data upload: https://odjrseuprodeusto.blob.core.windows.net
•
HTTPS - TCP 443

 

•
UK:
•
Agent updates: odjrsukprodukiotinst--odjrsukprodukiotacct.b.nlu.dl.adu.microsoft.com
•
HTTP - TCP 80
•
Agent connection to On Demand: odjrs-ukprod-uk-iothub.azure-devices.net
•
MQTT over WebSockets (TCP 443)
•
Agent and package download: https://odjrsukprodukgrssto.blob.core.windows.net
•
HTTPS - TCP 443
•
Agent data upload: https://odjrsukproduksto.blob.core.windows.net
•
HTTPS - TCP 443
•
US:
•
Agent updates: odjrsusprodusiotinst--odjrsusprodusiotacct.b.nlu.dl.adu.microsoft.com
•
HTTP - TCP 80
•
Agent connection to On Demand: odjrs-usprod-us-iothub.azure-devices.net
•
MQTT over WebSockets (TCP 443)
•
Agent and package download: https://odjrsusprodusgrssto.blob.core.windows.net
•
HTTPS - TCP 443
•
Agent data uploads: https://odjrsusprodussto.blob.core.windows.net
•
HTTPS - TCP 443
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating