Verifying managed host system status
When you first deploy a managed host it takes a few minutes for the agent to start collecting data. As the status changes, a regular refresh allows you to see the changes. You can also use this status to track the progress whenever you add or remove an agent.
A managed host's status is displayed on the Managed hosts view.
| Status | Description | ||
|---|---|---|---|
|
Agent Issue |
One or more agents for this managed host are in an error state. The Status Detail column on the Agents view may contain additional information to identify the problem.
| ||
|
Agent Out of Disk Space |
An agent for this managed host is out of free disk space. For more information, see Checking the agent status. | ||
|
Agent Registration Failed |
An error occurred while an agent was attempting to register with the server. | ||
|
Agent Unregistered |
An agent for this managed host has unregistered. Ensure that the agent service is running, and that the computer hosting the agent is online. | ||
|
Agent Update Required |
An unsupported agent version has attempted to register with the server. The agents on the managed host must be upgraded. | ||
|
Deleting |
The managed host is being deleted. | ||
|
Deleting And Uninstalling |
The managed host is being deleted and all agents associated with this managed host are being removed. | ||
|
Deploying Agent |
An agent for this managed host is being installed. | ||
|
Install Failed |
An automatic agent install has failed. The Status Detail column on the Agents view may contain additional information regarding the failure. | ||
|
Installing agents failed |
You are attempting to install an agent on a server that already has an agent on it, and that agent belongs to another Data Governance Edition deployment. The Status Detail column on the Agents view may contain additional information, including the name of the deployment that is already using this agent. | ||
|
Managed |
All agents associated with this managed host are working properly. | ||
|
No communication from agent |
The lease for an agent on this managed host has expired. A communications issue has occurred between the agent and the server, or the agent is no longer running. Ensure that the agent can communicate with the server. | ||
|
No agents for host |
There are no agents associated with this managed host. Deploy an agent for this host in order to maintain a security index and track resource activity. | ||
|
Not Managed |
The host computer is not being managed by Data Governance Edition. That is, no managed host has been configured for the host computer. | ||
|
Resolved |
The managed host’s information has been resolved, but it has not yet been configured for management. This is a temporary state. | ||
|
Resolving Agents |
The server is resolving an agent computer for this managed host. | ||
|
Un-deploying Agents |
An agent for this managed host is being uninstalled. | ||
|
Uninstalling agents failed |
An automatic uninstall of an agent failed. The Status Detail column on the Agents view may contain more information regarding the failure. | ||
|
Unknown |
An error occurred while retrieving this managed host's agent status. | ||
|
Unknown host type |
A host computer with an unknown host type was found. | ||
|
Unresolvable |
The managed host computer has failed to be resolved. | ||
|
Unresolved |
The managed host computer has not yet been resolved. | ||
|
Upgrading agent |
The agent is being upgraded to the latest version. | ||
|
Waiting for Agent Connection |
The managed host has been configured and is waiting for an agent to register. If a managed host stays in this state for a long time, it could indicate a communications issue between the agent and the server. |
Determining the state of the data
For each managed host, use the Managed Hosts view to determine the state of the data. Errors should be addressed immediately, in order to ensure accurate data from the managed host being scanned. The following table outlines the different states your data can have.
|
State |
Description |
|---|---|
| A scanning error has occurred | There has been an error with one of the scanners. Data is incomplete, so you should determine what the issue is. Ensure that the managed host is available on the network, and confirm that the agent’s service account has adequate access to the managed host. |
| Data available | The agent has successfully completed scanning security information for the managed host. |
| Please use Agents View to see status data for multiple agents | On multi-agent hosts, this message indicates that the status of the data is not available for all of the agents. Open the Agents View to see the status of the data for each individual agent assigned to the selected managed host. |
| Scanning | The agent is performing a full scan of security information. Queries for information at this time may be incomplete. |
| No managed paths configured | There are no managed paths specified and therefore scanning cannot be performed on the managed host. |
| Waiting for scanning to start | The agent is ready to scan when the next scheduled scan is triggered. |
| Waiting for scanning status | The agent is not yet ready to start scanning. |
Checking the agent status
For security indexing and resource activity tracking to function as expected, the agent must have a status of Managed. You can see the status of an agent in the
|
|
Note: During deployment, the state changes quickly, and a regular refresh allows you to see the changes. |
|
Agent states |
Description | ||
|---|---|---|---|
| Agent host belongs to another deployment | An agent already resides on this server that belongs to another Data Governance Edition deployment. See the Status Detail column for additional information, including the name of the deployment that is already using this agent. | ||
| Agent Out Of Disk Space |
The hard disk of the agent's working directory dropped below 2GB.
| ||
| Agent Shutdown Because of Error |
The agent may shut down with error for the following reasons:
| ||
| Agent Update Required | An unsupported agent version has attempted to register with the server. | ||
| Agent Unregistered | The agent has unregistered. | ||
| Configuration Failed | An error has occurred while creating the agent service on the agent host computer. | ||
| Configuration in Progress | The agent service is being configured. | ||
| Deleting | The agent is being deleted. | ||
| Deleting and Uninstalling | The agent software is being uninstalled. | ||
| Host Configuration Failed |
While preparing for an agent installation, one of the conditions were encountered:
| ||
| Host Domain Not Managed | The host domain is not yet managed in Data Governance Edition. | ||
| Install Failed | An error occurred while installing the agent. | ||
| Install in Progress | The agent installation is in progress. | ||
| No Communication from Agent | The agent has failed to renew its lease. This state is often an indication of an error on the agent computer. Ensure that the agent can communicate with the server. | ||
| OK | The agent is working properly. The agent is deployed and has contacted the Data Governance service. | ||
| Registration Failed | An error occurred while the agent was attempting to register with the server. | ||
| Removal of configuration failed | An error occurred while removing the agent from the agent host computer. | ||
| Removal of configuration in progress | The agent service is being removed. | ||
| Resolved | The managed host's information has been resolved, but it has not yet been confirmed for management. This is a temporary state. | ||
| Uninstall Failed | An error occurred while uninstalling the agent service from the agent host computer. | ||
| Uninstall in Progress | The agent is being uninstalled. | ||
| Uninstalled | The uninstall has finished. This is a temporary state. | ||
| Unknown | The current state of the agent is unknown. | ||
| Unresolvable | The agent computer cannot be resolved. | ||
| Unresolved | The agent computer has not yet been resolved. | ||
| Waiting for agent connection |
The management server is waiting for the agent to register with the server.
|
Viewing agent errors
You can quickly assess your agents for any potential critical issues by reviewing logged error messages using the Agents view in the Manager.
|
|
Note: The Agent Errors column in the Managed hosts view indicates when an agent associated with a managed host has encountered any errors. However, you can only view an agent's error messages using the Agents view. |
To view agent errors
-
In the Navigation view, select Data Governance | Agents.
The Agents view appears.
-
The Critical Error column indicates if there are any error messages logged for an agent.
-
Select the agent from the Agents view, and select View agent errors in the Task view or right-click menu.
Note: The View agent errors task is only available for agents that have error messages logged.
-
The event viewer appears.
Click the
Clear Events button in the upper left corner to clear the agent errors. Click Yes on the confirmation dialog.
Click the close button in the upper right corner to close the event viewer.
|
|
Note: You can also clear error messages for a specific agent using the Clear agent errors task from the Agents view. |