How to troubleshoot errors when installing AgentP
In this topic, you will learn how to troubleshoot typical problems during the installation of Portnox™ AgentP.
Review AgentP logs and events on the endpoint: How to collect AgentP logs for support
Logs: Invalid class
Example:
System.Management.ManagementException: Invalid class
at System.Management.ManagementException.ThrowWithExtendedInfo(ManagementStatus errorCode)
at System.Management.ManagementObjectCollection.ManagementObjectEnumerator.MoveNext()
at AgentP.Server.DataCollection.ComputerInformationCollector.DetectOperatingSystemVersion()
at AgentP.Server.AgentServer.MakeEnrollmentRequest()
Reason:
The WMI repository on the endpoint is probably corrupted.
Verify if you have an issue with the WMI repository by executing the following command in the command line:
wmic os
Solution:
To fix the WMI repository, follow this article: WMI: Missing or Failing WMI Providers or Invalid WMI Class
Logs: There was no endpoint listening
Example:
Method https://mobilecentraal.portnox.com/AgentpBackEndEnrollment/Enrollment
- There was no endpoint listening at
https://mobilecentraal.portnox.com/AgentpBackEndEnrollment/Enrollment
that could accept the message. This is often caused by an incorrect
address or SOAP action. See InnerException, if present, for more details.
Reason:
The communication with Portnox Cloud is blocked.
Solution:
Type the following URLs in the browser on the same computer:
- https://mobilecentraal.portnox.com/AgentpBackEndEnrollment/Enrollment
- https://mobilecentraal.portnox.com/AgentpBackEndEnrollment/CheckForUpdates
As a result, your browser should display the following message: Method not allowed. This means the communication is working correctly.
Logs: Organization not found
Example:
Method https://mobilecentraal.portnox.com/AgentpBackEndEnrollment/Enrollment
- Response BadRequest, Internal error 15074: Organization not found for device
'Laptop' with login 'VORLON\kosh.naranek'
Reason:
Portnox Cloud was not able correlate between the domain name collected from the machine and the domain name configured in Portnox Cloud for the specific domain and AD broker. For example, you may have configured vorlon.com as a domain name, but you didn’t configure vorlon, which is the name collected by AgentP.
Solution:
Add all relevant domain names to the broker configuration in Portnox Cloud:
.Logs: An error occurred during communication
Example:
An error occurred during communication with 'portnox-centraal-prod.servicebus.windows.net:-1'. Check the connection information, then retry.
Reason:
The computer is unable to connect to the Microsoft Azure server, for example, portnox-centraal-prod.servicebus.windows.net.
Solution:
Review the topic that shows how to configure your firewall properly for AgentP: How to set up the firewall for AgentP to connect to Cloud.
Check if a proxy is configured on the machine. If so, you may need to configure an exception for AgentP.
Events: Installation failed
Example:
Product: Portnox AgentP -- Installation failed.
Product: Portnox AgentP -- Error 1920.
Service 'Portnox AgentP Client Service' (PortnoxAgentP) failed to start.
Verify that you have sufficient privileges to start system services.
Reason:
.NET 4.5 is not installed on the endpoint.
Solution:
Install .NET 4.5 on the endpoint and reinstall AgentP.
GPO: Installation fails
Solutions:
-
Add the shared folder as a shared path.
-
Configure the AgentP GPO processing wait time:
macOS: No profile downloaded
When you enroll AgentP, no profile is downloaded or installed. Enrollment works correctly and no errors are reported in Cloud or in the operating system.
Solution:
Check if the following file exists: /var/agentp/unattended.cfg. If it exists, delete this file. Then, unenroll AgentP and enroll again. AgentP should then download the profile.