Space  Contents Previous Next


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.

To TopVirtual 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).

NULL REG_SZ
Default: root
Range: pathname
The value is the location of the catalog, as it would be entered in the CiCatalog parameter of an .idq file.

To TopEvent 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.

Mask Value Controlled Event
0x00000001 Class for extension extension unknown. Sample file: file. See Error Messages for details.
0x00000002One or more embeddings in file file could not be filtered. See Error Messages for details.
0x00000004The content index could not filter file file. The filter operation was retried number times without success. See Error Messages for details.

To TopLanguage-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.
 

 Contents Previous To Top Next


© 1996 by Microsoft Corporation. All rights reserved.