You can uninstall Endpoint Security (HX) xAgent software individually on your endpoint hosts or using software management utilities, such as BigFix and SCCM (in Windows environments) or Casper (in macOS environments). Refer to the documentation provided for the utility.
If you enable a Removal Protection password policy for host sets in your environment, you must enter the removal password to authorize the agent uninstall process. See Configuring the Agent Removal Protection Password for more information on setting up an agent uninstall password.
Important
If you run the uninstall audit on a host set that has the Removal Protection policy enabled, the uninstall audit will fail. To successfully run the uninstall audit, disable the Removal Protection policy before running the uninstall audit.
This section describes how to uninstall the xAgent software on a single endpoint host and covers the following topics:
Uninstalling Password-Protected xAgent Software
If you need to uninstall a password protected Endpoint Security (HX) xAgent running on your Windows endpoints, you can use the Endpoint Security (HX) Windows Program Manager or the Windows Installer. Only authorized users can uninstall the xAgent software.
Note
Endpoint Security (HX) xAgent versions 26 or later support the Removal Protection Password for Windows endpoints only.
Important
Endpoint Security (HX) xAgent removal protection is disabled if Trend Micro AV is running.
This section covers the following topics:
Using Windows Program Manager to uninstall a password-protected xAgent
This section describes how to uninstall a password-protected agent from your Windows endpoint using the Windows Program Manager.
Important
A reboot is necessary after uninstalling Trellix Endpoint Security (HX) xAgent version 29.
Note
Artifacts that remain in the C:\Windows\FireEye folder after the agent software has been uninstalled will be deleted the next time the endpoint host is rebooted.
If a Windows xAgent uninstall attempt fails because the binary is missing or corrupt or because the
ProgramData/FireEyeor
Program Files/FireEyedirectories are missing or corrupt, reinstall the agent using command-line commands (
msiexec /x <agent software installation msi file> /qn UNINSTALL_PASSWORD=password) and then uninstall it.
In the Windows Control Panel, select Programs and Features. Depending on your version of Windows, you might have to select Programs before you can select Programs and Features.
Locate FireEye Endpoint Agent in the program list and right-click and select Uninstall.
Select Yes when prompted to confirm that you want to uninstall the agent software and to similar confirmation prompts.
When prompted, enter the uninstall password and click OK. If you are not authorized to remove the agent software from the Windows host or if you enter an incorrect password, the uninstall process will fail.
Using Command-Line to uninstall a password-protected xAgent
This section describes how to uninstall password-protection Endpoint Security (HX) xAgent software from your Windows endpoint using the command line.
To uninstall the Windows xAgent using the Command Line:
msiexec.exe /x <agent software installation msi file>|<product identifier #> UNINSTALL_PASSWORD=<password>
Open a command line prompt on your Windows host.
Use the
msiexec /xcommand to uninstall the password-protected xAgent software by specifying the name of the agent installation.msiexecutable file on the host endpoint and appendingthe /xcommand withUNINSTALL_PASSWORD=<password>.When prompted to confirm that you want to uninstall the xAgent software, select Yes.
Uninstalling a Password-Protected xAgent in Silent Mode
To uninstall the Windows xAgent in silent mode:
You can also use the command line to uninstall the xAgent software silently (without any user prompting) by inputting the password as a property to msiexec. If this property is missing or if the xAgent uninstall password is incorrect, the uninstall process will fail.
msiexec /x <agent software installation msi file> /qn UNINSTALL_PASSWORD=password
Open a command line prompt on your Windows host.
Use the
msiexec /xand /qn commands to uninstall the password-protected xAgent software in silent mode. Specify the name of the xAgent installation.msiexecutable file on the host endpoint and appendingthe /xcommand withUNINSTALL_PASSWORD=<password>.msiexec /x <agent software installation msi file>|<product identifier #>/qn UNINSTALL_PASSWORD=<password>
Uninstalling Undisguised Windows xAgent Software
This section describes how to uninstall undisguised Endpoint Security (HX) xAgent software running on your Windows endpoint.
To uninstall undisguised Windows xAgent software:
In the Windows Control Panel, select Programs and Features. Depending on your version of Windows, you might have to select Programs before you can select Programs and Features.
Right-click on the FireEye Endpoint Agent you want to uninstall and select Uninstall.
Select Yes when prompted to confirm that you want to uninstall the agent software and to similar confirmation prompts.
Important
A reboot is necessary after uninstalling Trellix Endpoint Security (HX) xAgent version 29.
Note
Artifacts that remain in the
C:\Windows\FireEyefolder after the xAgent software has been uninstalled will be deleted the next time the endpoint host is rebooted.If a Windows xAgent uninstall attempt fails because the binary is missing or corrupt or because the
ProgramData/FireEye
orProgram Files/FireEye
directories are missing or corrupt, reinstall the xAgent using command-line commands (msiexec /i xagt.msi /qn
) and then uninstall it.
Uninstalling disguised Windows xAgent software
This section describes how to uninstall disguised Endpoint Security (HX) xAgent software running on your Windows endpoint.
Locate the
.msiinstallation file for the xAgent software. This must be for the same xAgent version that is installed on the host endpoint.Run the
.msifile, selecting the Remove option when prompted.Confirm the software removal by responding Yes or clicking Remove as necessary.
Important
A reboot is necessary after uninstalling Trellix Endpoint Security (HX) xAgent version 29.
Note
Artifacts that remain in the
C:\Windows\FireEyefolder after the xAgent software has been uninstalled will be deleted the next time the endpoint host is rebooted.If a Windows xAgent uninstall attempt fails because the binary is missing or corrupt or because the
ProgramData/FireEye
orProgram Files/FireEye
directories are missing or corrupt, reinstall the agent using command-line commands (msiexec /i xagt.msi /qn
) and then uninstall it.
Uninstalling Windows xAgent software
The table below lists the options for uninstalling Endpoint Security (HX) xAgent software on your Windows hosts.
Uninstall Option | Description |
|---|---|
| Uninstall the software installed by the named installation If the Removal Protection Password is enabled, you must enter this password to authorize the Endpoint Security (HX) xAgent uninstall process by appending the Only authorized users can uninstall the xAgent software. See Configurin g the Agent Removal Protection Password for more information. |
| Set the user interface level for the uninstall process:
|
| Enable agent logging for the uninstall process. |
Uninstalling macOS xAgent software
This section describes how to uninstall the Endpoint Security (HX) xAgent software running on your macOS endpoints.
Important
If your organization uses JAMF or BigFix with the remove-helper option, uninstalling the agent will not remove the system extension.
Note
Uninstalling the agent with the remove-helper option, when your organization uses JAMF or BigFix activates a local permission prompt requiring the approval of a user with administrative rights.
Launch the Terminal and enter the following command to run the uninstall script.
sudo /Library/FireEye/xagt/uninstall.toolEnter the administrator password when prompted.
Enter the following command to verify that no xagt processes are running.
ps aux | grep xagtNote
If xagt processes are running on the endpoint, perform one of the following steps:
If all the agent artifacts still remain on the endpoint, run the uninstall script again.
If all the agent artifacts have been removed from the endpoint, manually terminate the xagt processes.
To uninstall the system extension:
Log in to the terminal as an administrator.
Run the uninstall script.
Enter the following command:
uninstall.tool--remove-helperConfirm that the system extension should be removed.
Drag the system extension to the trash to complete the uninstallation of the agent.
Uninstalling Linux xAgent software
To uninstall Endpoint Security (HX) xAgent software version on your Linux endpoint, you must first determine which uninstall option to use based on the file type you used to install the xAgent software on your Linux endpoint.
The following table shows the specific uninstall command that corresponds to each supported xAgent software installation file type.
File Type | Uninstall Command | Compatible Linux Systems |
|---|---|---|
|
| RHEL, CentOS, Amazon Linux AMI, and SUSE |
|
| Ubuntu |
|
| RHEL and CentOS |
Important
The Endpoint Security (HX) xAgent software installation .rpm and .deb files do not include an uninstall script.
This section includes the following topics:
Uninstalling the Linux xAgent on RHEL-Based Systems
Follow the steps in this section if you need to uninstall the xAgent software from your Linux endpoint running a support RHEL-based operating system, including
RHEL versions 6.8, 6.9, 6.10, 7.2, 7.3, 7.4, 7.5, 7.6, 8 (64-bit)
CentOS versions 6.8, 6.9, 6.10, 7.2, 7.3, 7.4, 7.5, 7.6 (64-bit)
Amazon Linux AMI version 2018.3 (64-bit)
To uninstall Linux xAgent software on your RHEL-based system:
username@localhost:~$ yum list xagt
The example below identifies the xagt-30.0.1-1.el6.x86_64.rpm file as the file that was used to install the xAgentsoftware on the Linux endpoint. You can see the Linux OS bit-architecture, the xAgent software version, and the software status.
|
|
|
Open a Terminal session on your Linux endpoint running Endpoint Security (HX) xAgent software version .
Type the following command to identify the
.rpmor.runthat was used to install the Endpoint Security (HX) xAgent software version on your Linux endpoint.Run the correct uninstall command for the file type you identified in Step 3 to remove the Endpoint Security (HX) xAgent software version from your Linux endpoint.
If the
.rpmfile was used to install the Endpoint Security (HX) xAgent software version on your Linux endpoint, use therpm -ecommand to uninstall the xAgent software from your Linux endpoint.username@localhost:~$ sudo rpm -e <installation_filename.rpm>If the
.runfile was used to install the Endpoint Security (HX) xAgent software version on your Linux endpoint, use the binary path and uninstall script to remove the xAgent software from your Linux endpoint.username@localhost:~$ sudo /opt/fireeye/bin/uninstall.sh
Uninstalling the Linux xAgent on SUSE System
Follow the steps in this section if you need to uninstall the xAgent software from your Linux endpoint running SUSE Enterprise Linux version 11.4, 12.2, 12.3, or 15.
To uninstall Linux xAgent software on your Linux endpoint running a supported SUSE version:
Open a Terminal session on your Linux endpoint running Endpoint Security (HX) xAgent software version .
Type the following command to identify the
.rpmthat was used to install the Endpoint Security (HX) xAgent software version on your Linux endpoint.username@localhost:~$ rpm -qa | grep xagtThe example below identifies the
xagt-30.0.1-1.sle11.x86_64.rpmfile as the file that was used to install the xAgent software on the Linux endpoint. You can see the Linux OS bit-architecture, the xAgent software version, and the software status.xagt.x86_6430.0.1-1.sle11installedRun the
rpm -ecommand to remove the Endpoint Security (HX) xAgent software version from your Linux endpoint.username@localhost:~$ sudo rpm -e <installation_filename.rpm>
Uninstalling the Linux xAgent on an Ubuntu System
Follow the steps in this section if you need to uninstall the xAgent software from your Linux endpoint running Ubuntu version 14.04, 16.04, or 18.04.
To uninstall Linux xAgent software on your Linux endpoint running a support Ubuntu version:
username@localhost:~$ dpkg -l | grep xagt
The example below identifies the xagt-30.0.0-1.ubuntu12_amd64.deb file as the file that was used to install the xAgentsoftware on the Linux endpoint. You can see the Linux OS bit-architecture, the xAgent software version, and the software status.
|
|
|
username@localhost: ~$ sudo dpkg --purge <installation_filename.deb>
Open a Terminal session on your Linux endpoint running Endpoint Security (HX) xAgent software version .
Type the following command to identify the
.debthat was used to install the Endpoint Security (HX) xAgent software version on your Linux endpoint.Run the
dpkg -purgecommand to remove the Endpoint Security (HX) xAgent software version from your Linux endpoint.