Solr

Install and manage Apache Solr instances for different use cases.

Warning

Due to dependencies to different Java versions, running Solr version 6 with other, older instances is not supported

TYPO3

To install Solr for TYPO3, use the solr::webappv6 configuration.

Configuration

ensure

present enable Solr instance
absent disable Solr instance and remove all its data and configuration
default: present

solrVersion

Version of Apache Solr to be installed.

default: 6.6.1

extVersion

Version of TYPO3 Solr to be installed.

default: 7.0.1

port

By default, Solr will listen on port 8983. If you have multiple instances, or want to use a different port for other reasons, use the port parameter to specify the corresponding TCP port.

Hint

Solr will listen on the localhost interface only. If you need to expose Solr for external access, please use a website service (proxy type), and make sure access is allowed only by basic or ip address auth

memory_ratio

By default, a memory_ratio of 4 is used, which means Solr will take up to 25% of this servers total memory.

monitoring

true monitor Solr instance locally (Monit) and externally (HTTP check to Solr status)
false do not monitor Solr instance at all
default: true

Full example

{
  "solr::webappv6": {
    "name": {
      "ensure": "present",
      "solrVersion": "6.6.1",
      "extVersion": "7.0.1",
      "port": "8983",
      "memory_ratio": "4",
      "monitoring": "true"
    }
  }
}

Solr Admin

The Solr admin interface is reachable on http://localhost:port. To access Solr externally, please use a website service (proxy type), and make sure access is allowed only by basic or ip address auth. If the webapplication using Solr is installed on the same server, best practice is to let Solr run on localhost only and access Solr admin for management purposes by forwarding the corresponding port through SSH.

Add core

To add new core for a certain site or language, use the following URL:

http://localhost:8983/solr/admin/cores?action=CREATE&name=<core-name>&configSet=<version>&schema=<language>/schema.xml

name: name of the new core
configSet: desired template as provided within the Resources/Private/Solr/configsets/ folder in TYPO3 Solr, e.g. ext_solr_7_0_0
schema: <language>/schema.xml as provided within the Resources/Private/Solr/configsets/<version>/conf/ folder in TYPO3 Solr, e.g. german/schema.xml

For details, please consult the TYPO3 Solr Documentation.