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 Agents view. Also, if the status of a managed host is anything other than Managed, check the host's agents' status to determine where the issue lies.
|
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.
|
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. |
You must restart an agent when a new storage volume is added to the managed host being scanned by the agent.
To restart an agent
|
Note: When a Data Governance agent is restarted, it re-creates all information within its local index. The server index is updated when the full scan completes. An agent will immediately start scanning when the service is restarted if the Immediately scan on agent restart or when managed paths change option is selected. This option is available at the bottom of the Security Scanning page on the Managed Host Settings dialog. To determine whether data in the client is the most current from the agent, ensure that the data state of the managed host being examined is marked as "Data available." |
|
Note: All agents associated with a managed host are uninstalled when you remove a managed host. |
Before removing a managed host ensure that the impact of its removal is considered. Any governed data records or activity information associated with resources on that host is removed from the database as well. Use caution when removing the governance on an item, as there may be business reasons for this setting.
It can take a considerable amount of time to remove a managed host with governed resources (for example, one to two hours per million governed resources). The Manager lists the managed host in the "Deleting" state until this process finishes.
To remove a managed host (and its agents)
Select a managed host from the Managed hosts view, and select Remove in the Tasks view or right-click menu.
|
Note: You can select multiple managed hosts for removal. The Remove task is not available for host computers with a status of Not Managed. |
Click Remove to confirm the removal.
If you remove a managed host with governed data, the data is no longer governed. All associated security information and resource activity is also deleted.
© 2021 One Identity LLC. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy