Registry Parameters

Virtual Servers and Catalogs
Event Log Flags
Language-Specific Registry Settings

The following registry parameters affect the operation of Microsoft Index Server. You can find them under the following path:

HKEY_LOCAL_MACHINE
\SYSTEM
 \CurrentControlSet
  \Control
   \contentindex

Caution   Editing the registry incorrectly can cause serious problems, including corruption that may make it necessary to reinstall Windows NT or Microsoft Index Server. Using the Registry Editor to edit entries in the registry is equivalent to editing raw sectors on a hard disk. If you make mistakes, your computer’s configuration could be damaged. You should edit registry entries only for settings that you cannot adjust through the user interface, and be very careful whenever you edit the registry directly.

DaemonResponseTimeout REG_DWORD

Units: Minutes Default: 5 Range: 1 - 120

Timeout value to determine if the CiDaemon process is looping because of a corrupted file.

EventLogFlags REG_DWORD

Units: BitField Default: 0x00000002 Range: 0- 7

Controls the generation of certain event log messages. See EventLogFlagMasks for mask definitions.

FilterContents REG_DWORD

Units: BOOLEAN Default: 1 Range: 0, 1

If set to 0, contents of files will not be filtered. Only properties will be filtered. When set to a nonzero value, contents and properties will be filtered.

FilterDirectories REG_DWORD

Units: BOOLEAN Default: 0 Range: 0, 1

When set to a nonzero value, directories will also be filtered for system properties and displayed in query results.

FilterFilesWithUnknownExtensions REG_DWORD

Units: BOOLEAN Default: 1 Range: 0, 1

Deteremines if files with extensions that have not been registered will be filtered or not. Set the value to zero if only registered file types should be filtered. To see how to register a file type, see Associating File Types with Exetensions on the “Filtering” page.

FilterRetries REG_DWORD

Units: Number Default: 4 Range: 1 - 10

The maximum number of times a file will be retried for filtering if there are failures while trying to filter a file.

FilterRetryInterval REG_DWORD

Units: Number Default: 30 seconds Range: 2 - 240

The number of seconds between attempts to filter the contents of a file that is being used by another process.

ForcedNetPathScanInterval REG_DWORD

Units: Minutes Default: 120 Range: 10 - infinite

Time interval between forced scans on directories with no notifications.

GenerateCharacterization REG_DWORD

Units: BOOLEAN Default: 1 Range: 0, 1

Controls automatic generation of characterization (abstract).

GrovelIISRegistry REG_DWORD

Units: BOOLEAN Default: 1 Range: 0, 1

Controls whether all virtual roots are automatically indexed or not.

IsapiDefaultCatalogDirectory REG_SZ

Default content index catalog directory, as it would be entered in the CiCatalog parameter of an .idq file.

IsapiMaxEntriesInQueryCache REG_DWORD

Default: 10 Range: 0 - 100

Maximum number of cached queries

IsapiMaxRecordsInResultSet REG_DWORD

Default: 5000 Range: - 1000000

Maximum total number of rows to fetch for a single query.

IsapiMaxRecordsPerGetRows REG_DWORD

Default: 50 Range: 10 - 1000

Maximum number of rows to fetch when getting data to display on an HTML page.

IsapiQueryCachePurgeInterval REG_DWORD

Units: Minutes Default: 5 Range: 1 - 120

Time interval a query cache item will remain alive.

IsapiRequestQueueSize REG_DWORD

Default: 16 Range: - 100000

Maximum number of Web query requests to queue when busy with other queries.

IsapiRequestThresholdFactor REG_DWORD

Default: 3 Range: 1 - 100000

Number of threads per processor beyond which query requests are queued.

IsapiVirtualServerCatalogs SUBKEY

Each key in this section associates a virtual server with a specific catalog. The key name is the IP address of the virtual server (NULL for the default server) and the value is the location of the catalog, as it would be entered in the CiCatalog parameter of an .idq file.

Language SUBKEY

Holds language-specific registry information.

MasterMergeCheckpointInterval REG_DWORD

Units: Kilobytes Default: 512 Range: 512 - 8096

Checkpointing interval for master merge. Determines how much work (data written to the new master index) to redo in case a master merge is paused and restarted.

MasterMergeTime REG_DWORD

Units: Minutes Default: 0 Range: 0 - 1439

Time at which master merge will occur. This is stored as the number of minutes after midnight.

MaxActiveQueryThreads REG_DWORD

Units: Threads Default: 2 Range: 1 - 1000

Maximum number of query threads. This establishes the maximum number of concurrently processed asynchronous queries.

MaxCharacterization REG_DWORD

Units: Characters Default: 320 Range: 20 - 500

Number of characters in the automatically generated characterization (abstract).

MaxFilesizeFiltered REG_DWORD

Units: Kilobytes Default: 256 Range: 0-infinite

Maximum size of a single file to be filtered using the default filter. If the default filter is used for a file bigger than this number, only properties will be filtered. Please note that this limit does not apply for registered file types.

MaxFilesizeMultiplier REG_DWORD

Units: Number Default: 8 Range: 4 - 0xFFFFFFFF

Maximum amount of data which can be generated from a single file, based on its size. This value is a multiplier. A value of 4 means that a file can generate up to 4 times its size in content index data.

MaxFreshCount REG_DWORD

Units: Documents Default: 5000 Range: 1000 - 40000

Maximum number of files whose latest indexed data is not in the master index. When this limit is reached, a master merge will be started.

MaxIdealIndexes REG_DWORD

Units: Indexes Default: 5 Range: 2 - 100

Maximum number of indices considered acceptable in a well-tuned system. When the number of indices climbs above this number and the system is idle then an annealing merge will take place to bring the total count of indices to this number.

MaxIndexes REG_DWORD

Units: Indexes Default: 50 Range: 10 - 150

Maximum number of persistent indexes in the catalog. If this number is exceeded, a shadow merge will be performed to bring the total below this number.

MaxMergeInterval REG_DWORD

Units: Minutes Default: 10 Range: 1 - 60

Sleep time between merges. Index Server activates this often to determine if a merge is necessary. Usually an annealing merge, but may be a shadow or master merge.

MaxPendingDocuments REG_DWORD

Units: Documents Default: 32 Range: 1 - 50000

The number of pending documents to be filtered before considering CI out-of-date for property queries.

MaxQueryExecutionTime REG_DWORD

Units: Milliseconds of CPU time Default: 10000 Range: 50 - infinite

Maximum execution time of a query. If a query takes more than this amount of CPU time, processing of it will be stopped and an error status indicated.

MaxQueryTimeslice REG_DWORD

Units: Milliseconds of CPU time Default: 50 Range: 1 - 1000

Maximum amount of time to execute a query in a single time slice. If more asynchronous queries are active than allowed query threads, then a query is put back on the pending queue after this time interval. Time slicing is done only after a matching row is found, but for some queries, many rows may be examined before a match is found. When many rows are examined, the time slice may be exceeded before the time is checked.

MaxQueueChunks REG_DWORD

Units: Number of chunks Default: 20 Range: 10 - 30

Maximum number of in memory buffers for keeping track of pending documents. The higher the number, the less frequently does it have to be written to disk.

MaxRestrictionNodes REG_DWORD

Units: Number of nodes Default: 250 Range: 1-4 billion

If query nomalization creates a query restriction greater than the number of nodes set in this registry entry, the query fails with the status of QUERY_E_TOOCOMPLEX. This status message means the query was too complex to be completed because the limit imposed in this registry key has been reached. This key keeps a user from overloading the server’s capacity with an overly large query.

MaxShadowFreeForceMerge REG_DWORD

Units: Percentage of disk space Default: 15 Range: 5 - 25

On the catalog drive, if the free space falls below MinDiskFreeForceMerge and the disk space occupied by the shadow indexes exceeds MaxShadowFreeForceMerge, a master merge is started.

MaxShadowIndexSize REG_DWORD

Units: Percentage of disk space Default: 20 Range: 5 - infinite

If the disk space occupied by the shadow indexes exceed this percentage of the catalog drive, a master merge is started.

MaxWordLists REG_DWORD

Units: WordLists Default: 20 Range: 10 - 30

Maximum number of word lists that can exist at one time.

MaxWordlistSize REG_DWORD

Units: 128K Default: 14 Range: 10 - infinite

Maximum amount of memory consumed by an individual word list. When this limit is reached, only the document being filtered will be added. Additional documents will be refiled and later placed in another word list. Each unit is 128 kilobytes (K) (for example, 20 = 2.5 megabytes).

MinDiskFreeForceMerge REG_DWORD

Units: Percentage of disk space Default: 15 Range: 5 - 25

On the catalog drive, if the free space falls below MinDiskFreeForceMerge and the disk space occupied by the shadow indexes exceeds MaxShadowFreeForceMerge, a master merge is started.

MinIdleQueryThreads REG_DWORD

Default: 1 Range: 0 - 1000

Minimum number of idle threads kept alive to process incoming queries.

MinMergeIdleTime REG_DWORD

Units: Percentage of CPU Default: 90 Range: 10 - 100

If average system idle time for the last merge check period is greater than this value, then an annealing merge can be performed.

MinSizeMergeWordlists REG_DWORD

Units: Kilobytes Default: 1024 Range: 1024 - 10240

Minimum combined size of word lists that will force a shadow merge.

MinWordlistMemory REG_DWORD

Units: Megabytes Default: 5 Range: 1 - 10

Minimum free memory for word list creation.

PropertyStoreMappedCache REG_DWORD

Units: 64K pages Default: 16 Range: 0 - infinite

Maximum size of in memory buffers for Property Cache.

ThreadClassFilter REG_DWORD

Default: Idle Priority Class Range: 20, 40, 80, 100

Priority class of the CiDaemon process. The value 20 is Normal Priority Class, 40 is Idle Priority Class, 80 is High Priority Class, and 100 is Realtime Priority Class.

ThreadPriorityFilter REG_DWORD

Default: Above normal Range: Lowest -Above Normal

Priority of the filtering thread within the CiDaemon process.

ThreadPriorityMerge REG_DWORD

Default: Normal Range: Lowest -Above Normal

Priority of the merge thread.

Virtual Servers and Catalogs

HKEY_LOCAL_MACHINE
\SYSTEM
 \CurrentControlSet
  \Control
   \contentindex
    \IsapiVirtualServerCatalogs

Each key in this section associates a virtual server with a specific catalog. The key name is the IP address of the virtual server (NULL for the default server).

Event Log Flags

Generation of some of the Windows NT event log messages can be controlled by the EventLogFlags value. To enable the generation of a specific event, the fields controlling that event must be turned on (set to 1). The bit-field mask and the event log messages they control are given below.

Language-Specific Registry Settings

Language-specific registry settings control the selection of word breaker, stemmer and noise word list for a given language. They also select the error pages returned in response to invalid user and administrator actions.

Language-specific registry settings are all stored in the following path:

HKEY_LOCAL_MACHINE
\SYSTEM 
 \CurrentControlSet 
  \Control 
   \contentindex
    \Language
     \language

The InstalledLangs value lists the set of languages installed. Each string in the Installedlangs value names a subkey below the Language key. Beneath each Language key, the following values are recognized.

ISAPIDefaultErrorFile

Full virtual path to the generic error template. This .htx template is processed when none of the specific error pages applies. The variables CiRestriction, CiErrorMessage, and CiErrorNumber can all be referenced.

 

ISAPIHTXErrorFile

Full virtual path to the error page returned in response to errors in the .htx file. The variables CiRestriction, CiErrorMessage, and CiErrorNumber can all be referenced.

 

ISAPIIDQErrorFile

Full virtual path to the error page returned in response to errors in the .idq file. The variables CiRestriction, CiErrorMessage, and CiErrorNumber can all be referenced.

 

ISAPIRestrictionErrorFile

Full virtual path to the error page returned in response to errors in the query restriction (CiRestriction). This is the error page which will be seen most often by users. The variables CiRestriction, CiErrorMessage, and CiErrorNumber can all be referenced.

 

Locale

Associates the registry section with a specific locale.

 

NoiseFile

File name of noise word list for this locale. The file must be located in the %SystemRoot%\System32 directory.

 

StemmerClass

ActiveX class ID of class used for locale-specific stemming.

 

WBreakerClass

ActiveX class ID of class used to split phrases for this locale.

 

© 1996 by Microsoft Corporation. All rights reserved.