Document Details
Self Hosted Integration Runtime Troubleshoot Guide
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a strong Windows bias throughout. All troubleshooting steps, examples, and tool references are exclusively for Windows environments. Windows-specific tools (Event Viewer, MMC, Regedit, certutil, Process Monitor, Netmon), file paths, registry edits, and PowerShell commands are used without mention of Linux equivalents. There are no Linux-specific instructions, examples, or troubleshooting guidance, despite the potential for running self-hosted integration runtime on Linux (e.g., via Docker or Mono). Even generic troubleshooting (network, certificates, permissions) is always described using Windows paradigms.
Recommendations:
- Add parallel Linux instructions and examples for all troubleshooting steps, including log collection, certificate management, service management, and environment variables.
- Include Linux equivalents for all Windows tools mentioned (e.g., use 'journalctl' or 'systemd' logs instead of Event Viewer, 'openssl' for certificate checks, 'strace' or 'lsof' for process monitoring, 'tcpdump' or 'wireshark' for network tracing).
- Provide Linux file paths and environment variable instructions alongside Windows paths.
- When referencing commands (e.g., PowerShell, certutil, regedit), also provide bash/shell alternatives for Linux.
- Explicitly state OS-specific limitations or requirements (e.g., if some features/tools are Windows-only, clarify this and suggest workarounds or alternatives for Linux).
- Reorganize sections to present Windows and Linux instructions side-by-side or in clearly labeled tabs, rather than only Windows.
- Where only Windows is supported, clearly state this at the top of the documentation.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-09-08 00:00 | #105 | completed | ✅ Clean |
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ✅ Clean |
| 2025-07-09 13:09 | #3 | cancelled | ✅ Clean |
| 2025-07-08 04:23 | #2 | cancelled | ❌ Biased |
Flagged Code Snippets
Certutil -verify -urlfetch <certificate path> > <output txt file path>
Certutil -verify -urlfetch c:\users\test\desktop\servercert02.cer > c:\users\test\desktop\Certinfo.txt
Certutil -URL <certificate path>
certutil -importpfx FILENAME.pfx AT_KEYEXCHANGE
(New-Object System.Net.WebClient).DownloadString("https://wu2.frontend.clouddatahub.net/")
$user = $env:username
$webproxy = (get-itemproperty 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet
Settings').ProxyServer
$pwd = Read-Host "Password?" -assecurestring
$proxy = new-object System.Net.WebProxy
$proxy.Address = $webproxy
$account = new-object System.Net.NetworkCredential($user,[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($pwd)), "")
$proxy.credentials = $account
$url = "https://wu2.frontend.clouddatahub.net/"
$wc = new-object system.net.WebClient
$wc.proxy = $proxy
$webpage = $wc.DownloadData($url)
$string = [System.Text.Encoding]::ASCII.GetString($webpage)
$string
System.ServiceModel.EndpointNotFoundException: Could not connect to net.tcp://xxxxxxx.bwld.com:8060/ExternalService.svc/WorkerManager. The connection attempt lasted for a time span of 00:00:00.9940994. TCP error code 10061: No connection could be made because the target machine actively refused it 10.2.4.10:8060.
System.Net.Sockets.SocketException: No connection could be made because the target machine actively refused it.
10.2.4.10:8060
at System.Net.Sockets.Socket.DoConnect(EndPoint endPointSnapshot, SocketAddress socketAddress)
at System.Net.Sockets.Socket.Connect(EndPoint remoteEP)
at System.ServiceModel.Channels.SocketConnectionInitiator.Connect(Uri uri, TimeSpan timeout)
Error log: Cannot connect to worker manager: net.tcp://xxxxxx:8060/ExternalService.svc/ No DNS entries exist for host azranlcir01r1. No such host is known Exception detail: System.ServiceModel.EndpointNotFoundException: No DNS entries exist for host xxxxx. ---> System.Net.Sockets.SocketException: No such host is known at System.Net.Dns.GetAddrInfo(String name) at System.Net.Dns.InternalGetHostByName(String hostName, Boolean includeIPv6) at System.Net.Dns.GetHostEntry(String hostNameOrAddress) at System.ServiceModel.Channels.DnsCache.Resolve(Uri uri) --- End of inner exception stack trace --- Server stack trace: at System.ServiceModel.Channels.DnsCache.Resolve(Uri uri)