Installing the Host Agent on Unix
A Java 8 Development Kit (JDK 8) needs to be available for the agent. There are two options:
- The easiest is to place or link that JDK into
- The customizable way is to export an environment variable called JAVA_HOME to point to that JDK (this environment variable can be also set via
At the moment, the following JVMs are supported for running the agent:
- Azul Zulu JDK 8 (Preferred)
- Oracle Hotspot JDK 8
- IBM J9 8
- OpenJDK 8
- AdoptOpenJDK 8
- Amazon Corretto JDK 8
It is important that the JVM is executable for any user on the system. We recommend using the latest available patch release of the Java distribution of your choice. Be advised that depending on your OS distribution, the packages provided by the OS distributor might not contain strong encryption support due to export control. Using such a package will result in errors like
java.lang.RuntimeException: Could not generate DH key pair.
- Sign in to Instana, click More -> Agents -> Instana agent installation -> Unix.
Select the archive matching your system architecture and then click Download:
- AIX (32bit - PowerPC)
- AIX (64bit - PowerPC)
- Solaris (32bit - SPARC)
- Solaris (64bit - SPARC)
Your agent key and location are pre-populated, so you just have to extract and start the agent.
We have seen several cases, especially Solaris, of customer using pre-POSIX
tar utilities that are not capable of handling filenames longer than 100 characters.
We advise the use of GNU
tar for uncompressing the host agent tarball.