Foglight for Active Directory 5.7.2.5 - User and Reference Guide

Create a New Test - select this task to specify the test parameters to be used to run a test. Selecting this task launches the Create New Diagnostic Test wizard which steps you through the process.

•

Copy Existing Test - select this task to use an existing test as a basis for creating a new test. Selecting this task displays the Copy Diagnostic Test dialog allowing you to select an existing test to be copied. Once you select a test to be copied, the Create New Diagnostic Test wizard is launched allowing you to modify the test parameters as required.

•

Edit Existing Test - select this task to modify the test parameters of an existing test. Selecting this task displays the Edit Diagnostic Test dialog allowing you to select an existing test to be modified. After selecting the test to be edited, the Edit Diagnostic Test wizard is launched allowing you to modify the test as required.

Create New Diagnostic Test

The Create New Diagnostic Test wizard allows you to select the type of test to be run and to specify the test input and the servers the test is to be run against. It also allows you to specify when the test is to be run.

To create a new test:

Select the Create a New Test task in the task list at the top of the dashboard to launch the Create New Diagnostic Test wizard.

On the Create New Test page, enter the following information:

•

Diagnostic Test Name - enter a descriptive name for the test to be run

•

Test Type - select the type of test to be run

•

Test Input - enter the test input as required

On the Test Targets page, select the Select Targets button. On the Select Targets dialog, select one or more servers and select OK.


	NOTE: You can also select all the servers in a domain or a site, by using the View by options at the top of the dialog and selecting either a domain or site from the displayed list.

On the Test Execution Schedule page, select one of the following options to define how often the test is to be run:

•

Run Once - select to run the test one time when the Finish button is selected.

•

Run Periodically - select to run the test multiple times during a day. Enter how often the test is to be run (every nn minutes). To specify a start and end time, select the Use execution window check box and use the calendar controls to specify the start and end time.

•

Run Once Each Day - select to run the test every day at the specified time. Use the calendar control to specify the time.


	NOTE: A test should not be re-run within 10 minutes. If you select to re-run the test within this 10 minute interval, the Test Run Frequency Warning message appears.

Select Finish to initiate the test run and close the wizard.

The new test appears in the Diagnostic Tests list on the Diagnostic Tests dashboard. To view the test’s results, select the selection icon to the left of the test in this list.

For more information about the controls and information requested on the wizard, see Create New Diagnostic Test Wizard

Copy Existing Diagnostic Test

To copy an existing test:

Select the Copy Existing Test task in the task list.

On the Copy Diagnostic Test dialog, select the test to be copied and select the Copy button.

On the Create New Diagnostic Tests dialog, modify the following information as appropriate:

•

On the first page, enter a new name for the test, select the type of test to be run and enter any test inputs.

•

On the second page, select the Select Servers button to select the servers on which the test is to be run.

•

On the last page, select when the test is to be run.

Select Finish to save your selections and close the wizard.

The new test appears in the Diagnostic Tests list on the Diagnostic Tests dashboard.

Edit Existing Diagnostic Test

To edit an existing test:

Select the Edit Existing Test task in the task list.

Select the test to be modified from the Edit Diagnostic Test dialog and select Edit to launch the Edit Diagnostic Test wizard.


	NOTE: You can also select a test from the Diagnostic Test list and click the Edit toolbar button at the top of the test list to launch the Edit Diagnostic Test wizard.

Modify the settings as appropriate:

•

On the first page of the wizard, you can modify the test input parameters.

•

On the second page of the wizard, you can select a different set of servers.

•

On the last page of the wizard, you can select a different run schedule.

When complete, select the Finish button to save your selections and close the wizard.

Create New Diagnostic Test Wizard

This wizard is launched when you select the Create a New Test or Copy Existing Test task in the tasks list on the Diagnostic Tests dashboard.

The Create New Diagnostic Test wizard includes several pages and requires the following information:

•

Create New Test: From this page, provide a name for the new test, select the test type and enter the test input.

•

Diagnostic Test Name: Enter a descriptive name for the diagnostic test.

•

Test Type: Select the type of test to be run.

•

Test Input: Depending on the type of test selected, this pane displays the test input that must be entered.


	NOTE: See the description of each individual diagnostic (Diagnostic Tests reference) for the test input required for each diagnostic.

•

Test Targets: From this page, select the target servers on which the test is to be run.


	NOTE: For each test, the credentials for the domain controllers selected on this page are used to query all of the servers selected in the diagnostic. For diagnostics that query additional servers (i.e, replication partners, the PDC Emulator or Schema Master), all the servers must be within the same forest and the account used must have access to all the selected servers. NOTE: For the File Replication and Track Replication diagnostics, select only one target server.

•

Select Targets: Selecting this button displays the Select Targets dialog which lists the servers which are being monitored by an Active Directory® agent.


	NOTE: This list will not include servers that host an Active Directory agent which has not yet reported any data. It will also list servers that may not be currently running, but have previously collected data.

Use the View by option at the top of the dialog to display the available servers. Depending on this setting, you can select one or more servers, all servers in a domain or all servers in a site.

•

View by Servers - allows you to select one or more individual servers or all servers.

•

View by Sites - allows you to select one or more individual servers or a site to include all servers in that site

•

View by Domains - allows you to select one or more individual servers or a domain to include all servers in that domain.

After selecting the target servers to be tested, use the OK button to close the dialog and return to the wizard.

Once a target is selected, the following information is displayed:

•

Type - indicates whether a server, domain or site was selected on the Select Targets dialog.

•

Name - displays the name of the selected server(s), domain(s), or site(s).

•

Test Execution Schedule: From this page, specify how often the test is to be run.

•

Run Once: Select to run the test one time when the Finish button is clicked.

•

Run Periodically: Select to run the test multiple times during the day. Enter the following information to specify when the test is to be run during the day:

•

Run every nn minutes - enter the number of minutes

•

Use execution window - select this check box and use the calendar controls to specify the start and end time.

•

Run Once Each Day: Select to run the test once each day and use the calendar control to select the time the test is to be run.

About Diagnostic Test Types pane

The About Diagnostic Test Types pane in the upper right corner of the dashboard displays a list of test types available.

Figure 43. About Diagnostic Test Types

Selecting a test type from this list displays a pop-up which provides a brief description of the selected test.

Diagnostic Tests list

The remainder of this dashboard consists of the Diagnostic Tests list. As tests are created using the Create A New Test task, the test parameters as specified in the wizard will be displayed for each new test created. From this list, you can select the Run Now icon to run the test or select a test to view the test results.

Figure 44. Diagnostic Tests list

The Diagnostic Tests list contains the following information for each test that has been scheduled to run.

Table 88. Diagnostic Tests list information
Column	Description
	Select the selection icon for a test to display an additional panel at the bottom of the page to display the results of the selected test. See Test results for a description of the additional details displayed. Selecting a test also enables the Edit and Delete toolbar buttons allowing you to remove the test from the list or edit the test to be run.
Test	Displays the name of test as entered on the first page of the wizard.
Run Now	Click the icon in this column to initiate a test run. NOTE: A test should not be re-run within 10 minutes. If you select to re-run the test within this 10 minute interval, the Test Run Frequency Warning message appears. NOTE: If agent data collection is turned off for the selected target server, the test will fail. If you start the data collection for the server and run the test within the 10 minute interval, the Test Run Frequency Warning message appears. Use the Overrule button to run the test now that the agent data collection is turned on.
Last Run Time	Indicates the date and time when the test was last run.
Schedule	Displays the test execution schedule as specified in the wizard.
Test Type	Displays the type of test.