Configuring the Microsoft Active Directory agent

You must have administrative rights to run the Microsoft Active Directory agent.

1. Click Start > All Programs > Administrative Tools > Active Directory Users and Computers.
2. To expand the domain where you want to create the user, click the plus sign (+) next to the name of a domain.
3. Right-click Users, and then click New > User.
4. To create a new user, open the New Object - User wizard. By default, a new user is a member of the Domain Users group.
5. Right-click the new user that is created in the Domain Users group, and click Properties. The Username Properties window is displayed. The username is the name of the new user.
6. In the Username Properties window, complete the following steps:
   1. Click the Member of tab. In the Member of area, add the Administrators group.
   2. Click Apply, and then click OK.
7. Click Start > Run, and then type services.msc.
8. In the Services window, complete the following steps:
   1. Right-click the Monitoring Agent for Active Directory service, and click Properties.
   2. In the Monitoring Agent for Active Directory Properties window, on the Log On tab, click This Account. Enter the user credentials.
   3. Click Apply, and then click OK.
9. Restart the agent service.

You must specify values for the environment variables to view the Sysvol replication data in the dashboard. Optionally, you can also update the cache interval value to enable or disable caching.

1. In the IBM Performance Management window, from the Actions menu, click Advanced > Edit ENV File.
2. In the K3ZENV file, change the values of the following environment variables.

   ADO_CACHE_INTERVAL

   Determines whether to start or stop the caching and is used to set a value for the cache interval. Cache interval is the duration in seconds between two consecutive data collections. You can specify any positive integer value for the cache interval to start the caching. You can specify the zero value for the cache interval to stop the caching. By default, the caching is started, and the cache interval value is set to 1200.

   ADO_SYSVOL_FORCE_REPLICATION_FLAG

   Determines whether the force replication that is initiated by the agent is enabled or disabled. The default value of this variable is TRUE. To disable force replication, change the value of this variable to FALSE.

   ADO_SYSVOL_REPLICATION_TEST_INTERVAL

   Determines the time interval in minutes between two Sysvol replication tests. The default value of this variable is 0 minutes. To complete the Sysvol replication test, ensure that the value of this variable is greater than zero.

   ADO_SYSVOL_REPLICATION_TEST_VERIFICATION_INTERVAL

   Determines the amount of time in minutes that the agent waits to verify the results of Sysvol replication after it completes the Sysvol replication test.

   The value of the ADO_SYSVOL_REPLICATION_TEST_INTERVAL variable must be greater than the value of the ADO_SYSVOL_REPLICATION_TEST_VERIFICATION_INTERVAL variable. You can use the following values for these variables:

   • ADO_SYSVOL_REPLICATION_TEST_INTERVAL: 1440
   • ADO_SYSVOL_REPLICATION_TEST_VERIFICATION_INTERVAL: 30

   After you assign valid values to the two environment variables, the Active Directory agent creates one file in the Sysvol shared folder of the managed system and initializes forced Sysvol replication. This forced replication is initialized from the managed system to the Sysvol shared folders of the Sysvol replication partners. After you verify the results of the replication test, the agent removes the files that are created and replicated from the managed system and Sysvol replication partners.