Checking the agent prerequisites on UNIX

Before you install the agent, make sure that all the necessary prerequisites are met. See the following sections for supported operating systems and platform architectures and other necessary prerequisites:

Supported operating systems and platform architectures

The following table shows the operating systems, versions, and architectures that are supported by the Instana agent on UNIX. For more information about supported operating systems and compute platforms, see Policies.

OS Version Architecture Bitness
AIX [1] 7.x PowerPC 32-bit
AIX [1] 7.x PowerPC 64-bit
Solaris[2] 10+ SPARC 32-bit
Solaris 10+ SPARC 64-bit
  1. Monitoring is supported on Virtual I/O Server (VIOS) that runs on AIX. Before you install the agent, you must set up the original equipment manufacturer (OEM) environment. To initiate the OEM setup and installation environment, run the oem_setup_env command. ↩︎ ↩︎

  2. Java runtimes for Solaris 10 on SPARC 32-bit are no longer publicly available for download. To run the Instana agent on this platform, provide an existing Java 8 runtime. ↩︎

Disk space requirements

Make sure that sufficient disk space is available on the host before you install the Instana agent. The required disk space depends on the agent type and whether you deploy a Java SDK in the same directory.

Static agent: Requires approximately 1 GB of disk space. If you install the Java SDK in the same directory, allocate additional disk space for the Java SDK.

Dynamic agent: Starts with a smaller disk footprint than the static agent. Disk usage increases over time as the agent downloads sensors and stores runtime data.

Prerequisites

AIX 64-bit

You can download an RPM package for AIX 64-bit, which installs a self-contained Instana agent on the AIX host. If you want to provide an existing Java Software Development Kit (Java SDK), review the prerequisites for AIX 32-bit in the next section.

AIX 32-bit

For AIX 32-bit, the Instana host agent requires a Java Software Development Kit (Java SDK) installed on the host. You can set up the Java SDK for the host agent in two ways:

  1. Place or link the Java SDK into the *instanaAgentDir*/jvm folder so that the location *instanaAgentDir*/jvm/bin/java is created.
  2. Export an environment variable called JAVA_HOME to point to the Java SDK. You can also set this environment variable by adding it to the *instanaAgentDir*/bin/setenv file.
Important: Ensure that the Java virtual machine (JVM) can be used by any user on the system. 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.

Solaris

For Solaris, the Instana host agent requires a Java Software Development Kit (Java SDK) installed on the host. You can set up the Java SDK for the host agent in two ways:

  1. Place or link the Java SDK into the *instanaAgentDir*/jvm folder so that the location *instanaAgentDir*/jvm/bin/java is created.
  2. Export an environment variable called JAVA_HOME to point to the Java SDK. You can also set this environment variable by adding it to the *instanaAgentDir*/bin/setenv file.
The Instana agent supports the following Java SDKs:
  • Solaris 11 on 64-bit SPARC: Oracle Hotspot JDK 11.
  • Solaris 10 on 64-bit SPARC and Intel x64: Oracle Hotspot JDK 8.
  • Solaris 32-bit: Java runtimes for Solaris SPARC 32-bit are no longer publicly available for download. To run the Instana agent on this platform, provide an existing Java 8 runtime.
Important: Ensure that the Java virtual machine (JVM) can be used by any user on the system. 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.