Identity Director Administration Guide

Home 

Create a trace file to troubleshoot the Catalog Services

Catalog Services have been deprecated as of Identity Director 2019.1. This topic only applies to version 2019.0.

Trace files contain logging that can be used for troubleshooting.

The following registry values are available to configure logging for the Catalog Services:

  • In the Windows registry, at HKLM\Software\RES\LoggingOptions:
    ValueTypeDataRemarks
    EnableREG_DWORD0 (default) or 1 If this value is not set to 1, the values below are ignored.
    This value affects logging for all components.
  • In the Windows registry, at HKLM\Software\RES\ITStore\Catalog Services, the following values are available:
    ValueTypeDataRemarks
    EnableFileLogsREG_DWORD0 (default) or 1 Enables logging to a trace file.
    FileLogLocationREG_SZ

    Example:
    C:\temp

    Full path to the location of the log file.
    • The IIS user must have access to the specified path.
    • If no path is specified, the trace file is saved to [installation folder]\App_Data\Logs.
    FileName

    REG_SZ

    Example:
    CatServ.log
    Name of the trace file. If no name is provided:
    • the file name starts with ITSCatSvc_Log_
    • a new trace file is created at every IIS (re)start, with a time stamp at the end of the file name
    LogFileDeleteExisting

    REG_DWORD

    0 (default) or 1If this value is set to 1, the old trace file is deleted after every IIS (re)start.
    FileLogThreshold

    REG_DWORD

    1 through 7

    Specifies the level of detail in the trace file. Possible values are:

    • 1 (debug)
    • 2 (info)
    • 3 (status)
    • 4 (warning)
    • 5 (error)
    • 6 (critical)
    • 7 (fatal)
    MaxLogFileSizeMB

    REG_DWORD

    Example:
    10
    Specifies the maximum size of the trace file in MB.
    • When the file reaches the maximum size, it overwrites the log from the start. Information that is overwritten, is lost.
    • If no maximum size is specified, the size of the file keeps increasing.

Restart the Catalog Services to apply the changes you made by creating or changing the registry values.


Was this article useful?