Modify tracking changes in configuration files

Configure the system to collect information about changes in configuration files belonging to a configuration item (CI). Service Mapping uses this information to notify users that CI configuration files changed and to view actual changes to configuration files directly in the business service maps.

Before you begin

Role required: cloud_admin, sm_admin or admin
To enable tracking configuration files for a CI for which the system does track files, configure classification for the CI type to which this CI belongs:
Note: There is no need to create CI classifications for hosts because these classifications are included in the base system.

About this task

The system tracks configuration files as part of horizontal discovery process of a CI to which these files belong. Configuration files contain CI settings and parameters. Service Mapping uses this information to notify users that CI configuration files changed and to view actual changes to configuration files directly in the business service maps. To learn about how the system tracks configuration files, stores and updates information about these files, see Configuration file tracking.

The system tracks configuration files for CI types with process classifiers that trigger patterns. The patterns contain tracked file definitions, which specify the CI type that the application belongs to and the path of the configuration file. Several patterns, such as the IIS pattern, provide tracked file definitions by default. You can use these default definitions or create your own for any pattern a process classifier triggers.

Procedure

  1. Navigate to Pattern Designer > Discovery Patterns.
  2. Click the pattern for the relevant CI.
    Attention: Enabling configuration file tracking does not modify the contents of a pattern.
  3. Click the Tracked Files tab.
    One or more tracked file definitions appear by default for Discovery patterns that support configuration file tracking.

    If you do not see the Tracked Files tab, verify that the pattern is specified process classier. See Add the Horizontal Pattern probe to a classifier for instructions.

    Figure 1. Tracked files on the IIS pattern
    Tracked files on the IIS pattern
  4. Click Edit to modify an existing definition or click New to create a new one.
  5. Fill out or modify the form fields (see table):
    Figure 2. Example tracked file definition for IIS Server discovery
    An example tracked file definition for IIS Server discovery
    Field Description
    CI Type Select either the primary or related CI type to which the configuration file belongs.
    File Path Define the path of the configuration file to track. You can use pattern variables and wildcards. For example, for the following path: <the folder with the "install_directory" parameter>/conf/<any xml file>, enter $install_directory+"/conf/*.xml."
    Save Content Select this check box to make this file available for viewing and comparing directly the ServiceNow instance.
    Active Select this check box to enable tracking of this configuration file.
  6. Click Done.
  7. If necessary, set the tracked files deletion strategy as described in Set the deletion strategy for tracked configuration files

What to do next

Run Discovery on the hosts that are running the applications you want to discover with patterns, open the application CI record, and check the Tracked Configuration Files related list.
If you are using Service Mapping, verify that it started collecting information about changes to configuration files:
  1. Navigate to the business service map containing the CIs.
  2. On the Changes tab, check that the list includes a record of the change you made. For example, that the configuration file was added, modified or deleted.

    Configuration files added