How do I install Dynatrace OneAgent on Solaris?

Dynatrace supports Oracle Solaris (x86 and SPARC) for Java and 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.

Install Dynatrace OneAgent on Solaris

  1. Select Deploy Dynatrace from the navigation menu.

  2. Click Start Installation.

  3. Click the Solaris button.

  4. Choose the CPU architecture of your environment.

  5. Click Copy to copy the wget command.

  6. Log into your Solaris host and execute the wget command. Create a folder on your local system for OneAgent (for example, /opt/dynatrace/oneagent) and unzip the ZIP archive into the folder.
    Note: The wget command isn't installed on Solaris by default. Either install it or use an alternative means of downloading OneAgent.

  7. Switch to the installation folder and run . dynatrace-env.sh to set TENANT, TENANTTOKEN, and the CONNECTION_POINT to prepare your environment for OneAgent injection. To inject OneAgent directly into a Java process, call . dynatrace-java-env.sh 64. For 32-bit Java processes, omit the 64 parameter. This will implicitly call dynatrace-env.sh and extend your $JAVA_OPTS and $JAVA_OPTIONS environment variables. If your Java process makes use of those environment variables, there's nothing more to do, except start the Java process.

Note:
In contrast to other platforms, root access isn't required for installation of OneAgent on Solaris. OneAgent can be installed in any folder. However, as all monitored applications need to be able to read the library, ensure that the permissions allow this. Also, be sure to reference the folder correctly in the subsequent steps of your deployment.

Configure Dynatrace

To configure Dynatrace, check the instructions below based on your infrastructure.

Instrument generic Java applications (1.6 – 1.9)

The following steps are required to configure Dynatrace to monitor generic Java applications running on Solaris:

Modify the command line of your Java application by adding the following:
$JAVA_OPTS
For example:
java $JAVA_OPTS com.dynatrace.diagnostics.sample.SimpleLoadGenerator

Restart your Java process. The newly started Java process should show up in Dynatrace.

Instrument Apache HTTP Server

The following steps are required to configure Dynatrace to monitor an Apache web service running on Solaris:

Edit your httpd.conf and add the following line in a location of your choice:

LoadModule oneagent_module /opt/dynatrace/oneagent/agent/bin/solaris-<arch>-64/liboneagentloader.so

Alternatively, if you prefer to leave your httpd.conf unchanged, you can specify the same directives using the command line:

apachectl \

-c "LoadModule oneagent_module /opt/dynatrace/oneagent/agent/bin/solaris-<arch>-64/liboneagentloader.so"\

Perform a full restart of Apache. The newly started Apache process should show up in Dynatrace.

Update Dynatrace OneAgent on Solaris (x86 and SPARC)

To update an installed OneAgent instance on Solaris

  1. Select Deploy Dynatrace from the navigation menu.

  2. Click the Start installation button.

  3. Select your environment architecture (x86/64 or SPARC).

  4. Click Copy to copy the wget command to your clipboard.

  5. Log into your Solaris host and execute the wget command. Note: The wget command isn't installed on Solaris by default. You must either install it or use another means of downloading OneAgent.

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

  7. Unzip the ZIP archive into the folder.

  8. Stop the monitored processes.

  9. Rename the current OneAgent installation directory (for example, /opt/dynatrace/oneagent-131) using the following command: mv /opt/dynatrace/oneagent /opt/dynatrace/oneagent-131. This folder can be deleted following the OneAgent update.

  10. Rename the updated OneAgent folder to point to the original installation directory (for example, /opt/dynatrace/oneagent) using the following command: mv /opt/dynatrace/oneagent-update /opt/dynatrace/oneagent

  11. Restart all processes that are to be monitored.