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
        • IndexUpgraderTool
      • Solr Upgrade Notes
        • Major Changes in Solr 8
        • 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
      • Logging
      • Cloud Screens
      • Collections / Core Admin
      • Java Properties
      • Thread Dump
      • Suggestions Screen
      • Collection-Specific Tools
        • Analysis Screen
        • Dataimport Screen
        • Documents Screen
        • Files Screen
        • Query Screen
        • Stream Screen
        • Schema Browser Screen
      • Core-Specific Tools
        • Ping
        • Plugins & Stats Screen
        • Replication Screen
        • Segments Info
    • Documents, Fields, and Schema Design
      • Overview of Documents, Fields, and Schema Design
      • Solr Field Types
        • Field Type Definitions and Properties
        • Field Types Included with Solr
        • Working with Currencies and Exchange Rates
        • Working with Dates
        • Working with Enum Fields
        • Working with External Files and Processes
        • Field Properties by Use Case
      • Defining Fields
      • Copying Fields
      • Dynamic Fields
      • Other Schema Elements
      • Schema API
      • Putting the Pieces Together
      • DocValues
      • Schemaless Mode
      • Luke Request Handler
      • Schema Designer
    • 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
      • Indexing Nested Child Documents
      • 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
      • Reindexing
    • 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
        • JSON Faceting Domain Changes
      • Faceting
        • BlockJoin Faceting
      • Highlighting
      • Spell Checking
      • Query Re-Ranking
        • Learning To Rank
      • Transforming Result Documents
      • Searching Nested Child Documents
      • Suggester
      • MoreLikeThis
      • Pagination of Results
      • Collapse and Expand Results
      • Result Grouping
      • 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
      • Streaming Expressions and Math Expressions
        • Visualization
        • Getting Started
        • Loading Data
        • Searching, Sampling and Aggregation
        • Transforming Data
        • Scalar Math
        • Vector Math
        • Variables
        • Matrices and Matrix Math
        • Text Analysis and Term Vectors
        • Probability Distributions
        • Statistics
        • Linear Regression
        • Curve Fitting
        • Time Series
        • Interpolation, Derivatives and Integrals
        • Digital Signal Processing
        • Monte Carlo Simulations
        • Machine Learning
        • Graph
        • Computational Geometry
        • Log Analytics
      • Graph Traversal
      • Stream Request Handler API
    • SolrCloud
      • Getting Started with SolrCloud
      • How SolrCloud Works
        • Shards and Indexing Data in SolrCloud
        • Distributed Requests
        • Aliases
      • SolrCloud Resilience
        • SolrCloud Recoveries and Write Tolerance
        • SolrCloud Query Routing And Read Tolerance
      • SolrCloud Configuration and Parameters
        • Setting Up an External ZooKeeper Ensemble
        • Using ZooKeeper to Manage Configuration Files
        • Collections API
          • Cluster and Node Management Commands
          • Collection Management Commands
          • Collection Aliasing
          • Shard Management Commands
          • Replica Management Commands
        • Parameter Reference
        • Command Line Utilities
        • SolrCloud with Legacy Configuration Files
        • Configsets API
      • Rule-based Replica Placement
      • Cross Data Center Replication (CDCR)
        • CDCR Architecture
        • CDCR Configuration
        • Cross Data Center Replication Operations
        • CDCR API
      • SolrCloud Autoscaling
        • Overview of SolrCloud Autoscaling
        • Autoscaling Policy and Preferences
        • SolrCloud Autoscaling Triggers
        • SolrCloud Autoscaling Trigger Actions
        • SolrCloud Autoscaling Listeners
        • SolrCloud Autoscaling Automatically Adding Replicas
        • SolrCloud Autoscaling Fault Tolerance
        • Autoscaling API
        • Migrating Rule-Based Replica Rules to Autoscaling Policies
      • Colocating Collections
    • Legacy Scaling and Distribution
      • Introduction to Scaling and Distribution
      • Distributed Search with Index Sharding
      • Index Replication
      • Combining Distribution and Replication
      • Merging Indexes
    • Circuit Breakers
    • Solr Plugins
      • Lib Directories and Directives
      • Package Management
        • Package Manager Internals
      • Adding Custom Plugins in SolrCloud Mode
    • The Well-Configured Solr Instance
      • Configuring solrconfig.xml
        • DataDir and DirectoryFactory in SolrConfig
        • Schema Factory Definition in SolrConfig
        • IndexConfig in SolrConfig
        • RequestHandlers and SearchComponents in SolrConfig
        • InitParams in SolrConfig
        • UpdateHandlers in SolrConfig
        • Query Settings in SolrConfig
        • RequestDispatcher in SolrConfig
        • Update Request Processors
        • Codec Factory
      • Solr Cores and solr.xml
        • Format of solr.xml
        • Defining core.properties
        • CoreAdmin API
        • Configsets
      • Resource Loading
      • Configuration APIs
        • Blob Store API
        • Config API
        • Request Parameters API
        • Managed Resources
      • Implicit RequestHandlers
      • 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
      • Distributed Solr Tracing
    • Securing Solr
      • Configuring Authentication, Authorization and Audit Logging
        • Basic Authentication Plugin
        • Hadoop Authentication Plugin
        • Kerberos Authentication Plugin
        • Rule-Based Authorization Plugins
        • JWT Authentication Plugin
      • Enabling SSL
      • Audit Logging
      • ZooKeeper Access Control
      • Security UI
    • Client APIs
      • Introduction to Client APIs
      • Choosing an Output Format
      • Using SolrJ
      • Using JavaScript
      • Using Python
      • Using Solr From Ruby
      • Other Clients
    • Further Assistance
    • Solr Glossary
    • Errata
    • How to Contribute to Solr Documentation
    Solr 8.11
    • Solr Website
    • Other Formats
      • Archived PDFs
      • Other Versions Online
    • Solr Resources
      • Solr Javadocs
      • Lucene/Solr Source Code
      • Solr Community Links

    Welcome to Apache Solr™, the open source solution for search and analytics.

    Solr is the fast open source search platform built on Apache Lucene™ that provides scalable indexing and search, as well as faceting, hit highlighting and advanced analysis/tokenization capabilities. Solr and Lucene are managed by the Apache Software Foundation.

    This Reference Guide is the official Solr documentation, written and published by Lucene/Solr committers.

    Download Solr

    The Guide includes the following sections:

    Getting Started with Solr

    The Getting Started section guides you through the installation and setup of Solr. A detailed tutorial for first-time users shows many of Solr’s features.

    Using the Solr Administration User Interface: This section introduces the Web-based interface for administering Solr. From your browser you can view configuration files, submit queries, view logfile settings and Java environment settings, and monitor and control distributed configurations.

    Deploying Solr

    Deployment and Operations: Once you have Solr configured, you want to deploy it to production and keep it up to date. This section includes information about how to take Solr to production, run it in HDFS or AWS, and information about upgrades and managing Solr from the command line.

    Monitoring Solr: Solr includes options for keeping an eye on the performance of your Solr cluster with the web-based administration console, through the command line interface, or using REST APIs.


    Indexing Documents

    Indexing and Basic Data Operations: This section describes the indexing process and basic index operations, such as commit, optimize, and rollback.

    Documents, Fields, and Schema Design: This section describes how Solr organizes data in the index. It explains how a Solr schema defines the fields and field types which Solr uses to organize data within the document files it indexes.

    Understanding Analyzers, Tokenizers, and Filters: This section explains how Solr prepares text for indexing and searching. Analyzers parse text and produce a stream of tokens, lexical units used for indexing and searching. Tokenizers break field data down into tokens. Filters perform other transformational or selective work on token streams.

    Searching Documents

    Searching: This section presents an overview of the search process in Solr. It describes the main components used in searches, including request handlers, query parsers, and response writers. It lists the query parameters that can be passed to Solr, and it describes features such as boosting and faceting, which can be used to fine-tune search results.

    Streaming Expressions: A stream processing language for Solr, with a suite of functions to perform many types of queries and parallel execution tasks.

    Client APIs: This section tells you how to access Solr through various client APIs, including JavaScript, JSON, and Ruby.


    Scaling Solr

    SolrCloud: This section describes SolrCloud, which provides comprehensive distributed capabilities.

    Legacy Scaling and Distribution: This section tells you how to grow a Solr distribution by dividing a large index into sections called shards, which are then distributed across multiple servers, or by replicating a single index across multiple services.

    Circuit Breakers: This section talks about circuit breakers, a way of allowing a higher stability of Solr nodes and increased service level guarantees of requests that are accepted by Solr.

    Advanced Configuration

    Securing Solr: When planning how to secure Solr, you should consider which of the available features or approaches are right for you.

    The Well-Configured Solr Instance: This section discusses performance tuning for Solr. It begins with an overview of the solrconfig.xml file, then tells you how to configure cores with solr.xml, how to configure the Lucene index writer, and more.


    ©2021 Apache Software Foundation. All rights reserved.
    Site Version: 8.11
    Site last generated: 2021-11-16

    Apache Solr