Change Auditor 7.3 - User Guide

Connection wizard

The Connection wizard steps you through the process of defining a new connection profile. It is started when you select Add at the bottom of the Manage Connection Profiles dialog.

Table 1. Connection wizard

Change Auditor Environment page: Select one of the following connection methods. Depending on the option selected, additional information is requested on this or subsequent pages.

NOTE: If logon credentials are required for access, a dialog displays allowing you to enter the credentials.

Forest

Select to locate a coordinator in a trusted forest. By default the local forest is displayed; however, you can enter the DNS name of a different trusted forest that has access to a DNS server and can be resolved.

NOTE: You cannot enter an IP address in this field.

Global Catalog

Select to connect to a coordinator in an untrusted forest and enter the name or IP address of the global catalog to be used.

NOTE: Use SQL authentication when connecting to an untrusted forest.

Manual

Select to specify the fully qualified domain name or the IP address of the server where the coordinator resides and the port number assigned to the coordinator.

NOTE: When you select to add or edit a manual connection, you will have the option to Use WCF Certificate Authentication and Disable Certificate Revocation List Check. When specifying the coordinator service properties, these check boxes must reflect the options for which the coordinator is configured. For details see, Certificate authentication for client coordinator communication.

Database Direct

Select to connect directly to the Change Auditor database, without going through the coordinator. With this option, you are connected as an operator with read-only privileges; therefore, the Administration Tasks tab is not available.

NOTE: If the database is in a SQL AlwaysOn Availability Group, you need to connect to the availability group listener. Ensure there are no existing open connections to the database if an upgrade will be performed. The upgrade will not proceed if there are other existing open connections to the database.

NOTE: Use the Database Direct method to connect to an archived 6.x Change Auditor database.

An extra page is displayed requesting the following information:

•

Change Auditor Server (\SQL Instance) - Enter or browse to select the server (name or IP address) and the SQL instance for the Change Auditor database.

•

Change Auditor Database - Enter the name of the Change Auditor database.

Connect to Change Auditor Coordinator page: This page is displayed after you have selected the connection method. The information required is based on the connection method.

NOTE: When you select to add or edit a manual connection, you will also have the option to Use WCF Certificate Authentication and Disable Certificate Revocation List Check. When specifying the coordinator service properties, these check boxes must reflect the options for which the coordinator is configured. For details see, Because this is a significant change which may require the re-deployment of Change Auditor components, you are presented with a confirmation dialog. Select Yes to continue or No to return to the Client Authentication page..

Service Connection Point

When the Forest or Global Catalog options are selected on the previous page, this list displays the Service Connection Points (SCPs) available for use. Select the SCP to use from this list.

Coordinator DNS/IP Address

If you selected the Global Catalog option and want to override the coordinator service DNS, enter the IP address (IPv4 or IPv6) of the server where the coordinator resides.

If you selected the Manual option, enter the fully qualified domain name or IP address (IPv4 or IPv6) of the server where the coordinator resides.

NOTE: If the coordinator host cannot be resolved by DNS (e.g., if the coordinator service is running under a service account instead of Local System) you must enter the IP address of the server where the coordinator resides.

Coordinator Port

If you selected the Global Catalog option and entered the IP address to override the coordinator server DNS, enter the port number assigned to the coordinator.

If you selected the Manual option, enter the port number assigned to the coordinator.

NOTE: You can obtain the port number assigned to a coordinator using the coordinator log file or Coordinator Status dialog (coordinator system tray icon).

Connection Profile Summary page: This page allows you to review the connection profile details, name your profile and test your new connection profile.

Profile Summary

This displays the settings defined within the wizard. The content depends upon the connection method selected. The information displayed may include:

•

•

•

•

•

Change Auditor coordinator server/instance

Connection Profile Name

Enter a descriptive name to assign to the new connection profile.

Test

Use to test the connection as defined in the connection profile.

Client components

The client contains the following main components:

•

Title Bar - is located across the top of the screen and displays the name of the forest and installation name to which you are currently connected.

•

Menu Bar - is located directly below the title bar and displays the menus for accessing Change Auditor commands. See Change Auditor Commands for a description of the menu bar commands.

•

File Menu - use the File Menu commands to connect to or disconnect from a coordinator, print the currently displayed content, open client logs, or exit the client.

•

Edit Menu - use the Edit Menu commands to manage your searches and folders on the Searches page.

•

Action Menu - use the Action Menu commands to refresh or reset a page, autofit columns, display the XML or SQL tabs, enable/disable the auto connect feature or enable/disable the desktop notification messages.

•

View Menu - use the View Menu commands to display a different Change Auditor page.

•

Help Menu - use the Help menu commands to display the online help, retrieve general information about this release, send feedback about using the product or collect system logs for troubleshooting purposes.

•

Tabbed Pages - are displayed below the menu bar and are used to navigate through Change Auditor. The pages that can be displayed, include:

•

The Start page to view and access relevant information regarding Change Auditor including news and updates, support and knowledge base content, online documentation (release notes and guide), links to the latest releases, and essential contact links.

•

The Deployment page to deploy, upgrade or uninstall agents from a single location.

•

The Overview page provides a real-time stream of events based on a ‘favorite’ search definition. It also contains statistics about the events and the status information for the agents and the coordinator.

•

The Searches page contains a list of all the searches available. From this page you can run a search, create a customized search, enable/disable alerting and reporting for a search query.

•

A new Search Results page is created whenever a search is run. These pages contain a list of the events returned as a result of the selected search. From this page, you can also view the details of an event or the search properties used to return the displayed events.

•

The Alert History page is displayed when the Alert | History right-click command is selected for an alert-enabled search definition on the Searches page and includes details regarding the events that triggered the selected alert.

•

A new Report page is created whenever the Preview Report tool bar button is used on the Report tab (Search Properties tabs) for a search query. The Report page displays a rendering of the events returned as a result of the selected search.

•

A new Log page is created whenever one of the View Logs commands are selected and displays the event details recorded in the selected log.

•

The Agent Statistics page displays status and statistics for all installed agents.

•

The Coordinator Statistics page displays status for all installed coordinators.

•

The Administration Tasks tab allows you to perform a variety of administration tasks. Use the navigation pane in the left-hand pane to select the administrative task to be performed. See Administration Tasks for an overview of the tasks that can be performed using the Administration Tasks tab and the product license required to perform these tasks.