Difference between revisions of "Elasticsearch"
Jump to navigation
Jump to search
(Adds info about reindexing and restarting the cluster) |
|||
| Line 38: | Line 38: | ||
; Elastica : Elastica is a MediaWiki extension that provides the library to interface with Elasticsearch. It wraps the [https://github.com/ruflin/Elastica Elastica] library. It has no configuration. | ; Elastica : Elastica is a MediaWiki extension that provides the library to interface with Elasticsearch. It wraps the [https://github.com/ruflin/Elastica Elastica] library. It has no configuration. | ||
; CirrusSearch : CirrusSearch is a MediaWiki extension that provides search support backed by Elasticsearch. | ; 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. | + | ; Elasticsearch : is a Java application, so you need [[Java]] installed as well. As all these pieces continue to be developed and released, you must be sure to take heed of the requirements for matching the right versions together to compose your full setup. |
| + | == Where is my Elasticsearch? == | ||
| + | Maybe you installed elasticsearch, but have no idea where it resides on your system. Try this: | ||
| + | <source lang="bash"> | ||
| + | curl "localhost:9200/_nodes/settings?pretty=true" | ||
| + | </source> | ||
| + | |||
| + | == Starting / Stopping == | ||
| + | Elasticsearch is (usually) run as a service, so you can start and stop it the way you would depending on whether you run SysV init or SystemD | ||
== Upgrading == | == Upgrading == | ||
| Line 63: | Line 71: | ||
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. | 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. | ||
| + | |||
| + | == Reindexing == | ||
| + | |||
| + | The most basic form of the reindex API just copies documents from one index into another. You might [https://www.elastic.co/guide/en/elasticsearch/reference/6.0/docs-reindex.html reindex] to change the name of a field. Usually though, you are reindexing because you are forced to during a major version upgrade. | ||
| + | |||
| + | To assist in the upgrade process there is a plugin that assists with the tasks. | ||
| + | |||
| + | Also, you can reindex from a remote (cluster) so that you can upgrade without downtime because once the new cluster is ready, you can just switch to it with minimal disruption. | ||
| + | <ref>https://www.elastic.co/guide/en/elasticsearch/reference/6.0/reindex-upgrade.html</ref> | ||
== Installation == | == Installation == | ||
