Installation.md

Solr and Corona Installation

Prerequisites

1. Install Solr

• download http://archive.apache.org/dist/lucene/solr/8.0.0/solr-8.0.0.tgz (or newest version)
• unzip and move solr-8.0.0 to put solr home folder in you $HOME directory or any place (outside your clojure project)
• go to solr-8.0.0/server/solr and copy solr.xml.
• paste it in your solr home dir (e.g. ~/solr-8.0.0)

Note: If you also want to index your sql database to solr, you can either rely on corona.index ns and use your favorite clojure sql library to fetch data to index (recommended), or use the Solr Data Importer plugin in which case you'll need extra installation steps: https://github.com/Stylitics/corona/blob/master/doc/Data-Import.md

2. set SOLR_HOME env var to point to solr home dir

For this library to work properly, you need to set SOLR_HOME var pointing to solr home folder you just installed.

For MAC users: You can put the following in your ~/.bash_profile file source ./.profile Then, put the following in your ~/.profile file

#Solr
export SOLR_HOME="$HOME/solr-8.0.0" # put right version here
export SOLR_ULIMIT_CHECKS=false

For Emacs users:

• MAC users: you may need to add setenv SOLR_HOME /my/path/to/solr/home to your /etc/launchd.conf file
• or install [exec-path-from-shell](https://github.com/purcell/exec-path-from-shell package allowing you to read env variables from emacs GUI
• or simply put these in your init.el:

(setenv "SOLR_HOME" "/my/path/to/solr/home")
(setenv "SOLR_ULIMIT_CHECKS" "false")

3. Add corona library in project.clj

4. Add Solr resources to your project

You can either:

• go to the https://github.com/Stylitics/corona-demo repo and copy resources/solr/tmdb changing tmdb for the name of you core (or index)

• look at examples inside your solr home dir.

NOTE: If you start from existing example, make sure, in your $CLJ_PROJECT_HOME/resources/solr/<core-name>/conf/solrconfig.xml file contains right maching lucene version <luceneMatchVersion>8.0.0</luceneMatchVersion>

5. Test solr

From command line

• $ $SOLR_HOME/bin/solr start -p 8983
• access Solr admin from your browser: http://localhost:8983/solr/
• $ $SOLR_HOME/bin/solr stop -p 8983

From clojure

For development, you can start solr from Clojure repl.

• make sure you are seeing SOLR_HOME variable. (System/getenv "SOLR_HOME")

• then:

(require '[corona.cmd :as cmd])
(cmd/exec! :start) ;; $SOLR_HOME/bin/solr start

• access Solr admin from your browser: http://localhost:8983/solr/

• stop with: (cmd/exec! :stop)