Chat now with support
Chat with Support

Identity Manager Data Governance Edition 9.0 LTS - User Guide

One Identity Manager Data Governance Edition User Guide Data Governance node and views Administering Data Governance Edition Managing unstructured data access
Managing resource access Managing account access Working with security permissions Working with SharePoint security permissions Account access modeling Bringing data under governance
Classifying governed resources Managing governed resources using the web portal Data Governance Edition reports Troubleshooting EMC, NetApp Filer, and SharePoint configuration details PowerShell commands Governed data attestation policies Governed data company policies Governed data risk index functions

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.

Table 54: Data states

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

Table 55: Agent states

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.

NOTE: This condition causes the agent to shutdown with an error. This is a safeguard to prevent disruption of other services hosted on the computer, allowing you time to add a volume or reallocate space. See Agent Shutdown Because of Error.

Agent Shutdown Because of Error

The agent may shut down with error for the following reasons:

  • Agent scanning does not progress after two hours.

  • There is not enough free disk space on the agent (minimum 2GB). See Agent Out Of Disk Space.

    NOTE: To determine if low space on the host volume was the cause, check the Agent Events view or agent logs.

  • An error occurred while the agent attempted to open an NTFS security database to perform a sync.
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:

  • The host's data root is invalid.
  • The host has a NetApp FPolicy configuration error.
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.

NOTE: If an agent remains in this state for a long time, it could indicate a communication issue between the agent and 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

  1. In the Navigation view, select Data Governance | Agents.

    The Agents view appears.

  2. The Critical Error column indicates if there are any error messages logged for an agent.

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

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

Restarting agents

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

  1. In the Navigation view, select Data Governance | Agents.
  2. Select the required agents in the Agents view, and select Restart agent in the Tasks view or right-click menu.
  3. Click Yes to confirm.

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

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating