conf/solrconfig-devl.xml

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!--
   3  Licensed to the Apache Software Foundation (ASF) under one or more
   4  contributor license agreements.  See the NOTICE file distributed with
   5  this work for additional information regarding copyright ownership.
   6  The ASF licenses this file to You under the Apache License, Version 2.0
   7  (the "License"); you may not use this file except in compliance with
   8  the License.  You may obtain a copy of the License at
   9
  10      http://www.apache.org/licenses/LICENSE-2.0
  11
  12  Unless required by applicable law or agreed to in writing, software
  13  distributed under the License is distributed on an "AS IS" BASIS,
  14  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  See the License for the specific language governing permissions and
  16  limitations under the License.
  17 -->
  18
  19 <!--
  20      For more details about configurations options that may appear in
  21      this file, see http://wiki.apache.org/solr/SolrConfigXml.
  22 -->
  23 <config>
  24   <!-- In all configuration below, a prefix of "solr." for class names
  25        is an alias that causes solr to search appropriate packages,
  26        including org.apache.solr.(search|update|request|core|analysis)
  27
  28        You may also specify a fully qualified Java classname if you
  29        have your own custom plugins.
  30     -->
  31
  32   <!-- Controls what version of Lucene various components of Solr
  33        adhere to.  Generally, you want to use the latest version to
  34        get all bug fixes and improvements. It is highly recommended
  35        that you fully re-index after changing this setting as it can
  36        affect both how text is indexed and queried.
  37   -->
  38   <luceneMatchVersion>4.4</luceneMatchVersion>
  39
  40   <!-- <lib/> directives can be used to instruct Solr to load an Jars
  41        identified and use them to resolve any "plugins" specified in
  42        your solrconfig.xml or schema.xml (ie: Analyzers, Request
  43        Handlers, etc...).
  44
  45        All directories and paths are resolved relative to the
  46        instanceDir.
  47
  48        Please note that <lib/> directives are processed in the order
  49        that they appear in your solrconfig.xml file, and are "stacked"
  50        on top of each other when building a ClassLoader - so if you have
  51        plugin jars with dependencies on other jars, the "lower level"
  52        dependency jars should be loaded first.
  53
  54        If a "./lib" directory exists in your instanceDir, all files
  55        found in it are included as if you had used the following
  56        syntax...
  57
  58               <lib dir="./lib" />
  59     -->
  60
  61   <!-- A 'dir' option by itself adds any files found in the directory
  62        to the classpath, this is useful for including all jars in a
  63        directory.
  64
  65        When a 'regex' is specified in addition to a 'dir', only the
  66        files in that directory which completely match the regex
  67        (anchored on both ends) will be included.
  68
  69        If a 'dir' option (with or without a regex) is used and nothing
  70        is found that matches, a warning will be logged.
  71
  72        The examples below can be used to load some solr-contribs along
  73        with their external dependencies.
  74     -->
  75   <lib dir="../../../contrib/extraction/lib" regex=".*\.jar" />
  76   <lib dir="../../../dist/" regex="solr-cell-\d.*\.jar" />
  77
  78   <lib dir="../../../contrib/clustering/lib/" regex=".*\.jar" />
  79   <lib dir="../../../dist/" regex="solr-clustering-\d.*\.jar" />
  80
  81   <lib dir="../../../contrib/langid/lib/" regex=".*\.jar" />
  82   <lib dir="../../../dist/" regex="solr-langid-\d.*\.jar" />
  83
  84   <lib dir="../../../contrib/velocity/lib" regex=".*\.jar" />
  85   <lib dir="../../../dist/" regex="solr-velocity-\d.*\.jar" />
  86
  87   <!-- an exact 'path' can be used instead of a 'dir' to specify a
  88        specific jar file.  This will cause a serious error to be logged
  89        if it can't be loaded.
  90     -->
  91   <!--
  92      <lib path="../a-jar-that-does-not-exist.jar" />
  93   -->
  94
  95   <!-- Data Directory
  96
  97        Used to specify an alternate directory to hold all index data
  98        other than the default ./data under the Solr home.  If
  99        replication is in use, this should match the replication
 100        configuration.
 101     -->
 102   <dataDir>${solr.data.dir:lui-solr4/collection1/data}</dataDir>
 103
 104
 105   <!-- The DirectoryFactory to use for indexes.
 106
 107        solr.StandardDirectoryFactory is filesystem
 108        based and tries to pick the best implementation for the current
 109        JVM and platform.  solr.NRTCachingDirectoryFactory, the default,
 110        wraps solr.StandardDirectoryFactory and caches small files in memory
 111        for better NRT performance.
 112
 113        One can force a particular implementation via solr.MMapDirectoryFactory,
 114        solr.NIOFSDirectoryFactory, or solr.SimpleFSDirectoryFactory.
 115
 116        solr.RAMDirectoryFactory is memory based, not
 117        persistent, and doesn't work with replication.
 118     -->
 119   <directoryFactory name="DirectoryFactory"
 120                     class="${solr.directoryFactory:solr.NRTCachingDirectoryFactory}"/>
 121
 122   <!-- The CodecFactory for defining the format of the inverted index.
 123        The default implementation is SchemaCodecFactory, which is the official Lucene
 124        index format, but hooks into the schema to provide per-field customization of
 125        the postings lists and per-document values in the fieldType element
 126        (postingsFormat/docValuesFormat). Note that most of the alternative implementations
 127        are experimental, so if you choose to customize the index format, its a good
 128        idea to convert back to the official format e.g. via IndexWriter.addIndexes(IndexReader)
 129        before upgrading to a newer version to avoid unnecessary reindexing.
 130   -->
 131   <codecFactory class="solr.SchemaCodecFactory"/>
 132
 133   <!-- To enable dynamic schema REST APIs, use the following for <schemaFactory>:
 134
 135        <schemaFactory class="ManagedIndexSchemaFactory">
 136          <bool name="mutable">true</bool>
 137          <str name="managedSchemaResourceName">managed-schema</str>
 138        </schemaFactory>
 139
 140        When ManagedIndexSchemaFactory is specified, Solr will load the schema from
 141        he resource named in 'managedSchemaResourceName', rather than from schema.xml.
 142        Note that the managed schema resource CANNOT be named schema.xml.  If the managed
 143        schema does not exist, Solr will create it after reading schema.xml, then rename
 144        'schema.xml' to 'schema.xml.bak'.
 145
 146        Do NOT hand edit the managed schema - external modifications will be ignored and
 147        overwritten as a result of schema modification REST API calls.
 148
 149        When ManagedIndexSchemaFactory is specified with mutable = true, schema
 150        modification REST API calls will be allowed; otherwise, error responses will be
 151        sent back for these requests.
 152   -->
 153   <schemaFactory class="ClassicIndexSchemaFactory"/>
 154
 155   <!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 156        Index Config - These settings control low-level behavior of indexing
 157        Most example settings here show the default value, but are commented
 158        out, to more easily see where customizations have been made.
 159
 160        Note: This replaces <indexDefaults> and <mainIndex> from older versions
 161        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
 162   <indexConfig>
 163     <!-- maxFieldLength was removed in 4.0. To get similar behavior, include a
 164          LimitTokenCountFilterFactory in your fieldType definition. E.g.
 165      <filter class="solr.LimitTokenCountFilterFactory" maxTokenCount="10000"/>
 166     -->
 167     <!-- Maximum time to wait for a write lock (ms) for an IndexWriter. Default: 1000 -->
 168     <!-- <writeLockTimeout>1000</writeLockTimeout>  -->
 169
 170     <!-- The maximum number of simultaneous threads that may be
 171          indexing documents at once in IndexWriter; if more than this
 172          many threads arrive they will wait for others to finish.
 173          Default in Solr/Lucene is 8. -->
 174     <!-- <maxIndexingThreads>8</maxIndexingThreads>  -->
 175
 176     <!-- Expert: Enabling compound file will use less files for the index,
 177          using fewer file descriptors on the expense of performance decrease.
 178          Default in Lucene is "true". Default in Solr is "false" (since 3.6) -->
 179     <!-- <useCompoundFile>false</useCompoundFile> -->
 180
 181     <!-- ramBufferSizeMB sets the amount of RAM that may be used by Lucene
 182          indexing for buffering added documents and deletions before they are
 183          flushed to the Directory.
 184          maxBufferedDocs sets a limit on the number of documents buffered
 185          before flushing.
 186          If both ramBufferSizeMB and maxBufferedDocs is set, then
 187          Lucene will flush based on whichever limit is hit first.
 188          The default is 100 MB.  -->
 189     <!-- <ramBufferSizeMB>100</ramBufferSizeMB> -->
 190     <!-- <maxBufferedDocs>1000</maxBufferedDocs> -->
 191
 192     <!-- Expert: Merge Policy
 193          The Merge Policy in Lucene controls how merging of segments is done.
 194          The default since Solr/Lucene 3.3 is TieredMergePolicy.
 195          The default since Lucene 2.3 was the LogByteSizeMergePolicy,
 196          Even older versions of Lucene used LogDocMergePolicy.
 197       -->
 198     <!--
 199         <mergePolicy class="org.apache.lucene.index.TieredMergePolicy">
 200           <int name="maxMergeAtOnce">10</int>
 201           <int name="segmentsPerTier">10</int>
 202         </mergePolicy>
 203       -->
 204
 205     <!-- Merge Factor
 206          The merge factor controls how many segments will get merged at a time.
 207          For TieredMergePolicy, mergeFactor is a convenience parameter which
 208          will set both MaxMergeAtOnce and SegmentsPerTier at once.
 209          For LogByteSizeMergePolicy, mergeFactor decides how many new segments
 210          will be allowed before they are merged into one.
 211          Default is 10 for both merge policies.
 212       -->
 213     <!--
 214     <mergeFactor>10</mergeFactor>
 215       -->
 216
 217     <!-- Expert: Merge Scheduler
 218          The Merge Scheduler in Lucene controls how merges are
 219          performed.  The ConcurrentMergeScheduler (Lucene 2.3 default)
 220          can perform merges in the background using separate threads.
 221          The SerialMergeScheduler (Lucene 2.2 default) does not.
 222      -->
 223     <!--
 224        <mergeScheduler class="org.apache.lucene.index.ConcurrentMergeScheduler"/>
 225        -->
 226
 227     <!-- LockFactory
 228
 229          This option specifies which Lucene LockFactory implementation
 230          to use.
 231
 232          single = SingleInstanceLockFactory - suggested for a
 233                   read-only index or when there is no possibility of
 234                   another process trying to modify the index.
 235          native = NativeFSLockFactory - uses OS native file locking.
 236                   Do not use when multiple solr webapps in the same
 237                   JVM are attempting to share a single index.
 238          simple = SimpleFSLockFactory  - uses a plain file for locking
 239
 240          Defaults: 'native' is default for Solr3.6 and later, otherwise
 241                    'simple' is the default
 242
 243          More details on the nuances of each LockFactory...
 244          http://wiki.apache.org/lucene-java/AvailableLockFactories
 245     -->
 246     <lockType>${solr.lock.type:native}</lockType>
 247
 248     <!-- Unlock On Startup
 249
 250          If true, unlock any held write or commit locks on startup.
 251          This defeats the locking mechanism that allows multiple
 252          processes to safely access a lucene index, and should be used
 253          with care. Default is "false".
 254
 255          This is not needed if lock type is 'single'
 256      -->
 257     <!--
 258     <unlockOnStartup>false</unlockOnStartup>
 259       -->
 260
 261     <!-- Expert: Controls how often Lucene loads terms into memory
 262          Default is 128 and is likely good for most everyone.
 263       -->
 264     <!-- <termIndexInterval>128</termIndexInterval> -->
 265
 266     <!-- If true, IndexReaders will be reopened (often more efficient)
 267          instead of closed and then opened. Default: true
 268       -->
 269     <!--
 270     <reopenReaders>true</reopenReaders>
 271       -->
 272
 273     <!-- Commit Deletion Policy
 274          Custom deletion policies can be specified here. The class must
 275          implement org.apache.lucene.index.IndexDeletionPolicy.
 276
 277          The default Solr IndexDeletionPolicy implementation supports
 278          deleting index commit points on number of commits, age of
 279          commit point and optimized status.
 280
 281          The latest commit point should always be preserved regardless
 282          of the criteria.
 283     -->
 284     <!--
 285     <deletionPolicy class="solr.SolrDeletionPolicy">
 286     -->
 287       <!-- The number of commit points to be kept -->
 288       <!-- <str name="maxCommitsToKeep">1</str> -->
 289       <!-- The number of optimized commit points to be kept -->
 290       <!-- <str name="maxOptimizedCommitsToKeep">0</str> -->
 291       <!--
 292           Delete all commit points once they have reached the given age.
 293           Supports DateMathParser syntax e.g.
 294         -->
 295       <!--
 296          <str name="maxCommitAge">30MINUTES</str>
 297          <str name="maxCommitAge">1DAY</str>
 298       -->
 299     <!--
 300     </deletionPolicy>
 301     -->
 302
 303     <!-- Lucene Infostream
 304
 305          To aid in advanced debugging, Lucene provides an "InfoStream"
 306          of detailed information when indexing.
 307
 308          Setting the value to true will instruct the underlying Lucene
 309          IndexWriter to write its info stream to solr's log. By default,
 310          this is enabled here, and controlled through log4j.properties.
 311       -->
 312      <infoStream>true</infoStream>
 313   </indexConfig>
 314
 315
 316   <!-- JMX
 317
 318        This example enables JMX if and only if an existing MBeanServer
 319        is found, use this if you want to configure JMX through JVM
 320        parameters. Remove this to disable exposing Solr configuration
 321        and statistics to JMX.
 322
 323        For more details see http://wiki.apache.org/solr/SolrJmx
 324     -->
 325   <jmx />
 326   <!-- If you want to connect to a particular server, specify the
 327        agentId
 328     -->
 329   <!-- <jmx agentId="myAgent" /> -->
 330   <!-- If you want to start a new MBeanServer, specify the serviceUrl -->
 331   <!-- <jmx serviceUrl="service:jmx:rmi:///jndi/rmi://localhost:9999/solr"/>
 332     -->
 333
 334   <!-- The default high-performance update handler -->
 335   <updateHandler class="solr.DirectUpdateHandler2">
 336
 337     <!-- Enables a transaction log, used for real-time get, durability, and
 338          and solr cloud replica recovery.  The log can grow as big as
 339          uncommitted changes to the index, so use of a hard autoCommit
 340          is recommended (see below).
 341          "dir" - the target directory for transaction logs, defaults to the
 342                 solr data directory.  -->
 343     <updateLog>
 344       <str name="dir">${solr.ulog.dir:}</str>
 345     </updateLog>
 346
 347     <!-- AutoCommit
 348
 349          Perform a hard commit automatically under certain conditions.
 350          Instead of enabling autoCommit, consider using "commitWithin"
 351          when adding documents.
 352
 353          http://wiki.apache.org/solr/UpdateXmlMessages
 354
 355          maxDocs - Maximum number of documents to add since the last
 356                    commit before automatically triggering a new commit.
 357
 358          maxTime - Maximum amount of time in ms that is allowed to pass
 359                    since a document was added before automatically
 360                    triggering a new commit.
 361          openSearcher - if false, the commit causes recent index changes
 362            to be flushed to stable storage, but does not cause a new
 363            searcher to be opened to make those changes visible.
 364
 365          If the updateLog is enabled, then it's highly recommended to
 366          have some sort of hard autoCommit to limit the log size.
 367       -->
 368      <autoCommit>
 369        <maxTime>${solr.autoCommit.maxTime:15000}</maxTime>
 370        <openSearcher>false</openSearcher>
 371      </autoCommit>
 372
 373     <!-- softAutoCommit is like autoCommit except it causes a
 374          'soft' commit which only ensures that changes are visible
 375          but does not ensure that data is synced to disk.  This is
 376          faster and more near-realtime friendly than a hard commit.
 377       -->
 378
 379      <autoSoftCommit>
 380        <maxTime>${solr.autoSoftCommit.maxTime:-1}</maxTime>
 381      </autoSoftCommit>
 382
 383     <!-- Update Related Event Listeners
 384
 385          Various IndexWriter related events can trigger Listeners to
 386          take actions.
 387
 388          postCommit - fired after every commit or optimize command
 389          postOptimize - fired after every optimize command
 390       -->
 391     <!-- The RunExecutableListener executes an external command from a
 392          hook such as postCommit or postOptimize.
 393
 394          exe - the name of the executable to run
 395          dir - dir to use as the current working directory. (default=".")
 396          wait - the calling thread waits until the executable returns.
 397                 (default="true")
 398          args - the arguments to pass to the program.  (default is none)
 399          env - environment variables to set.  (default is none)
 400       -->
 401     <!-- This example shows how RunExecutableListener could be used
 402          with the script based replication...
 403          http://wiki.apache.org/solr/CollectionDistribution
 404       -->
 405     <!--
 406        <listener event="postCommit" class="solr.RunExecutableListener">
 407          <str name="exe">solr/bin/snapshooter</str>
 408          <str name="dir">.</str>
 409          <bool name="wait">true</bool>
 410          <arr name="args"> <str>arg1</str> <str>arg2</str> </arr>
 411          <arr name="env"> <str>MYVAR=val1</str> </arr>
 412        </listener>
 413       -->
 414
 415   </updateHandler>
 416
 417   <!-- IndexReaderFactory
 418
 419        Use the following format to specify a custom IndexReaderFactory,
 420        which allows for alternate IndexReader implementations.
 421
 422        ** Experimental Feature **
 423
 424        Please note - Using a custom IndexReaderFactory may prevent
 425        certain other features from working. The API to
 426        IndexReaderFactory may change without warning or may even be
 427        removed from future releases if the problems cannot be
 428        resolved.
 429
 430
 431        ** Features that may not work with custom IndexReaderFactory **
 432
 433        The ReplicationHandler assumes a disk-resident index. Using a
 434        custom IndexReader implementation may cause incompatibility
 435        with ReplicationHandler and may cause replication to not work
 436        correctly. See SOLR-1366 for details.
 437
 438     -->
 439   <!--
 440   <indexReaderFactory name="IndexReaderFactory" class="package.class">
 441     <str name="someArg">Some Value</str>
 442   </indexReaderFactory >
 443   -->
 444   <!-- By explicitly declaring the Factory, the termIndexDivisor can
 445        be specified.
 446     -->
 447   <!--
 448      <indexReaderFactory name="IndexReaderFactory"
 449                          class="solr.StandardIndexReaderFactory">
 450        <int name="setTermIndexDivisor">12</int>
 451      </indexReaderFactory >
 452     -->
 453
 454   <!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 455        Query section - these settings control query time things like caches
 456        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
 457   <query>
 458     <!-- Max Boolean Clauses
 459
 460          Maximum number of clauses in each BooleanQuery,  an exception
 461          is thrown if exceeded.
 462
 463          ** WARNING **
 464
 465          This option actually modifies a global Lucene property that
 466          will affect all SolrCores.  If multiple solrconfig.xml files
 467          disagree on this property, the value at any given moment will
 468          be based on the last SolrCore to be initialized.
 469
 470       -->
 471     <maxBooleanClauses>1024</maxBooleanClauses>
 472
 473
 474     <!-- Solr Internal Query Caches
 475
 476          There are two implementations of cache available for Solr,
 477          LRUCache, based on a synchronized LinkedHashMap, and
 478          FastLRUCache, based on a ConcurrentHashMap.
 479
 480          FastLRUCache has faster gets and slower puts in single
 481          threaded operation and thus is generally faster than LRUCache
 482          when the hit ratio of the cache is high (> 75%), and may be
 483          faster under other scenarios on multi-cpu systems.
 484     -->
 485
 486     <!-- Filter Cache
 487
 488          Cache used by SolrIndexSearcher for filters (DocSets),
 489          unordered sets of *all* documents that match a query.  When a
 490          new searcher is opened, its caches may be prepopulated or
 491          "autowarmed" using data from caches in the old searcher.
 492          autowarmCount is the number of items to prepopulate.  For
 493          LRUCache, the autowarmed items will be the most recently
 494          accessed items.
 495
 496          Parameters:
 497            class - the SolrCache implementation LRUCache or
 498                (LRUCache or FastLRUCache)
 499            size - the maximum number of entries in the cache
 500            initialSize - the initial capacity (number of entries) of
 501                the cache.  (see java.util.HashMap)
 502            autowarmCount - the number of entries to prepopulate from
 503                and old cache.
 504       -->
 505     <filterCache class="solr.FastLRUCache"
 506                  size="512"
 507                  initialSize="512"
 508                  autowarmCount="0"/>
 509
 510     <!-- Query Result Cache
 511
 512          Caches results of searches - ordered lists of document ids
 513          (DocList) based on a query, a sort, and the range of documents requested.
 514       -->
 515     <queryResultCache class="solr.LRUCache"
 516                      size="512"
 517                      initialSize="512"
 518                      autowarmCount="0"/>
 519
 520     <!-- Document Cache
 521
 522          Caches Lucene Document objects (the stored fields for each
 523          document).  Since Lucene internal document ids are transient,
 524          this cache will not be autowarmed.
 525       -->
 526     <documentCache class="solr.LRUCache"
 527                    size="512"
 528                    initialSize="512"
 529                    autowarmCount="0"/>
 530
 531     <!-- Field Value Cache
 532
 533          Cache used to hold field values that are quickly accessible
 534          by document id.  The fieldValueCache is created by default
 535          even if not configured here.
 536       -->
 537     <!--
 538        <fieldValueCache class="solr.FastLRUCache"
 539                         size="512"
 540                         autowarmCount="128"
 541                         showItems="32" />
 542       -->
 543
 544     <!-- Custom Cache
 545
 546          Example of a generic cache.  These caches may be accessed by
 547          name through SolrIndexSearcher.getCache(),cacheLookup(), and
 548          cacheInsert().  The purpose is to enable easy caching of
 549          user/application level data.  The regenerator argument should
 550          be specified as an implementation of solr.CacheRegenerator
 551          if autowarming is desired.
 552       -->
 553     <!--
 554        <cache name="myUserCache"
 555               class="solr.LRUCache"
 556               size="4096"
 557               initialSize="1024"
 558               autowarmCount="1024"
 559               regenerator="com.mycompany.MyRegenerator"
 560               />
 561       -->
 562
 563
 564     <!-- Lazy Field Loading
 565
 566          If true, stored fields that are not requested will be loaded
 567          lazily.  This can result in a significant speed improvement
 568          if the usual case is to not load all stored fields,
 569          especially if the skipped fields are large compressed text
 570          fields.
 571     -->
 572     <enableLazyFieldLoading>true</enableLazyFieldLoading>
 573
 574    <!-- Use Filter For Sorted Query
 575
 576         A possible optimization that attempts to use a filter to
 577         satisfy a search.  If the requested sort does not include
 578         score, then the filterCache will be checked for a filter
 579         matching the query. If found, the filter will be used as the
 580         source of document ids, and then the sort will be applied to
 581         that.
 582
 583         For most situations, this will not be useful unless you
 584         frequently get the same search repeatedly with different sort
 585         options, and none of them ever use "score"
 586      -->
 587    <!--
 588       <useFilterForSortedQuery>true</useFilterForSortedQuery>
 589      -->
 590
 591    <!-- Result Window Size
 592
 593         An optimization for use with the queryResultCache.  When a search
 594         is requested, a superset of the requested number of document ids
 595         are collected.  For example, if a search for a particular query
 596         requests matching documents 10 through 19, and queryWindowSize is 50,
 597         then documents 0 through 49 will be collected and cached.  Any further
 598         requests in that range can be satisfied via the cache.
 599      -->
 600    <queryResultWindowSize>20</queryResultWindowSize>
 601
 602    <!-- Maximum number of documents to cache for any entry in the
 603         queryResultCache.
 604      -->
 605    <queryResultMaxDocsCached>200</queryResultMaxDocsCached>
 606
 607    <!-- Query Related Event Listeners
 608
 609         Various IndexSearcher related events can trigger Listeners to
 610         take actions.
 611
 612         newSearcher - fired whenever a new searcher is being prepared
 613         and there is a current searcher handling requests (aka
 614         registered).  It can be used to prime certain caches to
 615         prevent long request times for certain requests.
 616
 617         firstSearcher - fired whenever a new searcher is being
 618         prepared but there is no current registered searcher to handle
 619         requests or to gain autowarming data from.
 620
 621
 622      -->
 623     <!-- QuerySenderListener takes an array of NamedList and executes a
 624          local query request for each NamedList in sequence.
 625       -->
 626     <listener event="newSearcher" class="solr.QuerySenderListener">
 627       <arr name="queries">
 628         <lst>
 629           <str name="q">database:*</str>
 630           <str name="facet">true</str>
 631           <str name="facet.mincount">1</str>
 632           <str name="facet.field">author_exact</str>
 633           <str name="facet.field">subject_exact</str>
 634           <str name="facet.field">medium_exact</str>
 635           <str name="facet.field">date</str>
 636           <str name="facet.field">database</str>
 637         </lst>
 638       </arr>
 639     </listener>
 640     <listener event="firstSearcher" class="solr.QuerySenderListener">
 641       <arr name="queries">
 642         <lst>
 643           <str name="q">database:*</str>
 644           <str name="facet">true</str>
 645           <str name="facet.mincount">1</str>
 646           <str name="facet.field">author_exact</str>
 647           <str name="facet.field">subject_exact</str>
 648           <str name="facet.field">medium_exact</str>
 649           <str name="facet.field">date</str>
 650           <str name="facet.field">database</str>
 651         </lst>
 652       </arr>
 653     </listener>
 654
 655     <!-- Use Cold Searcher
 656
 657          If a search request comes in and there is no current
 658          registered searcher, then immediately register the still
 659          warming searcher and use it.  If "false" then all requests
 660          will block until the first searcher is done warming.
 661       -->
 662     <useColdSearcher>false</useColdSearcher>
 663
 664     <!-- Max Warming Searchers
 665
 666          Maximum number of searchers that may be warming in the
 667          background concurrently.  An error is returned if this limit
 668          is exceeded.
 669
 670          Recommend values of 1-2 for read-only slaves, higher for
 671          masters w/o cache warming.
 672       -->
 673     <maxWarmingSearchers>2</maxWarmingSearchers>
 674
 675   </query>
 676
 677
 678   <!-- Request Dispatcher
 679
 680        This section contains instructions for how the SolrDispatchFilter
 681        should behave when processing requests for this SolrCore.
 682
 683        handleSelect is a legacy option that affects the behavior of requests
 684        such as /select?qt=XXX
 685
 686        handleSelect="true" will cause the SolrDispatchFilter to process
 687        the request and dispatch the query to a handler specified by the
 688        "qt" param, assuming "/select" isn't already registered.
 689
 690        handleSelect="false" will cause the SolrDispatchFilter to
 691        ignore "/select" requests, resulting in a 404 unless a handler
 692        is explicitly registered with the name "/select"
 693
 694        handleSelect="true" is not recommended for new users, but is the default
 695        for backwards compatibility
 696     -->
 697   <requestDispatcher handleSelect="false" >
 698     <!-- Request Parsing
 699
 700          These settings indicate how Solr Requests may be parsed, and
 701          what restrictions may be placed on the ContentStreams from
 702          those requests
 703
 704          enableRemoteStreaming - enables use of the stream.file
 705          and stream.url parameters for specifying remote streams.
 706
 707          multipartUploadLimitInKB - specifies the max size (in KiB) of
 708          Multipart File Uploads that Solr will allow in a Request.
 709
 710          formdataUploadLimitInKB - specifies the max size (in KiB) of
 711          form data (application/x-www-form-urlencoded) sent via
 712          POST. You can use POST to pass request parameters not
 713          fitting into the URL.
 714
 715          addHttpRequestToContext - if set to true, it will instruct
 716          the requestParsers to include the original HttpServletRequest
 717          object in the context map of the SolrQueryRequest under the
 718          key "httpRequest". It will not be used by any of the existing
 719          Solr components, but may be useful when developing custom
 720          plugins.
 721
 722          *** WARNING ***
 723          The settings below authorize Solr to fetch remote files, You
 724          should make sure your system has some authentication before
 725          using enableRemoteStreaming="true"
 726
 727       -->
 728     <requestParsers enableRemoteStreaming="true"
 729                     multipartUploadLimitInKB="2048000"
 730                     formdataUploadLimitInKB="2048"
 731                     addHttpRequestToContext="false"/>
 732
 733     <!-- HTTP Caching
 734
 735          Set HTTP caching related parameters (for proxy caches and clients).
 736
 737          The options below instruct Solr not to output any HTTP Caching
 738          related headers
 739       -->
 740     <httpCaching never304="true" />
 741     <!-- If you include a <cacheControl> directive, it will be used to
 742          generate a Cache-Control header (as well as an Expires header
 743          if the value contains "max-age=")
 744
 745          By default, no Cache-Control header is generated.
 746
 747          You can use the <cacheControl> option even if you have set
 748          never304="true"
 749       -->
 750     <!--
 751        <httpCaching never304="true" >
 752          <cacheControl>max-age=30, public</cacheControl>
 753        </httpCaching>
 754       -->
 755     <!-- To enable Solr to respond with automatically generated HTTP
 756          Caching headers, and to response to Cache Validation requests
 757          correctly, set the value of never304="false"
 758
 759          This will cause Solr to generate Last-Modified and ETag
 760          headers based on the properties of the Index.
 761
 762          The following options can also be specified to affect the
 763          values of these headers...
 764
 765          lastModFrom - the default value is "openTime" which means the
 766          Last-Modified value (and validation against If-Modified-Since
 767          requests) will all be relative to when the current Searcher
 768          was opened.  You can change it to lastModFrom="dirLastMod" if
 769          you want the value to exactly correspond to when the physical
 770          index was last modified.
 771
 772          etagSeed="..." is an option you can change to force the ETag
 773          header (and validation against If-None-Match requests) to be
 774          different even if the index has not changed (ie: when making
 775          significant changes to your config file)
 776
 777          (lastModifiedFrom and etagSeed are both ignored if you use
 778          the never304="true" option)
 779       -->
 780     <!--
 781        <httpCaching lastModifiedFrom="openTime"
 782                     etagSeed="Solr">
 783          <cacheControl>max-age=30, public</cacheControl>
 784        </httpCaching>
 785       -->
 786   </requestDispatcher>
 787
 788   <!-- Request Handlers
 789
 790        http://wiki.apache.org/solr/SolrRequestHandler
 791
 792        Incoming queries will be dispatched to a specific handler by name
 793        based on the path specified in the request.
 794
 795        Legacy behavior: If the request path uses "/select" but no Request
 796        Handler has that name, and if handleSelect="true" has been specified in
 797        the requestDispatcher, then the Request Handler is dispatched based on
 798        the qt parameter.  Handlers without a leading '/' are accessed this way
 799        like so: http://host/app/[core/]select?qt=name  If no qt is
 800        given, then the requestHandler that declares default="true" will be
 801        used or the one named "standard".
 802
 803        If a Request Handler is declared with startup="lazy", then it will
 804        not be initialized until the first request that uses it.
 805
 806     -->
 807   <!-- SearchHandler
 808
 809        http://wiki.apache.org/solr/SearchHandler
 810
 811        For processing Search Queries, the primary Request Handler
 812        provided with Solr is "SearchHandler" It delegates to a sequent
 813        of SearchComponents (see below) and supports distributed
 814        queries across multiple shards
 815     -->
 816   <requestHandler name="/select" class="solr.SearchHandler">
 817     <!-- default values for query parameters can be specified, these
 818          will be overridden by parameters in the request
 819       -->
 820      <lst name="defaults">
 821        <str name="echoParams">explicit</str>
 822        <int name="rows">10</int>
 823        <str name="df">text</str>
 824        <str name="fl">*,score</str>
 825      </lst>
 826     <!-- In addition to defaults, "appends" params can be specified
 827          to identify values which should be appended to the list of
 828          multi-val params from the query (or the existing "defaults").
 829       -->
 830     <!-- In this example, the param "fq=instock:true" would be appended to
 831          any query time fq params the user may specify, as a mechanism for
 832          partitioning the index, independent of any user selected filtering
 833          that may also be desired (perhaps as a result of faceted searching).
 834
 835          NOTE: there is *absolutely* nothing a client can do to prevent these
 836          "appends" values from being used, so don't use this mechanism
 837          unless you are sure you always want it.
 838       -->
 839     <!--
 840        <lst name="appends">
 841          <str name="fq">inStock:true</str>
 842        </lst>
 843       -->
 844     <!-- "invariants" are a way of letting the Solr maintainer lock down
 845          the options available to Solr clients.  Any params values
 846          specified here are used regardless of what values may be specified
 847          in either the query, the "defaults", or the "appends" params.
 848
 849          In this example, the facet.field and facet.query params would
 850          be fixed, limiting the facets clients can use.  Faceting is
 851          not turned on by default - but if the client does specify
 852          facet=true in the request, these are the only facets they
 853          will be able to see counts for; regardless of what other
 854          facet.field or facet.query params they may specify.
 855
 856          NOTE: there is *absolutely* nothing a client can do to prevent these
 857          "invariants" values from being used, so don't use this mechanism
 858          unless you are sure you always want it.
 859       -->
 860     <!--
 861        <lst name="invariants">
 862          <str name="facet.field">cat</str>
 863          <str name="facet.field">manu_exact</str>
 864          <str name="facet.query">price:[* TO 500]</str>
 865          <str name="facet.query">price:[500 TO *]</str>
 866        </lst>
 867       -->
 868     <!-- If the default list of SearchComponents is not desired, that
 869          list can either be overridden completely, or components can be
 870          prepended or appended to the default list.  (see below)
 871       -->
 872     <!--
 873        <arr name="components">
 874          <str>nameOfCustomComponent1</str>
 875          <str>nameOfCustomComponent2</str>
 876        </arr>
 877       -->
 878     </requestHandler>
 879
 880   <!-- A request handler that returns indented JSON by default -->
 881   <requestHandler name="/query" class="solr.SearchHandler">
 882      <lst name="defaults">
 883        <str name="echoParams">explicit</str>
 884        <str name="wt">json</str>
 885        <str name="indent">true</str>
 886        <str name="df">text</str>
 887      </lst>
 888   </requestHandler>
 889
 890
 891   <!-- realtime get handler, guaranteed to return the latest stored fields of
 892        any document, without the need to commit or open a new searcher.  The
 893        current implementation relies on the updateLog feature being enabled. -->
 894   <requestHandler name="/get" class="solr.RealTimeGetHandler">
 895      <lst name="defaults">
 896        <str name="omitHeader">true</str>
 897        <str name="wt">json</str>
 898        <str name="indent">true</str>
 899      </lst>
 900   </requestHandler>
 901
 902
 903   <!-- A Robust Example
 904
 905        This example SearchHandler declaration shows off usage of the
 906        SearchHandler with many defaults declared
 907
 908        Note that multiple instances of the same Request Handler
 909        (SearchHandler) can be registered multiple times with different
 910        names (and different init parameters)
 911     -->
 912   <requestHandler name="/browse" class="solr.SearchHandler">
 913      <lst name="defaults">
 914        <str name="echoParams">explicit</str>
 915
 916        <!-- VelocityResponseWriter settings -->
 917        <str name="wt">velocity</str>
 918        <str name="v.template">browse</str>
 919        <str name="v.layout">layout</str>
 920        <str name="title">Solritas</str>
 921
 922        <!-- Query settings -->
 923        <str name="defType">edismax</str>
 924        <str name="qf">
 925           text^0.5 features^1.0 name^1.2 sku^1.5 id^10.0 manu^1.1 cat^1.4
 926           title^10.0 description^5.0 keywords^5.0 author^2.0 resourcename^1.0
 927        </str>
 928        <str name="df">text</str>
 929        <str name="mm">100%</str>
 930        <str name="q.alt">*:*</str>
 931        <str name="rows">10</str>
 932        <str name="fl">*,score</str>
 933
 934        <str name="mlt.qf">
 935          text^0.5 features^1.0 name^1.2 sku^1.5 id^10.0 manu^1.1 cat^1.4
 936          title^10.0 description^5.0 keywords^5.0 author^2.0 resourcename^1.0
 937        </str>
 938        <str name="mlt.fl">text,features,name,sku,id,manu,cat,title,description,keywords,author,resourcename</str>
 939        <int name="mlt.count">3</int>
 940
 941        <!-- Faceting defaults -->
 942        <str name="facet">on</str>
 943        <str name="facet.field">cat</str>
 944        <str name="facet.field">manu_exact</str>
 945        <str name="facet.field">content_type</str>
 946        <str name="facet.field">author_s</str>
 947        <str name="facet.query">ipod</str>
 948        <str name="facet.query">GB</str>
 949        <str name="facet.mincount">1</str>
 950        <str name="facet.pivot">cat,inStock</str>
 951        <str name="facet.range.other">after</str>
 952        <str name="facet.range">price</str>
 953        <int name="f.price.facet.range.start">0</int>
 954        <int name="f.price.facet.range.end">600</int>
 955        <int name="f.price.facet.range.gap">50</int>
 956        <str name="facet.range">popularity</str>
 957        <int name="f.popularity.facet.range.start">0</int>
 958        <int name="f.popularity.facet.range.end">10</int>
 959        <int name="f.popularity.facet.range.gap">3</int>
 960        <str name="facet.range">manufacturedate_dt</str>
 961        <str name="f.manufacturedate_dt.facet.range.start">NOW/YEAR-10YEARS</str>
 962        <str name="f.manufacturedate_dt.facet.range.end">NOW</str>
 963        <str name="f.manufacturedate_dt.facet.range.gap">+1YEAR</str>
 964        <str name="f.manufacturedate_dt.facet.range.other">before</str>
 965        <str name="f.manufacturedate_dt.facet.range.other">after</str>
 966
 967        <!-- Highlighting defaults -->
 968        <str name="hl">on</str>
 969        <str name="hl.fl">content features title name</str>
 970        <str name="hl.encoder">html</str>
 971        <str name="hl.simple.pre">&lt;b&gt;</str>
 972        <str name="hl.simple.post">&lt;/b&gt;</str>
 973        <str name="f.title.hl.fragsize">0</str>
 974        <str name="f.title.hl.alternateField">title</str>
 975        <str name="f.name.hl.fragsize">0</str>
 976        <str name="f.name.hl.alternateField">name</str>
 977        <str name="f.content.hl.snippets">3</str>
 978        <str name="f.content.hl.fragsize">200</str>
 979        <str name="f.content.hl.alternateField">content</str>
 980        <str name="f.content.hl.maxAlternateFieldLength">750</str>
 981
 982        <!-- Spell checking defaults -->
 983        <str name="spellcheck">on</str>
 984        <str name="spellcheck.extendedResults">false</str>
 985        <str name="spellcheck.count">5</str>
 986        <str name="spellcheck.alternativeTermCount">2</str>
 987        <str name="spellcheck.maxResultsForSuggest">5</str>
 988        <str name="spellcheck.collate">true</str>
 989        <str name="spellcheck.collateExtendedResults">true</str>
 990        <str name="spellcheck.maxCollationTries">5</str>
 991        <str name="spellcheck.maxCollations">3</str>
 992      </lst>
 993
 994      <!-- append spellchecking to our list of components -->
 995      <arr name="last-components">
 996        <str>spellcheck</str>
 997      </arr>
 998   </requestHandler>
 999
