Contains the Verity configuration data (properties) for a server instance. This configuration data can differ from one server to the next. A VerityServerConfiguration object is contained in the SubsystemsConfiguration property of Domain, Site, VirtualServer, and ServerInstance objects. The VerityServerConfiguration object used is the first occurrence found by searching (in this order) the ServerInstance instance, the VirtualServer instance, the Site instance, and the Domain instance.

None of the properties on this object must be set or changed to enable full text indexing. This object is used only to address performance issues.


The following tables list the members exposed by IVerityServerConfiguration.

Public Properties

 NameDescription
Public propertyDispatcherEnabledA boolean value that controls the run enabled status of the dispatcher. When true, the dispatcher runs. When false, the dispatcher does not run.

For the ICFSImportAgentConfiguration interface, when the value of this property is true, the dispatcher runs, but the importer as a whole might still not process import requests when the import agent sub-component has not also been enabled. For more information, see the IsImportAgentEnabled property on the ICFSSiteSettings interface. For a discussion of the importer sub-components, see the ICFSImportAgentConfiguration interface.

Public propertyDispatcherWaitIntervalAttention: Do not change the value of this property without guidance from a support representative. Doing so might adversely affect system performance.

An interval, in seconds, between processing runs for the dispatcher; during this time, the dispatcher remains idle and waits for incoming work. The value specified by this property can represent differing wait intervals depending on the class on which the property occurs, as follows:

  • Except as noted below, represents a minimum wait interval, with a maximum wait interval defined by the LeaseDuration property.
  • For the ICFSImportAgentConfiguration interface, represents a maximum wait interval. (The minimum interval is always 1 second and cannot be changed).
  • For the IAsyncProcessingConfiguration interface, represents a fixed wait interval. (In effect, represents both the minimum and the maximum wait interval).

The interaction between the minimum and maximum intervals occurs in this manner: if in the previous processing run the dispatcher had work to perform, the duration of the subsequent wait interval that the dispatcher actually remains idle is the minimum interval; otherwise, if the dispatcher had no work to perform, the duration is the shorter of these two intervals: (a) Double the previous wait interval or (b) the maximum wait interval. As an example, assuming the minimum interval to be 35 seconds and the maximum as 120, the dispatcher remains idle for 35 seconds, detects no available work, remains idle for 70 seconds (double the previous wait interval), detects no available work, remains idle for 120 seconds (the maximum interval), detects no available work, remains idle for 120 seconds, detects incoming work and processes the work, remains idle for 35 seconds, and so on. Note that, when the minimal interval equals the maximum interval (as is always the case for the IAsyncProcessingConfiguration interface), this example can be simplified. If both the minimum and maximum interval is 35 seconds, the dispatcher remains idle for 35 seconds, detects no available work, remains idle for 35 seconds, detects incoming work and processes the work, remains idle for 35 seconds, and so on.

For the ICFSImportAgentConfiguration interface, this property, despite the name, applies to the importer sub-component known as the import agent and not to the import dispatcher; for information on the importer sub-components, see the ICFSImportAgentConfiguration interface.

Public propertyLeaseDurationAttention: Do not change the value of this property without guidance from a support representative. Doing so might adversely affect system performance.

The maximum interval, in seconds, allowed a worker to process a batch before the assignment of the batch to another worker. This interval ensures that any abnormal termination of the worker previously assigned to the batch does not prevent batch completion.

Public propertyMaxBatchSizeThe maximum number of objects that can be submitted in a single batch for indexing. Normally, the default value should be used.
Public propertyMaxObjectsPerCollectionThe maximum number of objects a Verity Collection can contain. Do not set this lower than the default unless testing collection overflow.
Public propertyOptimizationIntervalThe number of batches to index prior to performing an optimization on the indexing information. Setting the default value higher increases indexing throughput at the expense of search performance.
Public propertyThreadCountThe number of threads to use for background processing of index requests. This value should be set higher for machines with more CPUs, or for configurations that distribute processing across multiple Verity index servers.
Public propertyVerityBrokerNamesThe name of the Verity broker to use for the current VirtualServer instance. If unspecified, a broker of the name <server_name>_Broker is used.
Top

See Also