How do I install Dynatrace OneAgent on AIX?

Note: Dynatrace AIX support is currently in Beta. While Dynatrace AIX support has been fully tested, at this time it should be used with caution within critical production environments.

Dynatrace supports IBM AIX for Java (specifically IBM JVM and WebSphere) and IBM HTTP Server (Apache HTTP server).

If your infrastructure is based on these technologies you can use Dynatrace OneAgent to effectively monitor your hosts, services, and user experience.

If a proxy is required to connect to Dynatrace Server, we recommend that you install Security Gateway and have Dynatrace OneAgent use Security Gateway for this purpose. For full details, see How do I configure Security Gateway?

Install Dynatrace OneAgent

Select Deploy Dynatrace from the navigation menu.

Click Start Installation.

Click the AIX button.

Click Generate new token and type in a name to create a token that you'll need to access the download. You can disable access to this download later by disabling or deleting the token.

Click Generate. You can see the list of tokens that you have created, so ensure that the token you create is unique (see image below).

Click Use this token if you want to use an existing token.

Click Copy to copy the wget command.

Log into your AIX host and execute the command.


  • The wget command is not installed on AIX per default. Either install it or use alternative means for downloading OneAgent.
  • In case you get an error when downloading OneAgent, install the required certificate by downloading the root CA file from Comodo and then concatenating the content of the CRT file to /var/ssl/cert.pem. You can alternatively skip the certificate check by adding the parameter --no-check-certificate.

Create a folder on your local system for OneAgent (for example, /opt/dynatrace/oneagent).

Unzip the ZIP archive into the folder.

In contrast to other platforms, root access is not required for the installation of OneAgent on AIX. OneAgent can be installed in any directory.

  • As all monitored applications need to be able to read the library, ensure that the permissions allow this.
  • Be sure to reference the folder correctly in the subsequent steps of your deployment.

Open the manifest.json file. It contains <tenantUUID>, <tenantToken>, and <communicationEndpoints>, which you will need to configure your environment.

Instrument Dynatrace appropriately based on your infrastructure.