Install OneAgent on Solaris

To install OneAgent, if you are a SaaS customer, go to and Login using the username and password you received from Dynatrace in your signup confirmation email. If you are a Dynatrace Managed customer, access the Cluster Management Console and choose the environment you want to monitor. Then continue with the installation steps provided below.



  • 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 for restarting all your application services.


  • Check the disk space requirements.
  • All hosts that are to be monitored need to be able to send data to the Dynatrace cluster. Depending on whether your Dynatrace deployment is on SaaS, or on Managed environment, and on your network layout and security settings, you may choose to either provide a direct access to Dynatrace cluster, or to set up an ActiveGate.


  • OneAgent installation isn't supported on networked storage mount points that are managed by standards such as NFS or iSCSI.
  • Infrastructure Monitoring mode isn't supported on Solaris hosts.


Select Deploy Dynatrace from the navigation menu.

Click the Start installation button and select Solaris.

Choose the CPU architecture of your environment.

Provide a PaaS token. This token is required to download the OneAgent installer from your environment. If you don't have a PaaS token, you can generate one right in the UI. The token is automatically appended to the download command you'll use later.

Click Copy to copy the wget command.

Log into your Solaris host and execute the wget command.


  • The wget command isn't installed on Solaris by default. Either install it or use an alternative means of downloading OneAgent.

Create a folder on your local system for OneAgent (for example, /opt/dynatrace/oneagent) and unzip the zip-archive into the folder.

In contrast to other platforms, root access isn't required for installation of OneAgent on Solaris. 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.

On Solaris, Dynatrace only supports Java and Apache HTTP Server applications and as such you need to decide which applications to monitor. You can do this just for a single application, or shell wide. Just follow the relative instructions below.

OneAgent versions older than v1.137 and fallback

If your OneAgent is older than v1.137, or if you have problems with the unified monitoring approach, you can inject OneAgent manually.

You've arrived!

Great, setup is complete! You can now take a look around your new monitoring environment. If you are a SaaS customer, you can access your monitoring environment anytime by going to Dynatrace website and clicking the Login button in the upper-right corner. If you are a Dynatrace Managed customer, you can access your monitoring environment through the Cluster Management Console.


One last thing: to monitor your processes, you need to restart them. At any time, you can check which processes aren't monitored and need to be restarted. Just select Deployment status from the navigation menu, click the All hosts or Recently connected hosts tab, and expand the host you are interested in.