solr_installer.md

As of 26/02/20, here's how I install & configure a search box on a djangocms (& djangocms-blog) project using solr:

0. Make sure to have a fully functional django + djangocms + djangocms-blog project (see djangocms-blog installer).

1. Install django-haystack & aldryn-search

   1. Run:

      pipenv install git+https://github.com/django-haystack/django-haystack#egg=django-haystack
      

      Edit 26/02/2020: aldryn-search 1.1.0 is out and support django 2! Install it using official pypi package!

      pipenv install aldryn-search
      

   2. Add this to INSTALLED_APPS (in mydumbproject/settings.py) (see doc):

          'haystack',
          'aldryn_common',
          'aldryn_search',
          'standard_form',
          'spurl',
      

   3. Add this in mydumbproject/settings.py (see doc):

      HAYSTACK_CONNECTIONS = {
          'default': {
              'ENGINE': 'haystack.backends.solr_backend.SolrEngine',
              'URL': 'http://127.0.0.1:8983/solr/tester',
              'ADMIN_URL': 'http://127.0.0.1:8983/solr/admin/cores'
          },
      }
      

2. Install solr

   0. Install java 8 openjdk (sudo apt-get install openjdk-8-jre) since solr 6.6.6 won't run with java 11 openjdk. You can select the default java version with sudo update-alternatives --config java.

   1. Run (see doc):

      curl -LO https://archive.apache.org/dist/lucene/solr/6.6.6/solr-6.6.6.tgz
      mkdir solr
      tar -C solr -xf solr-6.6.6.tgz --strip-components=1
      cd solr
      ./bin/solr start
      ./bin/solr create -c tester -n basic_config
      

   2. Run pipenv install pysolr

   3. Follow the instructions here (kinda unclear sometimes)

      OR
      Follow these 3 steps:

      1. Run py manage.py build_solr_schema --configure-directory=../solr/server/solr/tester/conf/

         (haystack will replace new schemaless mode by old schema mode, ie will update ../solr/server/solr/tester/conf/solrconfig.xml with new values, and will rename managed-schema to schema.xml)

      2. Run these commands:

         We need the actual schema.xml file to be discovered by Haystack (we need to override default schema.xml). This can be done by copying the schema.xml inside a templates/search_configuration folder.

         mkdir templates
         mkdir templates/search_configuration
         cp ../solr/server/solr/tester/conf/schema.xml templates/search_configuration/solr.xml
         

      3. Run py manage.py rebuild_index

         This will require having at least one entry in the ALLOWED_HOSTS parameter (set it to "*" if you want).

3. Create a new, empty page on your website (screenshot)

4. Go on page, then click on advanced settings (screenshot)

5. Select aldryn search in Application list (screenshot)

6. You now should have a working basic search input on your page (screenshot)

7. 

---

Features

• OR statement (using |) - screenshot
• coming soon

---

8. Optional - Ignore accents in search

9. Optional - Enable fuzzy search