Apache Solr Reference Guide
About This Guide
Getting Started
- Solr Tutorial
- A Quick Overview
- Solr System Requirements
- Installing Solr
Deployment and Operations
- Solr Control Script Reference
- Solr Configuration Files
- Taking Solr to Production
- Making and Restoring Backups
- Running Solr on HDFS
- SolrCloud on AWS EC2
- Upgrading a Solr Cluster
  - IndexUpgrader Tool
- Solr Upgrade Notes
  - Major Changes in Solr 7
  - Major Changes from Solr 5 to Solr 6
Using the Solr Administration User Interface
- Overview of the Solr Admin UI
- Getting Assistance
- Logging
- Cloud Screens
- Collections / Core Admin
- Java Properties
- Thread Dump
- Suggestions Screen
- Collection-Specific Tools
- Core-Specific Tools
Documents, Fields, and Schema Design
- Overview of Documents, Fields, and Schema Design
- Solr Field Types
- Defining Fields
- Copying Fields
- Dynamic Fields
- Other Schema Elements
- Schema API
- Putting the Pieces Together
- DocValues
- Schemaless Mode
Understanding Analyzers, Tokenizers, and Filters
- Analyzers
- About Tokenizers
- About Filters
- Tokenizers
- Filter Descriptions
- CharFilterFactories
- Language Analysis
- Phonetic Matching
- Running Your Analyzer
Indexing and Basic Data Operations
- Introduction to Solr Indexing
- Post Tool
- Uploading Data with Index Handlers
  - Transforming and Indexing Custom JSON
- Uploading Data with Solr Cell using Apache Tika
- Uploading Structured Data Store Data with the Data Import Handler
- Updating Parts of Documents
- Detecting Languages During Indexing
- De-Duplication
- Content Streams
Searching
- Overview of Searching in Solr
- Velocity Search UI
- Relevance
- Query Syntax and Parsing
  - Common Query Parameters
  - The Standard Query Parser
  - The DisMax Query Parser
  - The Extended DisMax (eDismax) Query Parser
  - Function Queries
  - Local Parameters in Queries
  - Other Parsers
- JSON Request API
  - JSON Query DSL
- JSON Facet API
- Faceting
  - BlockJoin Faceting
- Highlighting
- Spell Checking
- Query Re-Ranking
  - Learning To Rank
- Transforming Result Documents
- Suggester
- MoreLikeThis
- Pagination of Results
- Collapse and Expand Results
- Result Grouping
- Result Clustering
- Spatial Search
- The Terms Component
- The Term Vector Component
- The Stats Component
- The Query Elevation Component
- The Tagger Handler
- Response Writers
  - Velocity Response Writer
- Near Real Time Searching
- RealTime Get
- Exporting Result Sets
- Parallel SQL Interface
  - Solr JDBC - DbVisualizer
  - Solr JDBC - SQuirreL SQL
  - Solr JDBC - Apache Zeppelin
  - Solr JDBC - Python/Jython
  - Solr JDBC - R
- Analytics Component
  - Analytics Expression Sources
  - Analytics Mapping Functions
  - Analytics Reduction Functions
Streaming Expressions
- Stream Source Reference
- Stream Decorator Reference
- Stream Evaluator Reference
- Math Expressions
- Graph Traversal
SolrCloud
- Getting Started with SolrCloud
- How SolrCloud Works
- SolrCloud Resilience
  - SolrCloud Recoveries and Write Tolerance
  - SolrCloud Query Routing And Read Tolerance
- SolrCloud Configuration and Parameters
- Rule-based Replica Placement
- Cross Data Center Replication (CDCR)
- SolrCloud Autoscaling
- Colocating Collections
Legacy Scaling and Distribution
- Introduction to Scaling and Distribution
- Distributed Search with Index Sharding
- Index Replication
- Combining Distribution and Replication
- Merging Indexes
The Well-Configured Solr Instance
- Configuring solrconfig.xml
- Solr Cores and solr.xml
- Configuration APIs
- Implicit RequestHandlers
- Solr Plugins
  - Adding Custom Plugins in SolrCloud Mode
- JVM Settings
- v2 API
Monitoring Solr
- Metrics Reporting
- Metrics History
- MBean Request Handler
- Configuring Logging
- Using JMX with Solr
- Monitoring Solr with Prometheus and Grafana
- Performance Statistics Reference
Securing Solr
- Authentication and Authorization Plugins
- Enabling SSL
Client APIs
- Introduction to Client APIs
- Choosing an Output Format
- Client API Lineup
- Using JavaScript
- Using Python
- Using SolrJ
- Using Solr From Ruby
Further Assistance
Solr Glossary
Errata
How to Contribute to Solr Documentation

Codec Factory

A codecFactory can be specified in solrconfig.xml to determine which Lucene Codec is used when writing the index to disk.

If not specified, Lucene’s default codec is implicitly used.

Alternatives to the Default Codec

There are two alternatives to Lucene’s default codec.

solr.SchemaCodecFactory

The solr.SchemaCodecFactory supports 2 key features:

Schema based per-fieldtype configuration for docValuesFormat and postingsFormat - see the Field Type Properties section for more details.
A compressionMode option:
- BEST_SPEED (default) is optimized for search speed performance
- BEST_COMPRESSION is optimized for disk space usage

Example:

<codecFactory class="solr.SchemaCodecFactory">
  <str name="compressionMode">BEST_COMPRESSION</str>
</codecFactory>

solr.SimpleTextCodecFactory

This factory for Lucene’s SimpleTextCodecFactory produces a plain text human-readable index format.

FOR RECREATIONAL USE ONLY. This codec should never be used in production. SimpleTextCodec is relatively slow and takes up a large amount of disk space. Its use should be limited to educational and debugging purposes.

Example:

<codecFactory class="solr.SimpleTextCodecFactory"/>

Update Request Processors Solr Cores and solr.xml