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, status, platform and installed date display for each agent endpoint. The status provides detail on the state of the endpoint. Hover over the Status information icon for any agent endpoint for further details.

Status values

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.

1. Select the check box next to the agent endpoint that you want to reassign a policy to.
2. Select Actions > Reassign Policy.
   The Reassign Policy panel appears.
3. Select an Agent Policy from the drop-down, or enter the policy name to filter the list.
4. Click Save.
   The Reassign Policy panel closes.
5. 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.

1. Select the check box next to the agent endpoint that you want you want to attempt redeployment for.
2. Select Actions > Redeploy Agent.
   The Redeploy Agent panel appears.
3. Select the Agent Policy that you want to deploy, or enter the policy name to filter the list.
4. 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.
5. 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.
6. 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.
7. Click Redploy to attempt the deployment again.

Uninstall Agent

To uninstall the Agent.

1. Select the check box next to the agent endpoint that you want to uninstall the agent from.
2. Select Actions > Uninstall Agent.
   The Uninstall Agent dialog appears.
3. Click Uninstall.
   The agent is uninstalled and the agent endpoint is no longer visible in the list on the Agent Management page when refreshed.

Manually uninstall the Agent

Microsoft Windows

• 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.

Apple macOS

1. 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
2. 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.

Linux

• 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.

1. Select the check box next to the agent endpoint that you want you want to remove from the list.
2. Select Actions > Remove Agent Endpoint.
   The Remove Agent Endpoint confirmation dialog appears.
3. Click Remove.
   The agent endpoint is removed and is no longer in the list on the Agent Management page.

How to identify and remove inactive agents from devices

1. Navigate to Agents > Agent Management.
   The Agent Management page appears.
2. 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 .
3. Select Actions > Uninstall Agent.
   The Uninstall Agent confirmation dialog appears.
4. Click Uninstall to confirm the action.