jenkins-bot has submitted this change and it was merged.
Change subject: Instructions for validating a new ES
......................................................................
Instructions for validating a new ES
We validate new Elasticsearch versions with MediaWiki-Vagrant and it takes a
little bit of fiddling to get that working. So instructions!
Change-Id: I8c6860165c0bce89875400c344b629021799a684
---
M README
1 file changed, 77 insertions(+), 0 deletions(-)
Approvals:
Chad: Looks good to me, approved
Cindy-the-browser-test-bot: Looks good to me, but someone else must approve
EBernhardson: Looks good to me, but someone else must approve
jenkins-bot: Verified
diff --git a/README b/README
index 1bfa7c0..1e9ebd6 100644
--- a/README
+++ b/README
@@ -296,6 +296,83 @@
namespaces.
+Validating a new version of Elasticsearch
+-----------------------------------------
+The simplest way to validate the CirrusSearch works with a new version of
Elasticsearch is to use
+MediaWiki-Vagrant. Get it setup and make sure the tests are passing (see
tests/browser/README) and
+then:
+
+1. Connect to your vagrant instance with ```vagrant ssh```
+2. Get the deb distribution of the Elasticsearch you want to validate with
+```wget
https://download.elastic.co/elasticsearch/elasticsearch/elasticsearch-1.7.0.deb```
+or something like that.
+3. Install it with ```sudo dpkg -i elasticsearch-1.7.0.deb```.
+4. Disconnect from your vagrant instance. You are done with it.
+5. Make a change like the following to MediaWiki-Vagrant:
+```
+diff --git a/puppet/modules/elasticsearch/manifests/init.pp
b/puppet/modules/elasticsearch/manifests/init.pp
+index 08bc4bd..a9fea2e 100644
+--- a/puppet/modules/elasticsearch/manifests/init.pp
++++ b/puppet/modules/elasticsearch/manifests/init.pp
+@@ -5,7 +5,7 @@
+ #
+ class elasticsearch {
+ package { 'elasticsearch':
+- ensure => '1.6.0',
++ ensure => '1.7.0',
+ }
+
+ require_package('openjdk-7-jre-headless')
+diff --git a/puppet/modules/role/manifests/cirrussearch.pp
b/puppet/modules/role/manifests/cirrussearch.pp
+index 549104a..c81a22f 100644
+--- a/puppet/modules/role/manifests/cirrussearch.pp
++++ b/puppet/modules/role/manifests/cirrussearch.pp
+@@ -16,19 +16,19 @@ class role::cirrussearch {
+ ## Analysis
+ elasticsearch::plugin { 'icu':
+ name => 'elasticsearch-analysis-icu',
+- version => '2.6.0',
++ version => '2.7.0',
+ }
+ elasticsearch::plugin { 'kuromoji':
+ name => 'elasticsearch-analysis-kuromoji',
+- version => '2.6.0',
++ version => '2.7.0',
+ }
+ elasticsearch::plugin { 'stempel':
+ name => 'elasticsearch-analysis-stempel',
+- version => '2.6.0',
++ version => '2.7.0',
+ }
+ elasticsearch::plugin { 'smartcn':
+ name => 'elasticsearch-analysis-smartcn',
+- version => '2.6.0',
++ version => '2.7.0',
+ }
+ elasticsearch::plugin { 'hebrew':
+ # Less stable then icu plugin
+@@ -39,13 +39,13 @@ class role::cirrussearch {
+ elasticsearch::plugin { 'highlighter':
+ group => 'org.wikimedia.search.highlighter',
+ name => 'experimental-highlighter-elasticsearch-plugin',
+- version => '1.6.0',
++ version => '1.7.0',
+ }
+ ## Trigram accelerated regular expressions, "safer" query, and friends
+ elasticsearch::plugin { 'extra':
+ group => 'org.wikimedia.search',
+ name => 'extra',
+- version => '1.6.0',
++ version => '1.7.0',
+ }
+
+```
+6. Run ```vagrant provision```. You should notice it installing new
Elasticsearch plugins
+but not installing a new Elasticsearch - you already did that. It'll restart
Elasticsearch
+to pick up the new plugins.
+7. Run the integration test suite again.
+
+
Licensing information
---------------------
--
To view, visit https://gerrit.wikimedia.org/r/226074
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings
Gerrit-MessageType: merged
Gerrit-Change-Id: I8c6860165c0bce89875400c344b629021799a684
Gerrit-PatchSet: 4
Gerrit-Project: mediawiki/extensions/CirrusSearch
Gerrit-Branch: master
Gerrit-Owner: Manybubbles <never...@wikimedia.org>
Gerrit-Reviewer: Chad <ch...@wikimedia.org>
Gerrit-Reviewer: Cindy-the-browser-test-bot <bernhardsone...@gmail.com>
Gerrit-Reviewer: DCausse <dcau...@wikimedia.org>
Gerrit-Reviewer: EBernhardson <ebernhard...@wikimedia.org>
Gerrit-Reviewer: Manybubbles <never...@wikimedia.org>
Gerrit-Reviewer: jenkins-bot <>
_______________________________________________
MediaWiki-commits mailing list
MediaWiki-commits@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
