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 i icon for any agent endpoint for further details.

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.

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.