Submit a ticketCall us

AnnouncementsFace your biggest database issues head-on

Our new eCourse helps you navigate SQL Server performance blocks by teaching you how to recognize and deal with the three DBA Disruptors: Performance Hog, Blame Shifter, and Query Blocker. Register today to learn how to defend your environment and fend off menacing disruptions.

Register for your free eCourse.

Home > Success Center > Server & Application Monitor (SAM) > SAM Documentation > SAM 6.7 Administrator Guide > Monitor with Orion agents in SAM > Agent management for SAM

Agent management for SAM

Updated: 3-9-2017

Check agent connection and deployment status on the Manage Agents page.

  1. Click Settings > All Settings in the menu bar.
  2. Under Node & Group Management, click Manage Agents.

The icon displayed next to each Agent/Node indicates the status of the node or an agent icon. The agent icon indicates one of the following:

  • An Orion agent has been deployed to a server not managed as a node
  • An Orion agent has been deployed to a manged node but the currently used polling method is not the agent

Manage Agents toolbar options


Button Description
Add Agent Go to the Add Agent page, where you can deploy the agent on a network, or connect to a previously installed agent.
Edit Settings Go to the Edit Agent Settings page, where you can adjust the agent name and automatic updating.
Delete Remotely uninstall the agent.
Choose Resources

Displays a list of resources and statistics to monitor. This is only available for agents that are deployed on nodes.

  • For a Single Agent: Go to the List Resources page to choose items on the node you want to monitor.
  • For Multiple Agents: From here, Orion discovers available resources on the agents you have selected using Network Sonar Discovery. You can choose items on the nodes to monitor.
Manage as Node Manage the agent as a new node by navigating to the Add Node page with pre-configured agent details.
More Actions
  • View installed agent plug-ins: Displays a dialog detailing the node the agent is deployed on, the agent status, connection status, plug-in status, and plug-in version.
  • View installed plug-ins report: Generates a report detailing node status, agent DNS name, automatic update enabled, connection status, agent status, agent version, plug-in, plug-in status, and plug-in version.
  • Retry agent installation: Attempts to install the agent in the event of a file transfer timeout due to network connectivity issues.
  • Reboot Agent Machine: Reboots the server that hosts the selected agent.

    This button is disabled by default. It is enabled when the installation of an agent requires a system reboot.

  • Update: Updates the agent software to the latest version available.

    This button is disabled by default. It becomes enabled when:

    • Automatic updates for the agent is disabled.
    • The selected agent requires an update.
  • Reconnect to passive agent: The server tries to re-establish the connection to the passive agent when the connection is lost and automatic reconnection fails. This can also be used for connecting to an agent that was deleted but not uninstalled.

Manage Agents table columns

The table on the Manage Agents page displays information on the status and connection of your agents.

Column Header Description
Agent/Node Name or IP address of the listed node.
Agent Status

Current status of the listed agent.

Agent Status can be as follows:

  • Connected/OK: Everything is working.
  • Unknown: The agent is connected but no communication is received.
  • Update Available: The agent version is older than the version on the server and should be updated.
  • Update in Progress: The agent is currently being updated.
  • Reboot Required: The agent needs to be rebooted in order to finish the installation of plug-ins.
  • Reboot in Progress: The agent is currently being rebooted. Once reboot is complete, the agent should finish installation of plugins.
  • Reboot Failed: The agent cannot be rebooted. It may be temporarily offline or there may be some other issue.
  • Plugin Update Pending: A plugin on the agent has an older version than the one that is on the server and should be updated.
Connection Status

Current connection status of the listed agent.

Connection status can be as follows:

  • Connected/OK: The agent is connected.
  • Unknown: The agent management service is not running.
  • Service not Responding: The agent management service is running, but the agent is not connected.
  • Deployment Pending: An agent deployment is going to start, but has not started.
  • Deployment in Progress: The agent is being deployed to the target node.
  • Deployment Failed: Agent deployment failed.
  • Invalid Response: The status displayed if the agent responds in an unexpected manner.
  • Waiting for Connection: The agent was approved, but has yet to connect to the Orion server.
Registered On Date when the agent was added to the agent management system.

Agent communication type:

  • Agent-initiated: The agent initiates the connection to the agent management system.
  • Server-initiated: The agent listens on its designated port for connections from the Orion server.
Version Version of the agent software. This is helpful in determining which agents should be updated.

When viewing Linux-based nodes monitored by Orion agents for Linux, the table includes additional columns of data. These columns include the following:

Column Header Description
Agent - Package Distro Name Displays the distribution name of the installer package. This is the name of the common installer for Linux distributions. For example, suse displays as the common installer for all 64-bit SUSE distributions.
Agent - OS Distro Name Displays the general distribution name of the Operating System. For example, opensuse displays for an installed SUSE distribution.
Agent - Operating System Displays the installed Operating System name and version. This value will differ from the package installer version. For example, opensuse 42.1 x64 is the installed OS version for this SUSE distribution.
Agent - Package Operating System Displays the installation package name and version for the distribution. The installer package version may differ from the installed Operating System version. For example, suse 10.0 x64 is the package version for this SUSE distribution.
Last modified