The Default Catalog
Moving and Removing a Catalog
A catalog is the highest-level unit of organization in Microsoft Index Server. Each catalog is a completely self-contained unit, containing an index and cached properties for one or more scopes (virtual roots). In this version of Index Server, queries cannot span multiple catalogs.
The initial catalog location is determined during setup and stored in the IsapiDefaultCatalogDirectory registry entry. If the CiCatalog parameter is not specified in an .idq file, then this default catalog is used. Intially, the default catalog contains an index of all virtual roots with read access, but the scope of the catalog can be modified through administrative pages.
There are two reasons to create more than one catalog: to distribute queries, and to support virtual servers. Because it is impossible to create a query that spans more than one catalog, careful consideration of the consequences must be made before creating multiple catalogs. The ability to query everything is lost. Use of default catalog support is also impaired: no support for multiple IP address-specific default catalogs is provided.
Physically dividing the set of virtual roots between a number of catalogs will improve query performance, but only if most queries are restricted to a subscope (one or more virtual roots) of the Web site. This improvement occurs because the number of false hits (hits outside the query scope) will be reduced.
For example, if you put the catalog in D:\Vdom2\Catalog.wci, the CiCatalog is set to D:\Vdom2. The CiCatalog specification should not include the Catalog.wci directory itself. The initial query against the catalog will start the indexing process. You may want to modify the set of virtual roots covered by the new catalog.
By default, a catalog is not associated with a specific virtual server, and only virtual roots without a specific IP address are added to the catalog. To associate a catalog with a specific virtual server, add an entry under the IsapiVirtualServerCatalogs subkey. The name of the value is the IP address of the virtual server, and the value is the catalog location. For example, a catalog located in the root of drive G: that contains virtual roots accessible only from IP address 22.214.171.124 would look like: ...\CurrentControlSet\Control\ContentIndex\IsapiVirtualServerCatalogs\126.96.36.199 = G:\. After making this registry change, stop and restart Internet Information Server. Then, issue a query against the catalog for 188.8.131.52.
The previous procedure will add virtual roots (specific to the indicated virtual server) to the set of scopes covered by the new catalog. All virtual roots without a specific IP address will be available as well. Note that by default, common roots are indexed in all catalogs. Also, be sure to update the .idq and .ida files if you have changed them.
The following example shows how to set up multiple catalogs for a configuration containing multiple virtual servers.
In the following example, assume that you want to set up multiple catalogs for the following scenario:
The IP address of the virtual server is 184.108.40.206.
The following virtual roots are set up for 220.127.116.11
|Virtual Root||Physical Path||Permissions|
Microsoft Index Server data will be put in the directory D:\Vserver2_index. Better performance can be achieved by having Microsoft Index Server data on a different drive than the drive that contains the corpus, but for illustration purposes this example puts it in the same drive.
Sample files installed by Microsoft Index Server will be copied and modified to work with the virtual server 18.104.22.168.
Create a directory D:\Vserver2_index\Catalog.wci . If D: is a Windows NT File System (NTFS) drive, set an ACL on it giving full access to SYSTEM and Administrators accounts only. For the highest security, Microsoft recommends installing Index Server data on an NTFS drive.
Add an entry in the registry under the key
Note that key value does not include the directory Catalog.wci.
Copy all the query forms(.htm) files from the default installation to D:\Vserver2\Root\Samples\Search. (Create the directory hierarchy if necessary.)
Copy all the query script and administration files (.idq , .ida, and .htx) files from the default installation to D:\Vserver2\Scripts\Samples\Search. (Create the directory hierarchy if necessary.)
Modify the CiCatalog variable specification in all the .idq and .ida files in D:\Vserver2\Scripts\Samples\Search to point
to D:\Vserver2_index. Make sure it does not have any comments in it. (It should look like
CiCatalog=d:\vserver2_index. Again note that catalog.wci is not included in the specification).
Modify the CiTemplate parameter in the .idq and .ida files to point to /Scripts1/samples/search. Note the change from Scripts to Scripts1 for the virtual root.
Modify the .htm files in D:\Vserver2\Root\Samples\Search to point to the appropriate .idq/.ida files. You may have to change the path from /Scripts/Samples/Search to /Scripts1/Samples/Search.
Issue a query by connecting to http://22.214.171.124/samples/search/query.htm. This will start indexing for the virtual server 126.96.36.199
You can of course customize the query forms to restrict access to specific scopes. You may also have to modify the administration forms separately.
It is safe to move a Catalog.wci directory to a new location. Similarly, to delete a catalog you need only delete the Catalog.wci directory. It is a good idea to update the relevant registry entries (IsapiDefaultCatalogDirectory and IsapiVirtualServerCatalogs) as well. Internet Information Server or Peer Web Services must be stopped before you remove or move catalogs. It is recommended that you review all your .idq files to make sure there are no references to nonexistent catalogs.
The catalog is physically stored in a user-specified location. A directory named Catalog.wci is created there. Index server creates a number of files in this directory, including:
|000nnnn.prp||Holds cached properties. The name is the version of the property cache. Each modification to the property-cache schema increments this number by one.|
|0001nnnn.ci||Shadow and master indexes. Each index has a unique number nnnn.|
|0001nnnn.dir||Directory used to quickly search the similarly named shadow index or master index.|
|cicat.hsh||Quickly converts a path into an internal identifier used throughout the index.|
|CiCL0001.*||Contains a log of files that need to be filtered.|
|CiFLnnnn.*||Maps documents to the most recent index for a given document.|
|CiPS0000.*||Describes the record format of the property cache.|
|CiPT0000.*||Maps ActiveX property descriptors to internal identifier.|
|CiSL0001.*||Contains a log of in-use files that need to be filtered.|
|CiSP0000.*||Contains a list of physical scopes covered by this index.|
|CiST0000.*||Maps security Access Control Lists (ACLs) to internal identifier.|
|CiVP0000.*||Contains a mapping between physical and virtual paths.|
|Index.*||Master list of indices.|
The Catalog.wci directory, and everything under it, will not be indexed by Index Server even if it is accessible through a virtual root of the Web site.
© 1996 by Microsoft Corporation. All rights reserved.