Install UXM Endpoint agent on RHEL
To get started with the UXM Endpoint agent on Ubuntu, 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
yum
repository. 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
-
Install the
yum-utils
package (which provides theyum-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
-
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.
Upgrade
UXM Endpoint agent can be upgraded by apt upgrade if it's installed from repository:
...
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.
-
Go to https://download.uxmapp.com/linux/rhel/ and choose your version of RHEL. Then browse to
x86_64/stable/Packages/
-
Download the
.rpm
file for the UXM Endpoint agent version you want to install:-
uxm-endpoint-agent_<version>_<arch>.deb
-
- Install the
.deb
packages and set settings.
Update the environments variables:- UXM_AGENT needs to be set to downloaded deb file
- 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_AGENT=uxm-endpoint-agent_YYYY.MM.DD_amd64.rpm export UXM_COLLECTOR=https://customername.uxmapp.com export UXM_AGENT_KEY=AGENT_KEY_FROM_UXM curl https://download.uxmapp.com/linux/latest/$UXM_AGENT -o $UXM_AGENT sudo yum install $UXM_AGENT 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