Additional Data

In some instances, this book also references additional datasets which the Quick Start - The 5 Steps, and the Getting Started sections do not explicitly include commands and instructions for setting up.  Some references are made to the additional data whilst working through this book, whilst not necessary to have the datasets indexed, they showcase additional functionality which may be of use.

The steps are the same for any data set once the Solr search server has been set up, quick instructions are included for your reference.

All Data Panl Server

There is an additional Panl configuration file located at sample/panl/all/panl.properties which, once all additional data has been indexed (including the Book Store Walkthrough Example), will provide access to all CaFUPs.  Remember: Panl was designed to have multiple CaFUPs connecting to multiple Solr collections.

Simple Date

The simple-date sample collection includes randomly generated dates from NOW to  approximately +/- 10 years from the date of writing this book to test the DATE range functionality and faceting.

The Simple Data dataset provides additional examples for the following Panl configuration functionality:

  1. DATE range facets

Creating and Indexing the Data

If you come across any problems, the best thing to do is to reset the entire installation and start again, however this is generally not needed.

Windows Commands

Command(s)

cd SOLR_INSTALL_DIRECTORY

bin/solr create -c simple-date -d ↩
PANL_INSTALL_DIRECTORY/sample/solr/simple-date/ -s 2 -rf 2

bin/solr post -c simple-date ↩
PANL_INSTALL_DIRECTORY/sample/data/simple-date/simple-date.json


*NIX Commands

Command(s)

cd SOLR_INSTALL_DIRECTORY

bin\solr create -c simple-date -d ↩
PANL_INSTALL_DIRECTORY\sample\solr\simple-date\ -s 2 -rf 2

bin\solr post -c simple-date ↩
PANL_INSTALL_DIRECTORY\sample\data\simple-date\simple-date.json

panl.properties File Additions

You will need to include (or update) the following line in the panl.properties file.

panl.collection.simple-date=PANL_INSTALL_DIRECTORY/sample/panl/simple-date/simple-date.panl.properties

Panl will automatically add the new CaFUPS to the Panl Results Viewer and Panl Results Explainer web apps.  Additionally it will add the collection to the Single Search Page web app.

Mechanical Pencils OR Facet

The mechanical-pencils-or sample collection includes configuration that configures the brand facet as an OR facet so that more than one brand may be selected for the facet.

Creating and Indexing the Data

This is a Panl configuration change, not a Solr configuration change and connects to the existing mechanical-pencils Solr collection and data which has been setup.

Nothing needs to be done for the Solr server configuration as it already holds the collection.  This is just a simple example of how Panl can present different faceting information without having to re-index the data.

panl.properties File Additions

You will need to include (or update) the following line in the panl.properties file.

panl.collection.mechanical-pencils=PANL_INSTALL_DIRECTORY/sample/panl/mechanical-pencils-or/mechanical-pencils-or.panl.properties

Notes: You may want to run both the configurations at the same time to see the differences, in which case the above configuration line would become:

panl.collection.mechanical-pencils=PANL_INSTALL_DIRECTORY/sample/panl/mechanical-pencils/mechanical-pencils.panl.properties,PANL_INSTALL_DIRECTORY/sample/panl/mechanical-pencils-or/mechanical-pencils-or.panl.properties


Panl will automatically add the new CaFUPS to the Panl Results Viewer and Panl Results Explainer web apps.

Book Store

To help understanding, and to give a bit of practice, the adding and indexing of this dataset is left as an exercise for the reader.  The next chapter will go through the complete process from idea, to data requirements, to indexing, and finally surfacing the data through Panl.

Tips: Work through the next section before indexing the data.  The process and  the background to the data provides insight into the decisions made with the data and will help you make better decisions when working through your own datasets.

~ ~ ~ * ~ ~ ~