Checking the agent prerequisites on Windows
See the following sections to check for the prerequisites and supported versions of operating systems and Java SDKs to install the Instana agent on Windows.
Prerequisites
Before you install the agent, ensure that the following prerequisites are met:
- .NET Framework 4.5 is installed.
- A JVM is installed. For more information, see the Supported Java SDKs section.
- The Instana host agent is run with administrator privileges to avoid problems with getting monitoring data.
If you choose to install the host agent by using a Windows installer, the installer automatically installs all the prerequisites (.NET Framework 4.5 and a JVM).
Supported operating systems and platform architectures
The following operating systems and platform architectures support Instana:
- Windows Server 2022
- Windows Server 2019
- Windows Server 2016
- Windows Server 2012 R2
- Windows Server 2012 [1]
- Windows 11
- Windows 10
- Windows 8.1
- Windows 8 [1:1]
These operating systems are supported on the x64 or amd64 platform architecture.
Supported Java SDKs
The host agent requires a Java 8 or Java 11 runtime. You are suggested to use a Java SDK from the same vendor as the monitored Java Virtual Machines (JVM) on the same host.
The following Java SDKs support the Instana host agent:
- IBM Semeru Runtime™ JDK/J9 11 (preferred) [2]
- Azul Zulu JDK 11 [2:1]
- OpenJDK JDK 11
- AdoptOpenJDK
- Oracle Hotspot JDK 11
- Amazon Corretto JDK 11
- IBM J9 11
Ensure that the JVM can be used by any user on the system. You are suggested to use the latest available patch release of the Java distribution of your choice. The host agent requires a Java SDK that supports TLSv1.3 (available in all current
Java SDK 8 and Java SDK 11 builds). If you use a Java SDK package that does not support strong encryption, you might get errors such as java.lang.RuntimeException: Could not generate DH key pair
.
Installing the Java SDK
To start the host agent, your Windows host computer must have a supported Java SDK. Use one of the following options to install the Java SDK:
- After you install the host agent, place the Java SDK in the
<instana-agent-install-dir>/jvm
directory directly, and verify that the<instana-agent-install-dir>/jvm/bin/java.exe
file exists. - Install the Java SDK in a directory of your choice, and set its path to the environment variable
JAVA_HOME
. After you install the host agent, you can also set theJAVA_HOME
environment variable by using theinstana-agent-install-dir>/bin/setenv.bat
file.
-
Instana support coincides with Microsoft Lifecycle Policy. Instana provides official support for end-of-support (EOS) Windows versions only if an official Custom Support Agreement is available. ↩︎ ↩︎
-
These agent runtimes are available as options for Windows installer packages to install the host agent. ↩︎ ↩︎