Install OneAgent on Linux

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

Requirements

You need administrator rights for the servers where DESK OneAgent will be installed as well as for changing firewall settings (necessary only if your internal routing policy may prevent DESK software from reaching the Internet).
You need permissions and credentials for restarting all your application services.
You need to check also the disk space requirements.
The host on which you install OneAgent needs at least 300 MB RAM.
OneAgent installation isn't supported on networked storage mount points that are managed by standards such as NFS or iSCSI.
All hosts that are to be monitored need to be able to send data to the DESK cluster. Depending on whether your DESK 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 DESK cluster, or to set up an ActiveGate.

Installation

Select Deploy DESK from the navigation menu.

Click the Start installation button and select Linux.

Choose the installer type from the drop-down list. Use the Linux shell script installer on any Linux system that's supported by DESK, regardless of the packaging system your distribution depends on.

Copy the command provided in the Use this command on the target host text field. Paste the command into your terminal window and execute it.

Once the download is complete, you can verify the signature by copying the command from the Verify signature text field, then pasting the command into your terminal window and executing it. Make sure your system is up to date, especially SSL and related certificate libraries.

Copy the command that's provided in the And run the installer with root rights text field.

If your environment is segmented, for example into development and production, consider organizing your hosts into host groups.

Paste the command into your terminal window and execute it. Note that you’ll need root access. You’ll need to make the script executable before you can run it. You can use su or sudo to run the installation script. To do this, type one of the following commands into the directory where you downloaded the installation script.

If you’re on an Ubuntu Server

sudo /bin/sh DESK-Agent-Linux-1.0.0.sh

If you’re using Red Hat Enterprise Linux

su -c '/bin/sh DESK-Agent-Linux-1.0.0.sh'

If you start a root session

/bin/sh DESK-Agent-Linux-1.0.0.sh

If you install OneAgent in non-privileged mode

DESK OneAgent v1.141 and above can be installed in non-privileged mode. This is the only time you need to grant elevated privileges to DESK OneAgent. Elevated privileges are dropped as soon as DESK OneAgent is deployed. To install DESK OneAgent in non-privileged mode, you need to manually append the NON_ROOT_MODE=1 parameter to the installation command. For example:
sudo /bin/sh DESK-Agent-Linux-1.0.0.sh NON_ROOT_MODE=1
Note that non-privileged mode requires Linux System Capabilities available in the versions:

v2.6.26 and above for DESK OneAgent installation without root privileges.
v4.3 and above (recommended systemd ≥ 221) for DESK OneAgent automatic updates and full operation without root privileges.

OneAgent won't work in non-privileged mode if installed on a filesystem mounted as noexec or nosuid.

Notes:

If you plan to download DESK OneAgent directly to a server, note that outdated or missing libraries (for example, CA certificates or OpenSSL) prevent the installer from downloading.
DESK uses encrypted connections. OpenSSL is required to enable wget to access the server. You can also download the installer by clicking the Download OneAgent installer link in the page footer and saving the installer script to any location you want, which bypasses the wget command altogether.

What happens during installation?

DESK OneAgent is a set of specialized services that have been configured specifically for your monitoring environment. The role of these services is to monitor various aspects of your hosts, including hardware, operating system, and application processes.

During the installation process, the installer:

Installs executable code and libraries that are used by DESK OneAgent. OneAgent binaries are installed in the /opt/desk/oneagent directory and startup scripts are created in /etc/init.d (on systemd systems, startup scripts are created in /etc/systemd/system/). One of the Linux OneAgent components, liboneagentproc.so, is located in the system library directory (/lib or /lib64 depending on your architecture) and is enabled at /etc/ld.so.preload.
Note:
For OneAgent versions 102 and earlier, Linux OneAgent binaries are installed at /opt/ruxit/agent/ and the specified Linux OneAgent component is called libruxitagentproc.so.
Creates its own user (dtuser). This user is created without a password. It's not possible to login with this user. For security purposes, services that don’t require root privileges will run under this user. Installation, however, still requires root access.
Checks the system’s global proxy settings.
Checks for a connection to DESK Server or ActiveGate (if you installed ActiveGate and downloaded the OneAgent installer after ActiveGate was connected to DESK).
Detects all SELinux-aware applications and adjusts the SELinux security policy accordingly.
Allows DESK OneAgent to inject its own libraries into monitored processes.
Modifies the core pattern configuration so that OneAgent can detect and report process crashes. The original core_pattern configuration will still work following installation and be preserved in /opt/desk/oneagent/agent/.original_core_pattern. To define your own core settings, you can modify the core_pattern configuration at /opt/desk/oneagent/agent/.original_core_pattern, using the same format as specified in Linux Programmer's Manual.

For a summarized view of the changes made in your system's files by OneAgent installation, please visit Changes on Linux files page.

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 DESK website and clicking the Login button in the upper-right corner. If you are a Managed customer, you can access your monitoring environment through the Cluster Management Console.

home dashboard

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.