You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tika.apache.org by Apache Wiki <wi...@apache.org> on 2017/12/15 15:54:51 UTC

[Tika Wiki] Update of "UpgradingTikaInSolr" by TimothyAllison

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Tika Wiki" for change notification.

The "UpgradingTikaInSolr" page has been changed by TimothyAllison:
https://wiki.apache.org/tika/UpgradingTikaInSolr

Comment:
checkpoint save

New page:
= Idiot's Guide to Updating Tika in Apache Solr =

This is written as an outsider to Apache Solr.  It will appear painfully rudimentary to devs on Solr, and it assumes less-than-black-belt-familiarity with git...so be it.

= Prereqs =

 1. python3 must be installed and callable as python3
 1. perl must be installed
 1. ivy must be installed: `ant ivy-bootstrap`

= Phase 1 =
 1. Fork lucene-solr
 1. Check out your local fork
 1. Make sure you're up to date
   1. `git remote add upstream https://github.com/apache/lucene-solr.git`
   1. `git fetch upstream`
   1. `git pull upstream master`
   1. 'git push master`
 1. create new branch: `git checkout -b 'jira/solr-11701`
 1. `mvn dependency:tree` on the newly released Apache Tika and memorize it
 1. upgrade all dependencies in `lucene/ivy-versions.properties` -- make sure that they are in alphabetical order
 1. add any new licenses in `solr/licenses` -- must include a -LICENSE and -NOTICE file for every jar
 1. update anything new in `solr/contrib/extraction/ivy.xml`
 1. `ant clean-jars jar-checksums`
 1. `git add` new .sha1 files in solr/licenses and lucene/licenses and `git rm` old .sha1 files
 1. `ant precommit`
 1. Receive immediate errors that you missed something and go back two steps; repeat `ant precommit` as needed, waiting 15-20 minutes if you didn't break something obvious.
 1. In my environment, `ant precommit` eventually ends in errors about broken links in html.  This means you are successful!!!

= Integration Testing Solr =
To test that you've gotten most of the dependencies right, why not run DIH on Tika's test documents?

 1. `cd solr/` and `ant package`
 1. Unzip your shiny new Solr and create a collection called ` `
 1. Place this config file in the collection
 1. `bin\solr start`
 1. Navigate to the Solr admin window->Data Import