Bureaucrats, confirmed, Administrators
4,558
edits
Changes
Adds dependency version table
== Elasticsearch for MediaWiki ==
To improve the out-of-the-box search experience with MediaWiki, you should install the [[mw:Extension:CirrusSearch]]. CirrusSearch is just a connector to the Elasticsearch engine. Thus, to use CirrusSearch, first install the [[Elasticsearch]] system (you can use [https:<code>yum</code> or <code>apt</www.elastic.co/guide/en/elasticsearch/reference/current/setup-repositories.html the code> repositories for that]).
Wikitech gives some information about how WMF uses Elasticsearch at https://wikitech.wikimedia.org/wiki/Search
; CirrusSearch : CirrusSearch is a MediaWiki extension that provides search support backed by Elasticsearch.
; Elasticsearch : is a Java application, so you need [[Java]] installed as well. At the time of this writing, there is a version mismatch. Elasticsearch is at version 2.1.1 in the repositories, but CirrusSearch is only compatible with the older 1.7 version. ''This is old information. There are newer versions for all components, and you must be sure to take heed of the requirements for matching the right versions together to compose your full setup.''
== Upgrading ==
Old versions of Meza run the legacy REL1_27 release of MediaWiki, while the "beta" Meza runs REL1_28. Our goal should be to run "stable" REL1_29 asap.
{| class="wikitable"
|+ Version Dependencies
|-
! MediaWiki !! ElasticSearch !! Elastica !! CirrusSearch
|-
| REL1_27 || 1.x || REL1_27 || REL1_27
|-
| REL1_28 || 2.x || REL1_28 || REL1_28
|-
| REL1_29 || 5.3+ || REL1_29 || REL1_29
|}
With version 6.0 of ElasticSearch being released, we should immediately upgrade MediaWiki to REL1_29 which is compatible with the new ElasticSearch.
Elastic Co. provides an [https://github.com/elastic/ansible-elasticsearch/tree/master ansible role to manage your installation] (including a [https://github.com/elastic/ansible-elasticsearch/tree/2.x 2.x branch] for older setups). Their [https://www.elastic.co/guide/en/elasticsearch/reference/6.0/setup-upgrade.html guide to upgrading] covers the nitty gritty.
== Installation ==