1000
1001   <!-- Update Request Handler.
1002
1003        http://wiki.apache.org/solr/UpdateXmlMessages
1004
1005        The canonical Request Handler for Modifying the Index through
1006        commands specified using XML, JSON, CSV, or JAVABIN
1007
1008        Note: Since solr1.1 requestHandlers requires a valid content
1009        type header if posted in the body. For example, curl now
1010        requires: -H 'Content-type:text/xml; charset=utf-8'
1011
1012        To override the request content type and force a specific
1013        Content-type, use the request parameter:
1014          ?update.contentType=text/csv
1015
1016        This handler will pick a response format to match the input
1017        if the 'wt' parameter is not explicit
1018     -->
1019   <requestHandler name="/update" class="solr.UpdateRequestHandler">
1020     <!-- See below for information on defining
1021          updateRequestProcessorChains that can be used by name
1022          on each Update Request
1023       -->
1024     <!--
1025        <lst name="defaults">
1026          <str name="update.chain">dedupe</str>
1027        </lst>
1028        -->
1029   </requestHandler>
1030
1031   <!-- for back compat with clients using /update/json and /update/csv -->
1032   <requestHandler name="/update/json" class="solr.JsonUpdateRequestHandler">
1033         <lst name="defaults">
1034          <str name="stream.contentType">application/json</str>
1035        </lst>
1036   </requestHandler>
1037   <requestHandler name="/update/csv" class="solr.CSVRequestHandler">
1038         <lst name="defaults">
1039          <str name="stream.contentType">application/csv</str>
1040        </lst>
1041   </requestHandler>
1042
1043   <!-- Solr Cell Update Request Handler
1044
1045        http://wiki.apache.org/solr/ExtractingRequestHandler
1046
1047     -->
1048   <requestHandler name="/update/extract"
1049                   startup="lazy"
1050                   class="solr.extraction.ExtractingRequestHandler" >
1051     <lst name="defaults">
1052       <str name="lowernames">true</str>
1053       <str name="uprefix">ignored_</str>
1054
1055       <!-- capture link hrefs but ignore div attributes -->
1056       <str name="captureAttr">true</str>
1057       <str name="fmap.a">links</str>
1058       <str name="fmap.div">ignored_</str>
1059     </lst>
1060   </requestHandler>
1061
1062
1063   <!-- Field Analysis Request Handler
1064
1065        RequestHandler that provides much the same functionality as
1066        analysis.jsp. Provides the ability to specify multiple field
1067        types and field names in the same request and outputs
1068        index-time and query-time analysis for each of them.
1069
1070        Request parameters are:
1071        analysis.fieldname - field name whose analyzers are to be used
1072
1073        analysis.fieldtype - field type whose analyzers are to be used
1074        analysis.fieldvalue - text for index-time analysis
1075        q (or analysis.q) - text for query time analysis
1076        analysis.showmatch (true|false) - When set to true and when
1077            query analysis is performed, the produced tokens of the
1078            field value analysis will be marked as "matched" for every
1079            token that is produces by the query analysis
1080    -->
1081   <requestHandler name="/analysis/field"
1082                   startup="lazy"
1083                   class="solr.FieldAnalysisRequestHandler" />
1084
1085
1086   <!-- Document Analysis Handler
1087
1088        http://wiki.apache.org/solr/AnalysisRequestHandler
1089
1090        An analysis handler that provides a breakdown of the analysis
1091        process of provided documents. This handler expects a (single)
1092        content stream with the following format:
1093
1094        <docs>
1095          <doc>
1096            <field name="id">1</field>
1097            <field name="name">The Name</field>
1098            <field name="text">The Text Value</field>
1099          </doc>
1100          <doc>...</doc>
1101          <doc>...</doc>
1102          ...
1103        </docs>
1104
1105     Note: Each document must contain a field which serves as the
1106     unique key. This key is used in the returned response to associate
1107     an analysis breakdown to the analyzed document.
1108
1109     Like the FieldAnalysisRequestHandler, this handler also supports
1110     query analysis by sending either an "analysis.query" or "q"
1111     request parameter that holds the query text to be analyzed. It
1112     also supports the "analysis.showmatch" parameter which when set to
1113     true, all field tokens that match the query tokens will be marked
1114     as a "match".
1115   -->
1116   <requestHandler name="/analysis/document"
1117                   class="solr.DocumentAnalysisRequestHandler"
1118                   startup="lazy" />
1119
1120   <!-- Admin Handlers
1121
1122        Admin Handlers - This will register all the standard admin
1123        RequestHandlers.
1124     -->
1125   <requestHandler name="/admin/"
1126                   class="solr.admin.AdminHandlers" />
1127   <!-- This single handler is equivalent to the following... -->
1128   <!--
1129      <requestHandler name="/admin/luke"       class="solr.admin.LukeRequestHandler" />
1130      <requestHandler name="/admin/system"     class="solr.admin.SystemInfoHandler" />
1131      <requestHandler name="/admin/plugins"    class="solr.admin.PluginInfoHandler" />
1132      <requestHandler name="/admin/threads"    class="solr.admin.ThreadDumpHandler" />
1133      <requestHandler name="/admin/properties" class="solr.admin.PropertiesRequestHandler" />
1134      <requestHandler name="/admin/file"       class="solr.admin.ShowFileRequestHandler" >
1135     -->
1136   <!-- If you wish to hide files under ${solr.home}/conf, explicitly
1137        register the ShowFileRequestHandler using:
1138     -->
1139   <!--
1140      <requestHandler name="/admin/file"
1141                      class="solr.admin.ShowFileRequestHandler" >
1142        <lst name="invariants">
1143          <str name="hidden">synonyms.txt</str>
1144          <str name="hidden">anotherfile.txt</str>
1145        </lst>
1146      </requestHandler>
1147     -->
1148
1149   <!-- ping/healthcheck -->
1150   <requestHandler name="/admin/ping" class="solr.PingRequestHandler">
1151     <lst name="invariants">
1152       <str name="q">solrpingquery</str>
1153     </lst>
1154     <lst name="defaults">
1155       <str name="echoParams">all</str>
1156     </lst>
1157     <!-- An optional feature of the PingRequestHandler is to configure the
1158          handler with a "healthcheckFile" which can be used to enable/disable
1159          the PingRequestHandler.
1160          relative paths are resolved against the data dir
1161       -->
1162     <!-- <str name="healthcheckFile">server-enabled.txt</str> -->
1163   </requestHandler>
1164
1165   <!-- Echo the request contents back to the client -->
1166   <requestHandler name="/debug/dump" class="solr.DumpRequestHandler" >
1167     <lst name="defaults">
1168      <str name="echoParams">explicit</str>
1169      <str name="echoHandler">true</str>
1170     </lst>
1171   </requestHandler>
1172
1173   <!-- Solr Replication
1174
1175        The SolrReplicationHandler supports replicating indexes from a
1176        "master" used for indexing and "slaves" used for queries.
1177
1178        http://wiki.apache.org/solr/SolrReplication
1179
1180        It is also necessary for SolrCloud to function (in Cloud mode, the
1181        replication handler is used to bulk transfer segments when nodes
1182        are added or need to recover).
1183
1184        https://wiki.apache.org/solr/SolrCloud/
1185     -->
1186   <requestHandler name="/replication" class="solr.ReplicationHandler" >
1187     <!--
1188        To enable simple master/slave replication, uncomment one of the
1189        sections below, depending on whether this solr instance should be
1190        the "master" or a "slave".  If this instance is a "slave" you will
1191        also need to fill in the masterUrl to point to a real machine.
1192     -->
1193     <!--
1194        <lst name="master">
1195          <str name="replicateAfter">commit</str>
1196          <str name="replicateAfter">startup</str>
1197          <str name="confFiles">schema.xml,stopwords.txt</str>
1198        </lst>
1199     -->
1200     <!--
1201        <lst name="slave">
1202          <str name="masterUrl">http://your-master-hostname:8983/solr</str>
1203          <str name="pollInterval">00:00:60</str>
1204        </lst>
1205     -->
1206   </requestHandler>
1207
1208   <!-- Search Components
1209
1210        Search components are registered to SolrCore and used by
1211        instances of SearchHandler (which can access them by name)
1212
1213        By default, the following components are available:
1214
1215        <searchComponent name="query"     class="solr.QueryComponent" />
1216        <searchComponent name="facet"     class="solr.FacetComponent" />
1217        <searchComponent name="mlt"       class="solr.MoreLikeThisComponent" />
1218        <searchComponent name="highlight" class="solr.HighlightComponent" />
1219        <searchComponent name="stats"     class="solr.StatsComponent" />
1220        <searchComponent name="debug"     class="solr.DebugComponent" />
1221
1222        Default configuration in a requestHandler would look like:
1223
1224        <arr name="components">
1225          <str>query</str>
1226          <str>facet</str>
1227          <str>mlt</str>
1228          <str>highlight</str>
1229          <str>stats</str>
1230          <str>debug</str>
1231        </arr>
1232
1233        If you register a searchComponent to one of the standard names,
1234        that will be used instead of the default.
1235
1236        To insert components before or after the 'standard' components, use:
1237
1238        <arr name="first-components">
1239          <str>myFirstComponentName</str>
1240        </arr>
1241
1242        <arr name="last-components">
1243          <str>myLastComponentName</str>
1244        </arr>
1245
1246        NOTE: The component registered with the name "debug" will
1247        always be executed after the "last-components"
1248
1249      -->
1250
1251    <!-- Spell Check
1252
1253         The spell check component can return a list of alternative spelling
1254         suggestions.
1255
1256         http://wiki.apache.org/solr/SpellCheckComponent
1257      -->
1258   <searchComponent name="spellcheck" class="solr.SpellCheckComponent">
1259
1260     <str name="queryAnalyzerFieldType">text_general</str>
1261
1262     <!-- Multiple "Spell Checkers" can be declared and used by this
1263          component
1264       -->
1265
1266     <!-- a spellchecker built from a field of the main index -->
1267     <lst name="spellchecker">
1268       <str name="name">default</str>
1269       <str name="field">text</str>
1270       <str name="classname">solr.DirectSolrSpellChecker</str>
1271       <!-- the spellcheck distance measure used, the default is the internal levenshtein -->
1272       <str name="distanceMeasure">internal</str>
1273       <!-- minimum accuracy needed to be considered a valid spellcheck suggestion -->
1274       <float name="accuracy">0.5</float>
1275       <!-- the maximum #edits we consider when enumerating terms: can be 1 or 2 -->
1276       <int name="maxEdits">2</int>
1277       <!-- the minimum shared prefix when enumerating terms -->
1278       <int name="minPrefix">1</int>
1279       <!-- maximum number of inspections per result. -->
1280       <int name="maxInspections">5</int>
1281       <!-- minimum length of a query term to be considered for correction -->
1282       <int name="minQueryLength">4</int>
1283       <!-- maximum threshold of documents a query term can appear to be considered for correction -->
1284       <float name="maxQueryFrequency">0.01</float>
1285       <!-- uncomment this to require suggestions to occur in 1% of the documents
1286         <float name="thresholdTokenFrequency">.01</float>
1287       -->
1288     </lst>
1289
1290     <!-- a spellchecker that can break or combine words.  See "/spell" handler below for usage -->
1291     <lst name="spellchecker">
1292       <str name="name">wordbreak</str>
1293       <str name="classname">solr.WordBreakSolrSpellChecker</str>
1294       <str name="field">name</str>
1295       <str name="combineWords">true</str>
1296       <str name="breakWords">true</str>
1297       <int name="maxChanges">10</int>
1298     </lst>
1299
1300     <!-- a spellchecker that uses a different distance measure -->
1301     <!--
1302        <lst name="spellchecker">
1303          <str name="name">jarowinkler</str>
1304          <str name="field">spell</str>
1305          <str name="classname">solr.DirectSolrSpellChecker</str>
1306          <str name="distanceMeasure">
1307            org.apache.lucene.search.spell.JaroWinklerDistance
1308          </str>
1309        </lst>
1310      -->
1311
1312     <!-- a spellchecker that use an alternate comparator
1313
1314          comparatorClass be one of:
1315           1. score (default)
1316           2. freq (Frequency first, then score)
1317           3. A fully qualified class name
1318       -->
1319     <!--
1320        <lst name="spellchecker">
1321          <str name="name">freq</str>
1322          <str name="field">lowerfilt</str>
1323          <str name="classname">solr.DirectSolrSpellChecker</str>
1324          <str name="comparatorClass">freq</str>
1325       -->
1326
1327     <!-- A spellchecker that reads the list of words from a file -->
1328     <!--
1329        <lst name="spellchecker">
1330          <str name="classname">solr.FileBasedSpellChecker</str>
1331          <str name="name">file</str>
1332          <str name="sourceLocation">spellings.txt</str>
1333          <str name="characterEncoding">UTF-8</str>
1334          <str name="spellcheckIndexDir">spellcheckerFile</str>
1335        </lst>
1336       -->
1337   </searchComponent>
1338
1339   <!-- A request handler for demonstrating the spellcheck component.
1340
1341        NOTE: This is purely as an example.  The whole purpose of the
1342        SpellCheckComponent is to hook it into the request handler that
1343        handles your normal user queries so that a separate request is
1344        not needed to get suggestions.
1345
1346        IN OTHER WORDS, THERE IS REALLY GOOD CHANCE THE SETUP BELOW IS
1347        NOT WHAT YOU WANT FOR YOUR PRODUCTION SYSTEM!
1348
1349        See http://wiki.apache.org/solr/SpellCheckComponent for details
1350        on the request parameters.
1351     -->
1352   <requestHandler name="/spell" class="solr.SearchHandler" startup="lazy">
1353     <lst name="defaults">
1354       <str name="df">text</str>
1355       <!-- Solr will use suggestions from both the 'default' spellchecker
1356            and from the 'wordbreak' spellchecker and combine them.
1357            collations (re-written queries) can include a combination of
1358            corrections from both spellcheckers -->
1359       <str name="spellcheck.dictionary">default</str>
1360       <str name="spellcheck.dictionary">wordbreak</str>
1361       <str name="spellcheck">on</str>
1362       <str name="spellcheck.extendedResults">true</str>
1363       <str name="spellcheck.count">10</str>
1364       <str name="spellcheck.alternativeTermCount">5</str>
1365       <str name="spellcheck.maxResultsForSuggest">5</str>
1366       <str name="spellcheck.collate">true</str>
1367       <str name="spellcheck.collateExtendedResults">true</str>
1368       <str name="spellcheck.maxCollationTries">10</str>
1369       <str name="spellcheck.maxCollations">5</str>
1370     </lst>
1371     <arr name="last-components">
1372       <str>spellcheck</str>
1373     </arr>
1374   </requestHandler>
1375
1376   <!-- Term Vector Component
1377
1378        http://wiki.apache.org/solr/TermVectorComponent
1379     -->
1380   <searchComponent name="tvComponent" class="solr.TermVectorComponent"/>
1381
1382   <!-- A request handler for demonstrating the term vector component
1383
1384        This is purely as an example.
1385
1386        In reality you will likely want to add the component to your
1387        already specified request handlers.
1388     -->
1389   <requestHandler name="/tvrh" class="solr.SearchHandler" startup="lazy">
1390     <lst name="defaults">
1391       <str name="df">text</str>
1392       <bool name="tv">true</bool>
1393     </lst>
1394     <arr name="last-components">
1395       <str>tvComponent</str>
1396     </arr>
1397   </requestHandler>
1398
1399   <!-- Clustering Component
1400
1401        http://wiki.apache.org/solr/ClusteringComponent
1402
1403        You'll need to set the solr.clustering.enabled system property
1404        when running solr to run with clustering enabled:
1405
1406             java -Dsolr.clustering.enabled=true -jar start.jar
1407
1408     -->
1409   <searchComponent name="clustering"
1410                    enable="${solr.clustering.enabled:false}"
1411                    class="solr.clustering.ClusteringComponent" >
1412     <!-- Declare an engine -->
1413     <lst name="engine">
1414       <!-- The name, only one can be named "default" -->
1415       <str name="name">default</str>
1416
1417       <!-- Class name of Carrot2 clustering algorithm.
1418
1419            Currently available algorithms are:
1420
1421            * org.carrot2.clustering.lingo.LingoClusteringAlgorithm
1422            * org.carrot2.clustering.stc.STCClusteringAlgorithm
1423            * org.carrot2.clustering.kmeans.BisectingKMeansClusteringAlgorithm
1424
1425            See http://project.carrot2.org/algorithms.html for the
1426            algorithm's characteristics.
1427         -->
1428       <str name="carrot.algorithm">org.carrot2.clustering.lingo.LingoClusteringAlgorithm</str>
1429
1430       <!-- Overriding values for Carrot2 default algorithm attributes.
1431
1432            For a description of all available attributes, see:
1433            http://download.carrot2.org/stable/manual/#chapter.components.
1434            Use attribute key as name attribute of str elements
1435            below. These can be further overridden for individual
1436            requests by specifying attribute key as request parameter
1437            name and attribute value as parameter value.
1438         -->
1439       <str name="LingoClusteringAlgorithm.desiredClusterCountBase">20</str>
1440
1441       <!-- Location of Carrot2 lexical resources.
1442
1443            A directory from which to load Carrot2-specific stop words
1444            and stop labels. Absolute or relative to Solr config directory.
1445            If a specific resource (e.g. stopwords.en) is present in the
1446            specified dir, it will completely override the corresponding
1447            default one that ships with Carrot2.
1448
1449            For an overview of Carrot2 lexical resources, see:
1450            http://download.carrot2.org/head/manual/#chapter.lexical-resources
1451         -->
1452       <str name="carrot.lexicalResourcesDir">clustering/carrot2</str>
1453
1454       <!-- The language to assume for the documents.
1455
1456            For a list of allowed values, see:
1457            http://download.carrot2.org/stable/manual/#section.attribute.lingo.MultilingualClustering.defaultLanguage
1458        -->
1459       <str name="MultilingualClustering.defaultLanguage">ENGLISH</str>
1460     </lst>
1461     <lst name="engine">
1462       <str name="name">stc</str>
1463       <str name="carrot.algorithm">org.carrot2.clustering.stc.STCClusteringAlgorithm</str>
1464     </lst>
1465   </searchComponent>
1466
1467   <!-- A request handler for demonstrating the clustering component
1468
1469        This is purely as an example.
1470
1471        In reality you will likely want to add the component to your
1472        already specified request handlers.
1473     -->
1474   <requestHandler name="/clustering"
1475                   startup="lazy"
1476                   enable="${solr.clustering.enabled:false}"
1477                   class="solr.SearchHandler">
1478     <lst name="defaults">
1479       <bool name="clustering">true</bool>
1480       <str name="clustering.engine">default</str>
1481       <bool name="clustering.results">true</bool>
1482       <!-- The title field -->
1483       <str name="carrot.title">name</str>
1484       <str name="carrot.url">id</str>
1485       <!-- The field to cluster on -->
1486        <str name="carrot.snippet">features</str>
1487        <!-- produce summaries -->
1488        <bool name="carrot.produceSummary">true</bool>
1489        <!-- the maximum number of labels per cluster -->
1490        <!--<int name="carrot.numDescriptions">5</int>-->
1491        <!-- produce sub clusters -->
1492        <bool name="carrot.outputSubClusters">false</bool>
1493
1494        <str name="defType">edismax</str>
1495        <str name="qf">
1496          text^0.5 features^1.0 name^1.2 sku^1.5 id^10.0 manu^1.1 cat^1.4
1497        </str>
1498        <str name="q.alt">*:*</str>
1499        <str name="rows">10</str>
1500        <str name="fl">*,score</str>
1501     </lst>
1502     <arr name="last-components">
1503       <str>clustering</str>
1504     </arr>
1505   </requestHandler>
1506
1507   <!-- Terms Component
1508
1509        http://wiki.apache.org/solr/TermsComponent
1510
1511        A component to return terms and document frequency of those
1512        terms
1513     -->
1514   <searchComponent name="terms" class="solr.TermsComponent"/>
1515
1516   <!-- A request handler for demonstrating the terms component -->
1517   <requestHandler name="/terms" class="solr.SearchHandler" startup="lazy">
1518      <lst name="defaults">
1519       <bool name="terms">true</bool>
1520       <bool name="distrib">false</bool>
1521     </lst>
1522     <arr name="components">
1523       <str>terms</str>
1524     </arr>
1525   </requestHandler>
1526
1527
1528   <!-- Query Elevation Component
1529
1530        http://wiki.apache.org/solr/QueryElevationComponent
1531
1532        a search component that enables you to configure the top
1533        results for a given query regardless of the normal lucene
1534        scoring.
1535     -->
1536   <searchComponent name="elevator" class="solr.QueryElevationComponent" >
1537     <!-- pick a fieldType to analyze queries -->
1538     <str name="queryFieldType">string</str>
1539     <str name="config-file">elevate.xml</str>
1540   </searchComponent>
1541
1542   <!-- A request handler for demonstrating the elevator component -->
1543   <requestHandler name="/elevate" class="solr.SearchHandler" startup="lazy">
1544     <lst name="defaults">
1545       <str name="echoParams">explicit</str>
1546       <str name="df">text</str>
1547     </lst>
1548     <arr name="last-components">
1549       <str>elevator</str>
1550     </arr>
1551   </requestHandler>
1552
1553   <!-- Highlighting Component
1554
1555        http://wiki.apache.org/solr/HighlightingParameters
1556     -->
1557   <searchComponent class="solr.HighlightComponent" name="highlight">
1558     <highlighting>
1559       <!-- Configure the standard fragmenter -->
1560       <!-- This could most likely be commented out in the "default" case -->
1561       <fragmenter name="gap"
1562                   default="true"
1563                   class="solr.highlight.GapFragmenter">
1564         <lst name="defaults">
1565           <int name="hl.fragsize">100</int>
1566         </lst>
1567       </fragmenter>
1568
1569       <!-- A regular-expression-based fragmenter
1570            (for sentence extraction)
1571         -->
1572       <fragmenter name="regex"
1573                   class="solr.highlight.RegexFragmenter">
1574         <lst name="defaults">
1575           <!-- slightly smaller fragsizes work better because of slop -->
1576           <int name="hl.fragsize">70</int>
1577           <!-- allow 50% slop on fragment sizes -->
1578           <float name="hl.regex.slop">0.5</float>
1579           <!-- a basic sentence pattern -->
1580           <str name="hl.regex.pattern">[-\w ,/\n\&quot;&apos;]{20,200}</str>
1581         </lst>
1582       </fragmenter>
1583
1584       <!-- Configure the standard formatter -->
1585       <formatter name="html"
1586                  default="true"
1587                  class="solr.highlight.HtmlFormatter">
1588         <lst name="defaults">
1589           <str name="hl.simple.pre"><![CDATA[<em>]]></str>
1590           <str name="hl.simple.post"><![CDATA[</em>]]></str>
1591         </lst>
1592       </formatter>
1593
1594       <!-- Configure the standard encoder -->
1595       <encoder name="html"
1596                class="solr.highlight.HtmlEncoder" />
1597
1598       <!-- Configure the standard fragListBuilder -->
1599       <fragListBuilder name="simple"
1600                        class="solr.highlight.SimpleFragListBuilder"/>
1601
1602       <!-- Configure the single fragListBuilder -->
1603       <fragListBuilder name="single"
1604                        class="solr.highlight.SingleFragListBuilder"/>
1605
1606       <!-- Configure the weighted fragListBuilder -->
1607       <fragListBuilder name="weighted"
1608                        default="true"
1609                        class="solr.highlight.WeightedFragListBuilder"/>
1610
1611       <!-- default tag FragmentsBuilder -->
1612       <fragmentsBuilder name="default"
1613                         default="true"
1614                         class="solr.highlight.ScoreOrderFragmentsBuilder">
1615         <!--
1616         <lst name="defaults">
1617           <str name="hl.multiValuedSeparatorChar">/</str>
1618         </lst>
1619         -->
1620       </fragmentsBuilder>
1621
1622       <!-- multi-colored tag FragmentsBuilder -->
1623       <fragmentsBuilder name="colored"
1624                         class="solr.highlight.ScoreOrderFragmentsBuilder">
1625         <lst name="defaults">
1626           <str name="hl.tag.pre"><![CDATA[
1627                <b style="background:yellow">,<b style="background:lawgreen">,
1628                <b style="background:aquamarine">,<b style="background:magenta">,
1629                <b style="background:palegreen">,<b style="background:coral">,
1630                <b style="background:wheat">,<b style="background:khaki">,
1631                <b style="background:lime">,<b style="background:deepskyblue">]]></str>
1632           <str name="hl.tag.post"><![CDATA[</b>]]></str>
1633         </lst>
1634       </fragmentsBuilder>
1635
1636       <boundaryScanner name="default"
1637                        default="true"
1638                        class="solr.highlight.SimpleBoundaryScanner">
1639         <lst name="defaults">
1640           <str name="hl.bs.maxScan">10</str>
1641           <str name="hl.bs.chars">.,!? &#9;&#10;&#13;</str>
1642         </lst>
1643       </boundaryScanner>
1644
1645       <boundaryScanner name="breakIterator"
1646                        class="solr.highlight.BreakIteratorBoundaryScanner">
1647         <lst name="defaults">
1648           <!-- type should be one of CHARACTER, WORD(default), LINE and SENTENCE -->
1649           <str name="hl.bs.type">WORD</str>
1650           <!-- language and country are used when constructing Locale object.  -->
1651           <!-- And the Locale object will be used when getting instance of BreakIterator -->
1652           <str name="hl.bs.language">en</str>
1653           <str name="hl.bs.country">US</str>
1654         </lst>
1655       </boundaryScanner>
1656     </highlighting>
1657   </searchComponent>
1658
1659   <!-- Update Processors
1660
1661        Chains of Update Processor Factories for dealing with Update
1662        Requests can be declared, and then used by name in Update
1663        Request Processors
1664
1665        http://wiki.apache.org/solr/UpdateRequestProcessor
1666
1667     -->
1668   <!-- Deduplication
1669
1670        An example dedup update processor that creates the "id" field
1671        on the fly based on the hash code of some other fields.  This
1672        example has overwriteDupes set to false since we are using the
1673        id field as the signatureField and Solr will maintain
1674        uniqueness based on that anyway.
1675
1676     -->
1677   <!--
1678      <updateRequestProcessorChain name="dedupe">
1679        <processor class="solr.processor.SignatureUpdateProcessorFactory">
1680          <bool name="enabled">true</bool>
1681          <str name="signatureField">id</str>
1682          <bool name="overwriteDupes">false</bool>
1683          <str name="fields">name,features,cat</str>
1684          <str name="signatureClass">solr.processor.Lookup3Signature</str>
1685        </processor>
1686        <processor class="solr.LogUpdateProcessorFactory" />
1687        <processor class="solr.RunUpdateProcessorFactory" />
1688      </updateRequestProcessorChain>
1689     -->
1690
1691   <!-- Language identification
1692
1693        This example update chain identifies the language of the incoming
1694        documents using the langid contrib. The detected language is
1695        written to field language_s. No field name mapping is done.
1696        The fields used for detection are text, title, subject and description,
1697        making this example suitable for detecting languages form full-text
1698        rich documents injected via ExtractingRequestHandler.
1699        See more about langId at http://wiki.apache.org/solr/LanguageDetection
1700     -->
1701     <!--
1702      <updateRequestProcessorChain name="langid">
1703        <processor class="org.apache.solr.update.processor.TikaLanguageIdentifierUpdateProcessorFactory">
1704          <str name="langid.fl">text,title,subject,description</str>
1705          <str name="langid.langField">language_s</str>
1706          <str name="langid.fallback">en</str>
1707        </processor>
1708        <processor class="solr.LogUpdateProcessorFactory" />
1709        <processor class="solr.RunUpdateProcessorFactory" />
1710      </updateRequestProcessorChain>
1711     -->
1712
1713   <!-- Script update processor
1714
1715     This example hooks in an update processor implemented using JavaScript.
1716
1717     See more about the script update processor at http://wiki.apache.org/solr/ScriptUpdateProcessor
1718   -->
1719   <!--
1720     <updateRequestProcessorChain name="script">
1721       <processor class="solr.StatelessScriptUpdateProcessorFactory">
1722         <str name="script">update-script.js</str>
1723         <lst name="params">
1724           <str name="config_param">example config parameter</str>
1725         </lst>
1726       </processor>
1727       <processor class="solr.RunUpdateProcessorFactory" />
1728     </updateRequestProcessorChain>
1729   -->
1730
1731   <!-- Response Writers
1732
1733        http://wiki.apache.org/solr/QueryResponseWriter
1734
1735        Request responses will be written using the writer specified by
1736        the 'wt' request parameter matching the name of a registered
1737        writer.
1738
1739        The "default" writer is the default and will be used if 'wt' is
1740        not specified in the request.
1741     -->
1742   <!-- The following response writers are implicitly configured unless
1743        overridden...
1744     -->
1745   <!--
1746      <queryResponseWriter name="xml"
1747                           default="true"
1748                           class="solr.XMLResponseWriter" />
1749      <queryResponseWriter name="json" class="solr.JSONResponseWriter"/>
1750      <queryResponseWriter name="python" class="solr.PythonResponseWriter"/>
1751      <queryResponseWriter name="ruby" class="solr.RubyResponseWriter"/>
1752      <queryResponseWriter name="php" class="solr.PHPResponseWriter"/>
1753      <queryResponseWriter name="phps" class="solr.PHPSerializedResponseWriter"/>
1754      <queryResponseWriter name="csv" class="solr.CSVResponseWriter"/>
1755      <queryResponseWriter name="schema.xml" class="solr.SchemaXmlResponseWriter"/>
1756     -->
1757
1758   <queryResponseWriter name="json" class="solr.JSONResponseWriter">
1759      <!-- For the purposes of the tutorial, JSON responses are written as
1760       plain text so that they are easy to read in *any* browser.
1761       If you expect a MIME type of "application/json" just remove this override.
1762      -->
1763     <str name="content-type">text/plain; charset=UTF-8</str>
1764   </queryResponseWriter>
1765
1766   <!--
1767      Custom response writers can be declared as needed...
1768     -->
1769     <queryResponseWriter name="velocity" class="solr.VelocityResponseWriter" startup="lazy"/>
1770
1771
1772   <!-- XSLT response writer transforms the XML output by any xslt file found
1773        in Solr's conf/xslt directory.  Changes to xslt files are checked for
1774        every xsltCacheLifetimeSeconds.
1775     -->
1776   <queryResponseWriter name="xslt" class="solr.XSLTResponseWriter">
1777     <int name="xsltCacheLifetimeSeconds">5</int>
1778   </queryResponseWriter>
1779
1780   <!-- Query Parsers
1781
1782        http://wiki.apache.org/solr/SolrQuerySyntax
1783
1784        Multiple QParserPlugins can be registered by name, and then
1785        used in either the "defType" param for the QueryComponent (used
1786        by SearchHandler) or in LocalParams
1787     -->
1788   <!-- example of registering a query parser -->
1789   <!--
1790      <queryParser name="myparser" class="com.mycompany.MyQParserPlugin"/>
1791     -->
1792
1793   <!-- Function Parsers
1794
1795        http://wiki.apache.org/solr/FunctionQuery
1796
1797        Multiple ValueSourceParsers can be registered by name, and then
1798        used as function names when using the "func" QParser.
1799     -->
1800   <!-- example of registering a custom function parser  -->
1801   <!--
1802      <valueSourceParser name="myfunc"
1803                         class="com.mycompany.MyValueSourceParser" />
1804     -->
1805
1806
1807   <!-- Document Transformers
1808        http://wiki.apache.org/solr/DocTransformers
1809     -->
1810   <!--
1811      Could be something like:
1812      <transformer name="db" class="com.mycompany.LoadFromDatabaseTransformer" >
1813        <int name="connection">jdbc://....</int>
1814      </transformer>
1815
1816      To add a constant value to all docs, use:
1817      <transformer name="mytrans2" class="org.apache.solr.response.transform.ValueAugmenterFactory" >
1818        <int name="value">5</int>
1819      </transformer>
1820
1821      If you want the user to still be able to change it with _value:something_ use this:
1822      <transformer name="mytrans3" class="org.apache.solr.response.transform.ValueAugmenterFactory" >
1823        <double name="defaultValue">5</double>
1824      </transformer>
1825
1826       If you are using the QueryElevationComponent, you may wish to mark documents that get boosted.  The
1827       EditorialMarkerFactory will do exactly that:
1828      <transformer name="qecBooster" class="org.apache.solr.response.transform.EditorialMarkerFactory" />
1829     -->
1830
1831
1832   <!-- Legacy config for the admin interface -->
1833   <admin>
1834     <defaultQuery>*:*</defaultQuery>
1835   </admin>
1836
1837 </config>