Skip to main content

Red Hat Enterprise Linux (RHEL)

To get started with the UXM Endpoint agent on RHEL, please make sure you meet the prerequisites below.

Prerequisites​

OS requirements​

To install UXM Endpoint agent, you need the 64-bit version of one of these RHEL versions:

  • RHEL 7
  • RHEL 8
  • RHEL 9

UXM Endpoint agent is compatible withx86_64(oramd64) architectures.

Installation methods​

You can install the UXM Endpoint agent in different ways, depending on your needs:

  • From repository: Set up and install UXM Endpoint agent from UXM's yumrepository. This is the recommended approach.
  • Manually download: Download the RPM package and install it manually and manage upgrades manually. This is useful in situations such as installing UXM Endpoint Agent on air-gapped systems with no access to the internet.

Install using the repository​

Before you install UXM Endpoint agent for the first time on a new host machine, you need to set up the UXM repository. Afterward, you can install and update UXM from the repository.

Set up the repository​

  1. Install the yum-utils package (which provides the yum-config-manager utility) and set up the repository:
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.uxmapp.com/linux/rhel/uxm-endpoint-agent.repo

Install UXM Endpoint Agent​

  1. Install UXM Endpoint agent.

To install the latest version, run:

sudo yum -y makecache
sudo yum install uxm-endpoint-agent

Update collector url that agent sends data to and agent key required to send the data.

UXM_COLLECTOR=https://customername.uxmapp.com
UXM_AGENT_KEY=${AgentKey}
sudo sed -i "s^{COLLECTOR}^$UXM_COLLECTOR^g" /opt/uxm-endpoint-agent/pcagent.config
sudo sed -i "s^{AGENT_KEY}^$UXM_AGENT_KEY^g" /opt/uxm-endpoint-agent/pcagent.config

Restart UXM Agent service

sudo systemctl restart uxm-endpoint-agent

Verify that the UXM Endpoint agent installation is successful by checking the log file or UXM after 5 minutes:

tail -n 50 -f /var/log/uxm-endpoint-agent.log | grep -E 'Error|error|Warn|warn'

You have now successfully installed and started UXM Endpoint agent.

Install manually from a package​

If you can’t use UXM's yum repository, you can download the rpm file for your release and install it manually. You need to download a new file each time you want to upgrade the UXM Endpoint Agent.

  1. Go to https://download.uxmapp.com/linux/rhel and choose your version of RHEL. Then browse to x86_64/stable/Packages/

  2. Download the .rpm file for the UXM Endpoint agent version you want to install:

    • uxm-endpoint-agent_<version>_<arch>.rpm

  3. Install the .rpm packages and set settings.
    Update the environments variables:

    • UXM_COLLECTOR needs to be set to UXM Collector that should receive the data
    • UXM_AGENT_KEY is the supplied key from UXM Admin page

    export UXM_COLLECTOR=https://customername.uxmapp.com
    export UXM_AGENT_KEY=AGENT_KEY_FROM_UXM
    sudo yum install `uxm-endpoint-agent_<version>_<arch>.rpm`
    sudo sed -i "s^{COLLECTOR}^$UXM_COLLECTOR^g" /opt/uxm-endpoint-agent/pcagent.config
    sudo sed -i "s^{AGENT_KEY}^$UXM_AGENT_KEY^g" /opt/uxm-endpoint-agent/pcagent.config
    sudo systemctl start uxm-endpoint-agent.service

Upgrade​

To upgrade UXM Endpoint agent, download the newer package file and repeat the installation procedure, using yum -y upgrade instead of yum -y install, and point to the new file.

Uninstall​

UXM Endpoint agent can be uninstalled with the following commands

sudo yum remove uxm-endpoint-agent

Delete yum source list

sudo yum-config-manager --disable uxm-endpoint-agent