Agent leases
Data Governance Edition includes a mechanism that enables the server to determine what agents are functioning without needing each agent to maintain a persistent connection to the Data Governance server.
Every few minutes the agent contacts the server to renew its lease. If the server has not received a lease renewal from an agent in the expected time frame, the agent goes into the "No communication from agent" state. This state indicates that the server is unable to receive information from the agent.
If an agent is in this state, you can attempt to restart the agent. For more information, see Restarting agents.. It is important to understand why the agent allowed its lease to expire. Leases may expire because the agent service stopped unexpectedly or the agent host computer lost its network connection so the agent could not contact the server to renew its lease.
Note: You can also review lease expiration information in the Data Governance server log (DataGovernanceEdition.Service.exe.dlog) in the Data Governance service installation directory (%ProgramFiles%\One Identity\One Identity Manager Data Governance Edition\Server\).
For a complete list of possible agent states, see Verifying managed host system status or Checking the agent status.
Adding and configuring managed hosts
Different types of managed hosts behave differently. The following sections provide the steps to configure each type of managed host.
You can add the following host computers as a managed host to your Data Governance Edition deployment:
- Local Windows computer. For more information, see Adding a local managed host (Windows computer).
- Windows Cluster/Remote Windows computer. For more information, see Adding a Windows cluster / Windows computer as a remote managed host.
- Generic resource (that is, a Server Message Block (SMB) share running on any Active Directory joined computer). For more information, see Adding a generic managed host.
- Distributed File System (DFS) root. For more information, see Adding a Distributed File System (DFS) root managed host.
- SharePoint farm. For more information, see Adding a SharePoint farm managed host.
- EMC storage device with CIFS file system protocol enabled. For more information, see Adding an EMC CIFS device as a managed host.
- NetApp 7-Mode filer with CIFS file system protocol enabled. For more information, see Adding a NetApp CIFS device as a managed host.
- NetApp Cluster-Mode filer with CIFS file system protocol enabled. For more information, see Adding a NetApp CIFS device as a managed host.
- EMC Isilon storage device with NFS system protocol enabled. For more information, see Adding an NFS managed host.
- NetApp 7-Mode filer with NFS file system protocol enabled. For more information, see Adding an NFS managed host.
- NetApp Cluster-Mode filer with NFS file system protocol enabled. For more information, see Adding an NFS managed host.
- SharePoint Online resources. For more information, see Adding a cloud managed host.
- OneDrive for Business resources. For more information, see Adding a cloud managed host.
Related Topics
Managed host configuration settings
Adding a local managed host (Windows computer)
NOTE: You can configure one target host computer at a time or multiple host computers (of the same type) at once.
To add a local managed host to a Windows computer
- In the Navigation view, select Data Governance | Managed hosts.
- In the Managed hosts view (right pane), select a host with the status of Not Managed and a host type of Windows Computer.
-
Select Manage host from the Tasks view or right-click menu.
NOTE: If you selected multiple host computers with the status of Not Managed and of the same host type, use the Manage multiple hosts task or right-click menu command. The settings specified on the Managed Host Settings dialog will apply to all selected host computers.
The Managed Host Settings dialog appears.
NOTE: If you select a host computer on a domain that was not previously identified as a managed domain, the Domain Credentials dialog appears. Click the Set button to supply the credentials of an Active Directory user with administrative rights on the selected domain. Assigning the credentials for the domain registers the user as a Data Governance Edition service account, links the service account to the domain and adds it to the managed domains list.
Once the domain credentials are set, the Managed Host Settings dialog appears.
- At the top of the Managed Host Settings dialog, specify the following information:
- Managed Host: This is a read-only field displaying the name of the host computer selected on the Managed hosts view.
- Host Type: Select Local Windows Computer.
-
Agent Install Path: (Optional) Use this field to specify an alternate installation location. This must be a local path (for example, C:\MyPath) and cannot exceed 512 characters.
NOTE: By default, this field displays Use default install directory and the agent is installed in the Data Governance agent services installation directory (%ProgramFiles%\One Identity\One Identity Manager Data Governance Edition\Agent Services).
- Keywords: (Optional) Enter a keyword which can be displayed and used to group managed hosts in the Managed hosts view.
-
By default, local agents scan all local fixed volumes (NTFS devices) on the host computer. To limit the amount of security data being scanned, use the Managed Paths page to specify the root of an NTFS directory to be scanned. Once you configure one or more managed paths, only those paths are scanned.
To add managed paths:
- Open the Managed Paths page.
- Click the Add button.
-
In the Managed Paths Picker dialog, select the check box to the left of the directories to be scanned.
NOTE: For local managed hosts, the Agent Selection field at the bottom of this dialog is pre-populated with the name of the selected target machine.
- Click OK.
For more information, see Managed paths page.
-
By default, local agents begin scanning immediately once deployed. Use the Security Scanning page to define a different scanning schedule for the agent.
For example, to delay the scan to run during off peak hours:
- Open the Security Scanning page.
- Clear the Immediately scan on agent restart or when managed paths change check box.
-
Use the Scan start time control to specify the desired time to perform the full scan.
NOTE: The Scan start time is local agent time.
Review the options at the bottom of the page to determine if the default security scanning behavior needs to be modified:
- Ignore all files and only store folder security data: Clear this check box if you want to include file security data in the security index.
- Collect activity for real-time security updates: Select this check box to watch for changes to the structure and security of the file system on the target managed host and apply them to the scanned data.
For more information, see Security Scanning page.
-
By default, resource activity is not collected. Use the Resource Activity page to enable and configure resource activity collection on the target host.
IMPORTANT: Collecting resource activity on your managed hosts impacts network usage and increases the load on the database server and Data Governance server, especially when collecting activity on large busy servers. Configuring the proper exclusions and aggregation window is important to limit some of this load. Carefully plan out which resources you want to collect activity on and enable resource activity collection only on those resources.
To configure resource activity collection and aggregation:
- Open the Resource Activity page.
- Select the Collect and aggregate events option.
- Select the type of events to be collected:
- Security change
- Create
- Delete
- Rename
- Write
- Read (disabled by default)
- Use the Aggregation control to set the time frame to be used to consolidate similar events. Valid aggregation intervals are:
- 5 minutes
- 1 hour
- 8 hours (default)
- 1 day
-
By default, certain well-known system accounts, file extensions and folders are excluded from the resource activity collection. To modify the exclusion list, click the Resource Activity Exclusions button to specify the accounts and objects to be excluded.
NOTE: By default, the Data Governance agent excludes the run as account (LOCAL SYSTEM) from activity collection and aggregation.
For more information, see Resource activity page.
- Click the OK button at the bottom of the Managed Host Settings dialog to save your selections and deploy a Data Governance Edition agent on the local computer.
By default, the security scan begins immediately upon agent deployment. Once the managed host is successfully added (Status is Managed), you are able to see and manage security information for the folders and shares on the target managed host using the Resource browser. Double-click a managed host in the Managed hosts view to display the Resource browser.
Adding a Windows cluster / Windows computer as a remote managed host
You can add Windows servers and Windows clusters as managed hosts, with remote agents. However, you cannot collect resource activity for these types of remote managed hosts.
Note: Only Windows failover cluster configurations are supported.
NOTE: You can configure one target host computer at a time or multiple host computers (of the same type) at once.
To add a Windows cluster or Windows computer managed host with a remote agent
- In the Navigation view, select Data Governance | Managed hosts.
- In the Managed hosts view (right pane), select a host with the status of Not Managed and a host type of Windows Computer.
-
Select Manage host from the Tasks view or right-click menu.
NOTE: If you selected multiple host computers with the status of Not Managed and of the same host type, use the Manage multiple hosts task or right-click menu command. The settings specified on the Managed Host Settings dialog will apply to all selected host computers.
The Managed Host Settings dialog appears.
NOTE: If you select a host computer on a domain that was not previously identified as a managed domain, the Domain Credentials dialog appears. Click the Set button to supply the credentials of an Active Directory user with administrative rights on the selected domain. Assigning the credentials for the domain registers the user as a Data Governance Edition service account, links the service account to the domain and adds it to the managed domains list.
Once the domain credentials are set, the Managed Host Settings dialog appears.
- At the top of the Managed Host Settings dialog, specify the following information:
- Managed Host: This is a read-only field displaying the name of the host computer selected on the Managed hosts view.
- Host Type: Select Windows Cluster / Remote Windows Computer.
-
Agent Install Path: (Optional) Use this field to specify an alternate installation location. This must be a local path (for example, C:\MyPath) and cannot exceed 512 characters.
NOTE: By default, this field displays Use default install directory and the agent is installed in the Data Governance agent services installation directory (%ProgramFiles%\One Identity\One Identity Manager Data Governance Edition\Agent Services).
- Keywords: (Optional) Enter a keyword which can be displayed and used to group managed hosts in the Managed hosts view.
-
Use the Agents page to select the remote agent and service account to be used to scan the target host.
To add a remote agent:
- Open the Agents page.
- Select the agent: Select the agent host computer to be used to scan the target computer.
-
Select the service account: Select a service account with sufficient permissions to access the target computer and the agent host.
An agent requires a service account that has the rights to read security information on the remote host. Only previously configured service accounts that are registered with Data Governance Edition are available for selection. For more information, see Readying a service account and domains for deployment.
-
Click the Add button to add the agent to the agents list.
TIP: For remote managed hosts, add only one remote agent during the host's initial deployment. You can add additional remote agents later using the Edit host settings task after the managed host is deployed.
For more information, see Agents page.
-
Use the Managed Paths page to specify the roots of the NTFS directory tree to be scanned by the agent.
To add managed paths:
- Open the Managed Paths page.
- Click the Add button.
-
In the Managed Paths Picker dialog, click the check box to the left of a directory to add it to the managed paths list.
NOTE: When using multiple agents to monitor a remote managed host, select the managed path to be monitored and then select an agent from the Agent Selection drop-down menu. Repeat this process for all paths to be monitored. An agent can monitor multiple paths; however, multiple agents cannot monitor the same managed paths. The Scanning Agent field in the Managed Paths Selection grid displays the agent selected to scan the different paths.
-
Click OK to save your selections and close the dialog.
The selected paths appear on the Managed Paths page.
For more information, see Managed paths page.
-
By default, remote agents scan daily at 2:00 A.M. Use the Security Scanning tab to change the time and frequency with which the agent scans the target computer.
To modify the scanning schedule and settings:
- Open the Security Scanning page.
- Use the controls in the Scanning Schedule pane to define the time and frequency of the agent scans.
- Use the check boxes at the bottom of the page to modify the default security scanning behavior:
- Immediately scan on agent restart or when managed paths change: Select this check box to perform a full scan whenever the agent restarts or there are changes made to the managed paths.
- Ignore all files and only store folder security data: Clear this check box if you want to include file security data in the security index.
- Collect activity for real-time security updates: Select this check box to watch for changes to the structure and security of the file system on the target managed host and apply them to the scanned data.
For more information, see Security Scanning page.
- Click the OK button at the bottom of the Managed Host Settings dialog to save your selections and deploy the managed host.
Scanning of the specified managed paths begins on the configured schedule. Once the managed host is successfully added (Status is Managed), you are able to see and manage security information for the folders and shares on the target managed host using the Resource browser. Double-click a managed host in the Managed hosts view to display the Resource browser.