Active Administrator 8.7 - User Guide

Setting up automatic Active Directory Health Analyzer agent deployment

Setting up automatic Active Directory Health Analyzer agent deployment

Automatic deployment of the Active Directory Health Analyzer is available only for domain controllers that were not discovered when you ran the wizard to install the Active Directory Health Analyzer agent. See Installing Active Directory Health Analyzer agents into a pool and Installing Active Directory Health Analyzer agents onto domain controllers. Once you run the wizard, any new domain controllers that are brought online can be deployed automatically into the agent pool or the Active Directory Health Analyzer agent can be installed automatically onto that domain controller. By default, only a list of the new domain controllers are sent to a specified email list.

 

NOTE: Once a domain controller is discovered during the Install Active Directory Health Analyzer Agents wizard, the automatic Active Directory Health Analyzer agent deployment will not recognize those domain controllers. You can, however, view a list of unmonitored domain controllers and add selected domain controllers to the list of monitored domain controllers. See Adding monitored domain controllers.

To set up automatic Active Directory Health Analyzer agent deployment

1	Select Active Directory Health | Agents.

2	Open the Analyzer Agents tab.

3	Select More | Automatic Agent Deployment.

4	Open the General tab, if necessary.

5	By default, the automatic agent deployment feature is disabled. If you want to enable the feature, select the Enabled check box.

6	By default, only a list of newly discovered domain controllers is sent to the list of email addresses. The Active Administrator owner is added automatically to the list of email addresses. To add more email addresses to the list, click Add.

 

NOTE: The Active Administrator owner was identified in the AA Configuration Wizard. To change the email address of the AA Owner, see Managing email addresses. NOTE: To manage the DA Agent Auto Deploy email address list, see Managing email addresses.

7	To set up automatic agent deployment, select Deploy agent or domain controller.

▪	If you select to deploy the Active Directory Health Analyzer agent to the domain controller, browse to locate the startup account, and enter the password.

▪	If you choose to deploy the domain controller into the agent pool, you can choose to deploy it immediately, or wait for the specified number of hours.

8	Enter the number of hours to wait before automatically deploying the agent or the domain controller. The default value is 24 hours. You can set the delay for 1 to 48 hours.

9	If you want to exclude any domains from automatic deployment, open the Excluded Domains tab, and click Add.

10

Click OK.

11	To check for pending deployments, open the Pending Deployments tab. You can cancel a deployment or initiate the deployment immediately.

Using the Active Directory Health Analyzer agent configuration utility

Using the Active Directory Health Analyzer agent configuration utility

While you can manage the Active Directory Health Analyzer agent within Active Administrator® (see Managing Active Directory Health Analyzer agents), there may be an occasion when you need to manage the agent outside of Active Administrator. A configuration utility for the Active Directory Health Analyzer agent and Active Administrator Data Service (ADS) server is available to help you diagnose issues. Once you install a Active Directory Health Analyzer agent, you can find the utility at C:\Windows\DAAgent\DAAgentConfig.exe.

NOTE: You cannot use the Active Directory Health Analyzer Agent Configuration utility on a Server Core installation of Windows Server.

Topics 

•	Setting network settings

•	Enable logging

To use the Active Directory Health Analyzer agent configuration utility

•	Launch DAAgentConfig.exe, which is located at C:\Windows\DAAgent.

The utility displays the Directory Agent ID and indicates if the Active Directory Health Analyzer agent is running. You can stop, start, and restart the Active Directory Health Analyzer agent.

You can also configure the Network settings and Logging settings.

Setting network settings

Setting network settings

You can set the address and port number for the Active Administrator Data Service (ADS) server and the port number for the Active Directory Health Analyzer agent.

IMPORTANT: The default values for the ports are 15602 for the ADS Server and 15603 for the Active Directory Health Analyzer agent. If you change the value, verify that the port is open in Windows Firewall on the computer where the Active Directory Health Analyzer agent is installed.

To change a network setting

1	Launch DAAgentConfig.exe, which is located at C:\Windows\DAAgent.

2	Optionally, type the ADS Server Address and click Set.

- AND -

Optionally, type the ADS Server Port Number and click Set.

- AND -

Optionally, type the Active Directory Health Agent Port Number and click Set.

A message warns that the Active Directory Health Analyzer agent may become disabled.

3	Click Yes to continue.

4	Click Yes to restart the agent.

▪	To test the connection with the ADS server, click Test Connection with Server.

▪	To test the connection with the Active Directory Health Analyzer agent, click Test Connection with Agent.

Enable logging

Enable logging

In Active Administrator, you can view recent log entries that are stored in memory. See Managing Active Directory Health Analyzer agents. If you require a log file for troubleshooting purposes, you can enable logging in the utility, which writes the log entries to a file.

Logging for the Active Directory Health Analyzer agent is disabled by default. Enable logging only if you need a log file for troubleshooting as the process may affect performance. The maximum size for the log file is 500 MB. Once the log file reaches its maximum size, it will automatically roll over. The log file is located at C:\Windows\DAAgent\DAAgent.log.

NOTE: When you enable logging, system performance may be affected. Use the utility for troubleshooting purposes only.

•	Launch DAAgentConfig.exe, which is located at C:\Windows\DAAgent.

▪	To enable logging, click Enable, and click Yes to confirm.

▪	To view the log file, click View Log File.

▪	To delete the log file, navigate to C:\Windows\DAAgent\, and delete the DAAgent.log file.