Agent Management
The Agent Management page provides a list of all agent endpoints. From here, you can view the assigned policy, reassign or redeploy a policy, uninstall an agent, and remove an agent endpoint.
Devices display in this list as soon as the Deploy action has been requested to the device. To learn more about deploying to a device see Agent Deployment.
The name of the agent endpoint, agent policy installed, health, status, platform and installed date/time display for each agent endpoint.
Agent Health
This feature is Early Access only and may not be available in your environment. For more information, please contact your Customer Success Manager.
The Health column shows the overall health status relating to agent capabilities and platform checks, for each device:
- Good (green): Agent functioning as expected.
- Moderate (amber): Agent functioning, but not in optimal state.
- Poor (red): Agent not functioning.
The health status is automatically updated on each agent check-in.
You can select the Agent Check-in drop-down to filter the agent endpoint list by last agent check-in:
- Within 7 days: The agent has checked-in within the last 7 days.
- Between 7 and 90 days: The agent last checked-in between 7 and 90 days.
- Over 90 days: The agent last checked-in over 90 days ago.
- Never: The agent has never checked-in.
- Duplicates: The agent has been superceded by another agent that has registered with the same endpoint name.
Duplicates can occur, in the Agent Management view, when endpoints are regularly re-imaged. Ivanti Neurons does not perform an auto-cleanup from this view. You can use the Duplicates filter to identify and remove unwanted, duplicate agent endpoints. - All: All agent check-ins.
When All is selected the Agent Endpoint column displays an icon to indicate the agent check-in state:- late: The agent has not checked-in within the last 7 days.
- missing: The agent last checked-in over 90 days ago.
- never: The agent has never checked-in.
- duplicate: The agent has been superceded by another agent that has registered with the same endpoint name.
In the table, click on an agent endpoint's health indicator: Good, Moderate, Poor, to view more detail. The Agent Health page appears. See Agent Health for more details.
Agent Status
The Status column provides detail on the state of the endpoint. Hover over the Status information icon for any agent endpoint for further details.
DeploySuccess: Active
DeployStarted: Deployment started
DeployResolved: Deployment resolved
DeployConnected: Deployment connected
DeployValidated: Deployment validated
DeployFilesCopied: Deployment copied files
DeployInstallerStarted: Deployment installer launched
UserRequestAssignPolicy: Reassign policy requested
UserRequestDeploy: Deploy agent requested
UserRequestRedeploy: Redeploy agent requested
UserRequestUninstall: Uninstall agent requested
ErrorDeployEnrollmentKeyExpired: Deployment enrollment key expired
ErrorDeployInvalidCredentials: Deployment invalid credentials
ErrorDeployInternal: Deployment internal error
ErrorDeployNameResolutionFailed: Deployment name resolution failed
ErrorDeployConnectToDevice: Deployment unable to connect to endpoint
ErrorDeployConnectToRegistry: Deployment unable to connect to remote registry
ErrorDeployValidationSkipped: Deployment Hostname validation skipped
ErrorDeployValidation: Deployment Hostname validation failed
ErrorDeployCopyFilesNoInstaller: Deployment agent installer unavailable
ErrorDeployCopyFilesFailed: Deployment unable to copy files to endpoint
ErrorDeployInstallerRemoteService: Deployment unable to create the remote service
ErrorDeployStartInstaller: Deployment unable to launch installer
Actions
Reassign Policy
To assign a different policy to an agent endpoint.
- Select the check box next to the agent endpoint that you want to reassign a policy to.
- Select Actions > Reassign Policy.
The Reassign Policy panel appears. - Select an Agent Policy from the drop-down, or enter the policy name to filter the list.
- Click Save.
The Reassign Policy panel closes. - On the Agent Management page, the Status updates to Reassign policy requested. Hover over the status to see who requested the policy change, on what date, and the name of the policy that was assigned.
Redeploy Agent
To redploy an agent.
- Select the check box next to the agent endpoint that you want you want to attempt redeployment for.
- Select Actions > Redeploy Agent.
The Redeploy Agent panel appears. - Select the Agent Policy that you want to deploy, or enter the policy name to filter the list.
- Select the Enrollment Key, or enter the name to filter the list. If you want to use a new key, select Create New Key: the Create Enrollment Key panel displays.
- Select the agent endpoint that you want to use to Deploy from, or enter the name to filter the list. The drop-down lists the available agent endpoints that have a policy with the Deployment capability enabled.
- If there are no valid credentials the Credentials drop-down is available. Select the Credential for the agent endpoint. Or, select to Create New Credential: the New Credential panel displays.
- Click Redploy to attempt the deployment again.
Uninstall Agent
To uninstall the Agent.
- Select the check box next to the agent endpoint that you want to uninstall the agent from.
- Select Actions > Uninstall Agent.
The Uninstall Agent dialog appears. - Click Uninstall.
The agent is uninstalled and the agent endpoint is no longer visible in the list on the Agent Management page when refreshed.
- To uninstall an Ivanti Neurons Agent on a Microsoft Windows endpoint, execute the following command:
C:\Program Files\Ivanti\Ivanti Neurons Agent\STAgentManagement.exe -uninstall - The uninstall log can be found at:
C:\ProgramData\Ivanti\Ivanti Neurons Agent\Logs\AGENT_uninstall.log - For an overview and explanation of possible parameters, execute the following command:
C:\Program Files\Ivanti\Ivanti Neurons Agent\STAgentManagement.exe /?
For additional information, see this article in the Community: How to uninstall the Ivanti Neurons Agent.
- To uninstall an Ivanti Neurons Agent on an Apple macOS endpoint, execute the following command from the Terminal or using a device management application:
/usr/local/com.ivanti.cloud.agent/IvantiAgent/bin/stagentctl uninstall - Navigate to Users & Groups in system settings on the machine, and delete the _ivantiNeuronsMacPatchAgent account.
Alternatively, use the command sudo sysadminctl -deleteUser _ivantiNeuronsMacPatchAgent.
- No uninstall log is left behind.
- For an overview and explanation of possible parameters, execute the following command:
/usr/local/com.ivanti.cloud.agent/IvantiAgent/bin/stagentctl
For additional information, see this article in the Community: How to manually uninstall the macOS Neurons Agent.
- To uninstall an Ivanti Neurons Agent on a Linux endpoint, execute the following command:
yum remove ivanticloudagent - The uninstall log can be found at:
/opt/ivanti/cloudagent
Remove Agent Endpoint
When an agent has been manually uninstalled from an endpoint, or if the status is not progressing, you need to remove it from the Agent Endpoint list.
- Select the check box next to the agent endpoint that you want you want to remove from the list.
- Select Actions > Remove Agent Endpoint.
The Remove Agent Endpoint confirmation dialog appears. - Click Remove.
The agent endpoint is removed and is no longer in the list on the Agent Management page.
- Navigate to Agents > Agent Management.
The Agent Management page appears. - The Status column indicates whether the agent is Inactive. Select the check box for the agent endpoints that you want to remove the agent from .
- Select Actions > Uninstall Agent.
The Uninstall Agent confirmation dialog appears. - Click Uninstall to confirm the action.