Question
What do I do if I attempted to upgrade an EPM agent, and now the agent is disconnected?
Answer
If you want to be automatically notified of any changes to this article, please click the "+Follow" button.
Idira is aware of an agent registration problem that can occur in rare cases after attempting to upgrade EPM agents. There are two possible methods to correct this behavior.
Method 1: 1. Upgrade the agent v23.3.0.1198 or later using third-party automation tools, such as SCCM
2. Allow up to 4 hours for the agents to reconnect. The system will clear the lock and allow the agents to receive policies.
Method 2:Customers whose issues were not corrected by Method 1 should proceed with the remediation steps documented below.
If you need to remediate this problem on machines individually, here are the steps to apply the fix:
- Uninstall EPM
- Uninstall the agent using this command if you do not have Agent Self Defense enable
MsiExec.exe /X {Msi_path_of_the_installation_file} FULL_UNINSTALL="YES" /qn- Note - as long as the endpoints have access to the directory and the agent.msi is located in that directory, this command can be deployed via a 3rd party distributor like SCCM
- Uninstall the agent using this command if you have Agent Self-Defense enabled
- MsiExec.exe /X {GUID} FULL_UNINSTALL="YES" SECURE_TOKEN="TOKEN"
/qn - Note - GUID value is distinct per agent version so that you can deploy this command via a 3rd party distributor like SCCM. To determine GUID, please see KB Article How to uninstall EPM agent
- Remove the Disconnected Computer Object in the EPM Console
- If you have policies that target computers using "Computers in set," note those policies now and which computers are targeted by those policies. You can generate a report if you are unsure which policies have this kind of targeting. EPM > Reports > Reports (Legacy) > Policies Reports > Policies Summary > Full Report In Excel > Open the xlsx file > "Policies" sheet > Check columns H and I to find Policies with "computers in set" targeting.
- EPM Console > My Computers > right click the disconnected endpoint > Delete.
- The purpose of this step is to prevent duplicate computer objects, which can cause you to exceed your maximum license count.
- If you accidentally delete a computer that didn't have a problem but was just powered off, it should automatically check-in and create a new computer object when that computer comes back online.
- Reinstall EPM.
- For any policies that targeted the computers using "computers in set" targeting, you'll need to re-add those computers to the targeting of those policies.