Install OneAgent on AIX

Latest Dynatrace
How-to guide
7-min read

Follow this guide to download and install Dynatrace OneAgent on AIX.

To get started, log in to your Dynatrace SaaS environment at Dynatrace.com using the credentials provided during signup. Then follow the installation steps.

Requirements

Permissions

You need Download/install OneAgent permissions to download and install OneAgent.
You need administrator rights for the servers where OneAgent will be installed as well as for changing firewall settings (necessary only if your internal routing policy may prevent Dynatrace software from reaching the internet).
You need permissions and credentials to restart all your application services.

Resources

Check the disk space requirements.
Your host requires 200 MB free memory to run OneAgent installation and update.
All hosts you want to monitor must be able to send data to the Dynatrace cluster. Depending on your Dynatrace deployment and on your network layout and security settings, you may choose to either provide direct access to the Dynatrace cluster or set up an ActiveGate.

Limitations

OneAgent installation isn't supported on networked storage mount points that are managed by standards such as NFS or iSCSI.
The support for Log management and Analytics on AIX hosts may differ from other operating systems. For details, see Log content autodiscovery.

Allow connections through firewall

Ensure that your firewall settings allow communication to Dynatrace.
Depending on your firewall policy, you may need to explicitly allow certain outgoing connections. The remote Dynatrace addresses to add to the allow list are given on the installation page for OneAgent.

Installation

Go to Discovery & Coverage and select Install > Install OneAgent.
Enter or select the following parameters.
- OS type
  
  Choose AIX as your operating system.
- Architecture
  
  This field is applicable only to Linux installations.
- Monitoring mode
  
  Options are Full-Stack, Infrastructure, or Discovery.
  
  If you are using a free Dynatrace trial, select Full-Stack to see everything that Dynatrace is capable of observing. You can always change the monitoring mode after installation. For details, see OneAgent monitoring modes.
- Optional parameters
  - Add a custom host name for easier identification.
  - Set a network zone for this host.
  - If your environment is segmented (for example, into development and production), consider organizing your hosts into host groups.
  - Apply tags to the host to organize your monitored environments in a meaningful way.
  - Add host properties to automate the addition of metadata to your hosts.
  OneAgent command-line installer provides more options to customize your installation.
Paste an access token with the Download OneAgent and ActiveGate installers (InstallerDownload) scope into Installer download token, or select Generate token to create one now and automatically paste it. This token is required to download the OneAgent installer from your environment. The token is automatically appended to the download and installation commands you'll use later.
Download OneAgent

Paste the provided command into your terminal window and run it.
Verify signature

After the download is complete, select Copy in the Verify signature box to copy the wget command to the clipboard, then paste the provided command into your terminal window and run it. Make sure your system is up to date, especially SSL and related certificate libraries.
Run the installer

Paste the command into your terminal and run it.
- You need root privileges. You'll need to make the script executable before you can run it as root.
- You can use su or sudo to run the installation script. To do this, type the following command into the directory where you downloaded the installation script.
  sudo /bin/sh Dynatrace-OneAgent-AIX-1.0.0.sh
For a summary of the changes made to your system by OneAgent installation, see OneAgent security on AIX.
Install OneAgent as the privileged user

Depending on your environment, you can choose whether OneAgent is installed using a privileged user.
Show deployment status

Displays the recently connected hosts.

Deep-code monitoring

On AIX, Dynatrace supports deep-code monitoring for Java, Apache, WebLogic, and WebSphere applications.

Automated injection of deep-code monitoring is enabled by default in Dynatrace.

You can control deep-code monitoring after you install OneAgent and it successfully connects to Dynatrace. On the Infrastructure & Operations Infrastructure & Operations, find your host, go to Host settings > Monitoring, and toggle Allow AIX kernel extension.

Installation on Virtual I/O Server (VIOS)

Use the generic installation steps to download the OneAgent, and then, after you have the OneAgent installer on your VIOS machine, issue the following commands.

Initiate the OEM installation and set up environment.
```
oem_setup_env
```
Sign in to the system group.
```
newgrp system
```
Install OneAgent.
- The --set-monitoring-mode=infra-only parameter enables Infrastructure Monitoring.
- The --set-auto-injection-enabled=false parameter disables automatic injection into processes.
```
/bin/sh Dynatrace-OneAgent.sh --set-monitoring-mode=infra-only --set-auto-injection-enabled=false
```
Return to the Virtual I/O Server prompt.
```
exit
```

Manual OneAgent injection

If you can't use the unified monitoring approach, you can inject OneAgent manually.

Processes that have been given special privileges using AIX's Role-Based Access Control (RBAC) system can't be auto-injected. This is a safety mechanism of the operating system to restrict unknown code from being run with elevated privileges. For example, an Apache or IHS web server might have been given the PV_NET_PORT privilege to allow starting the server as a non-root user but still letting it bind into restricted ports like port 80. In this case, any libraries configured for preloading, including OneAgent, will be silently ignored. In such cases, only manual OneAgent injection will work.

Manual OneAgent injection

Prepend your application command with the following commands:

export DT_HOME=/opt/dynatrace/oneagent
export LDR_PRELOAD64=$DT_HOME/agent/lib64/liboneagentproc.so
export LDR_PRELOAD=$DT_HOME/agent/lib/liboneagentproc.so

The DT_HOME variable must point to your OneAgent installation folder. If you customized your OneAgent installation directory, adjust DT_HOME variable accordingly. You can omit either the 32-bit or 64-bit entry, depending on your environment.

You've arrived!

Great, the setup is complete! You can now take a look around your new monitoring environment.

You can access your monitoring environment anytime by going to Dynatrace website and selecting Login in the upper-right corner.

One last thing: to monitor your processes, you need to restart them. You can restart your processes at any time, even during your organization's next planned maintenance period. For details, see Infrastructure & Operations and Processes.