How to Install and Uninstall UEMS Linux Agent

Overview

This guide provides detailed instructions for installing and uninstalling UEMS Linux agents, including manual and remote installation methods, prerequisites, system requirements, and agent privileges.

Pre-requisites

  • Linux Agent Configuration: Ensure the Linux agent settings are configured know more.
  • Privileges Agent installation requires sudo/root permission. After installation, the agent runs with root privileges, except for UI tasks, which run as a normal user.
  • Service Compatibility The Linux machine should run under SystemD or SysVinit service, as the agent service is compatible only with these services.
  • Supported architectures include x86, x86_64, ARM (32-bit and 64-bit). Please make sure that the 64bit machines should support the 32bit binary execution.
  • Required Packages:
    • tar package, version 1.29 or above.
    • xz or xz-utils, depending on the type of Linux OS.
    • libgtk-3-0 or gtk3.x86_64
    • libwebkit2gtk-4_0-37 or webkitgtk4-plugin-proces-gtk2.x86_64 or webkitgtk4 or webkit2gtk depending on the type of Linux OS.

Manual Linux Agent Installation

Linux agents can be installed manually on computers that need to be managed. The agents should be downloaded onto the target Linux computer before initiating the installation process.

      1. Navigate to Agent-->Computers Click Download Agent. dwg trueviewer
      2. Select Platform as linux,Select domain/workgorup from the dropdown.
      3. Choose Processor INTEL/AMD or ARM.

        Note: If you choose the ARM processor, the downloaded files will be named (remoteoffice_name)_UEMS_LinuxAgent_ARM.zip and UEMS_LinuxAgent_ARM.bin.

        dwg trueviewer
      4. Copy the Agent to the Target Computer:

        Use scp to copy the downloaded agent to the remote computer where the agent needs to be installed.

          Copy the Agent to the Target Computer

            
          • scp (remoteoffice_name)_UEMSLinuxAgent.zip username@hostname:
          • < Path_To_Storage_Directory_If_Needed >
          copied
          copy-icon-1
        • username: Root username of the target computer.
        • hostname: Local hostname of the target computer.
        • If no path is specified, the agent will be copied to /home/username on the target computer.
      5. Install the Agent on the Target Computer:
        • Open the terminal and log into the target computer: ssh username@hostname
        • Log in as the root user. If not logged in as root, use the sudo command and enter the password when prompted to perform each operation.
      6. Navigate to Downloaded Agent Location:
        • Go to the directory where the agent has been downloaded.
      7. Unzip the UEMS Agent:
        • Unzip the (remoteoffice_name)_UEMSLinuxAgent.zip file using the command:
        • Command to Unzip the UEMS Agent

            
          • unzip -e (remoteoffice_name)_UEMSLinuxAgent.zip
          copied
          copy-icon-1
      8. Verify Files:
        • Confirm that both UEMS_LinuxAgent.bin and serverinfo.json are in the same directory.
      9. Set Executable Permissions:
        • As a root user, make UEMS_LinuxAgent.bin executable with the following command:
        • Command to Set Executable Permissions

            
          • chmod +x UEMS_LinuxAgent.bin
          copied
          copy-icon-1
      10. Run the Installer:
        • Execute the installation command as follows:
        • Command to Run the Installer

            
          • ./UEMS_LinuxAgent.bin
          copied
          copy-icon-1
        • By default, the agent will be installed in the /usr/local/manageengine/uems_agent/ directory.
        • To install the agent in a different folder, use the -d argument with the installer and enter your preferred path
           eg:  ./UEMS_LinuxAgent.bin -d /opt
          Now agent will install on /opt/manageengine/uems_agent/ path

Installing Linux Agents Remotely from the Web Console

For computers within the LAN, agents can be installed by selecting the desired computers and invoking agent installation through the web console:

      1. Configure Credentials in Linux Agent Settings
        1. Go to Linux Agent Settings under Agent Settings on the Agent tab.
        2. Click Add Credentials to add a new credential.
        3. Enter Credential Name, Type, Domain, Username, and Password, then click Save.
        4. Select the credentials and click Save Changes. dwg trueviewer
        Note:
        • These credentials will be used for SSH access to the Linux machine to perform the agent installation. Ensure that the credentials have SSH access and sudo permissions for installation. They are not used by the agent for any other purpose.
        • If you Facing trouble in SSH access click here.
        • For invoking the installation on client computers, the SSH port (default port 22) should be open on the computers where the agent needs to be installed. The SSH port is used only for agent installation purposes and not for agent-server communication.
      2. Add the Computer to the Scope of Management (SoM)
        1. Navigate to Agent > Computers and click the +Add Computer(s) button to open the Add Computer popup. dwg trueviewer
        2. If you’ve added a domain:
          • Choose your domain from the dropdown.
          • Select the computer(s) you want to add and click Next. dwg trueviewer
        3. The selected computer(s) will now list in the next screen. Here, you can:
          • Choose the Remote Office from the dropdown.
          • Click Install Agents to start installation immediately, or click Add to SoM to add the computer(s) to the Computers page for later installation. dwg trueviewer
        4. Alternatively:
          • Click the computer icon in the upper-right corner. dwg trueviewer
          • Enter the name(s) of the computer(s) to add, separated by commas if adding multiple (e.g., computer1, computer2).
          • Press Enter to add the computer(s).
          • The selected computer(s) will display in the list. Choose the Remote Office and click Install Agents for immediate installation, or Add to SoM for later installation. dwg trueviewer
      3. Initiate Agent Installation
        • Click the Instal Agent Icon in left corner.
        • Now Agent Installation will initiated

Installing Linux Agents Using Distribution Server or AWS

To install Linux agents using a Distribution Server or AWS, follow the steps mentioned on the designated installation page.

Installing Linux Agents Using Linux OS Imaging

To install Linux agents usingLinux OS Imaging, follow the steps mentioned on the designated installation page.

How to Uninstall Linux Agent

Manual Uninstallation

      1. Navigate to the Agent Installation Directory: cd /usr/local/manageengine/uems_agent/
      2. Set Executable Permissions: chmod +x RemoveUEMSAgent.sh
      3. Run the Removal Script: ./RemoveUEMSAgent.sh
      4. OTP Prompt: (if Agent Protection Settings enabled) you will be prompted to choose between GUI or CLI for input and provide the OTP Learn more about Agent Portection Settings.
      5. Agent will be uninstalled.

SOM Uninstallation

      1. Remove from SOM: Removing the computer from SOM will trigger the agent uninstallation on its next refresh cycle or immediately if the NS is live and marked as "green". dwg trueviewer
      2. Uninstall via Server Trigger: Selecting "Uninstall Agent" from the server will initiate an SSH-triggered uninstallation. This is applicable for On-Premises (local & DS) as well as Cloud DS deployments. This option is not available for MSP. dwg trueviewer

Conclusion

This guide provided the necessary steps to install, configure, and uninstall UEMS Linux agents on supported systems using manual, remote, and distribution-based methods. Follow the outlined instructions for seamless agent management on Linux systems.

    1. Managing Linux Computers