Manybubbles has uploaded a new change for review.

  https://gerrit.wikimedia.org/r/226074

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, 84 insertions(+), 0 deletions(-)


  git pull ssh://gerrit.wikimedia.org:29418/mediawiki/extensions/CirrusSearch 
refs/changes/74/226074/1

diff --git a/README b/README
index 1bfa7c0..7f9760a 100644
--- a/README
+++ b/README
@@ -296,6 +296,90 @@
    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 sss```
+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/cdh b/puppet/modules/cdh
+index 248216f..65335f7 160000
+--- a/puppet/modules/cdh
++++ b/puppet/modules/cdh
+@@ -1 +1 @@
+-Subproject commit 248216fc71b974e99ffd8d235d8afe289703b976
++Subproject commit 65335f7d027c635065966a15a7b4467c1ce311b5
+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: newchange
Gerrit-Change-Id: I8c6860165c0bce89875400c344b629021799a684
Gerrit-PatchSet: 1
Gerrit-Project: mediawiki/extensions/CirrusSearch
Gerrit-Branch: master
Gerrit-Owner: Manybubbles <never...@wikimedia.org>

_______________________________________________
MediaWiki-commits mailing list
MediaWiki-commits@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits

Reply via email to