Page History

...

Islandora uses Solr to make objects in your Islandora installation discoverable. The Solr search module uses an XSLT in Gsearch to index the FOXML documents in your repository, and allows you to configure search fields for searching and faceting. Whenever you add a new object in Fedora, the Solr module updates your index, and makes those results available to your users.

Solr

...

“Out of the

...

Box”

The Solr module comes with support for DC and MODS searching and faceting to support our solution packs. When Solr is installed, four additional blocks appear under administer>site building>blocks:

...

In order for Solr to work for your collections, you will have to activate the blocks that you want, and configure them to display your desired results. The following instructions will show you how to configure Solr to work with solution packs. Additional information about installing Solr and how Islandora uses Solr is provided in Chapter 9 - Enabling Indexing & Searching with Solr. Additional information about customizing Islandora's Islandora’s Solr Search Module is provided in Chapter 7 - Customizing Islandora.

1. Navigate to the Configuration Panel

Start by going to the 'Administer' ‘Administer’ page and click on the 'Islandora ‘Islandora Solr Client' Client’ link under 'Site ‘Site Configuration.'’

2. Verify the Solr URL and Request Handler

The Solr URL should be ip.address.of.site:port/solr. So, for example, if you're you’re using the Islandora Virtual Machine Image, your Solr URL should be 192.168.56.195:8080/solr. If the URL is correct you will see a green check mark.

...

Make sure the request handler is set to 'standard'‘standard’. You can customize the request handler by editing solrconfig.xml to make other request handlers available. This assumes that you are using the default request handler, which will support all the metadata in our solution packs.

You can also restrict your search results to a particular namespace. This is useful if there are multiple sites using the same repository and you want to block search results from the other sites. Remember that the namespace is the first half of the PID – everything before the colon.

3. Set the Default and Secondary Display Profiles

You can modify the way results are displayed by configuring the default display profile. You can choose from Fields (default), Maps, and Simple Table. Switching back and forth between different display profiles is simple, so feel free to experiment and see which profile best suits your site.

...

Here you can choose the search terms that will appear in the drop-down menus on the search block. Terms must be entered by their field names (in most cases this will be Dublin Core), though you can optionally specify a more human-readable label.To determine the appropriate syntax for your search terms, simply edit the metadata on any object in your repository (for instructions, see How to Edit an Object's Object’s Metadata in Chapter 3 - Getting Started with Islandora). Each field label will display the proper syntax for adding it to your Solr search configuration. A full list of the terms made available by the schema provided in the module package is provided in APPENDIX D - SOLR SCHEMA (SEARCH) Term Reference. Note that you will want to use fields that have been indexed as "text" “text” here.

dc.title ~ Title
dc.subject ~ Subject
PID ~ PID
type ~ Type

6. Choose Facet Fields

Solr uses faceting to filter search results. Here, you can choose which fields you wish to allow faceting on. The format is the same as the search terms described above.

Note that you will want to use terms here that have been indexed as "strings" “strings” (see Appendix).

7. Define Labels for Your Search Results

You may not want to display every search-able field in the list of search results. Here, you can determine what labels will be used for fields in the list of results, and also which fields will display with search results. The format is the same as the search terms and facet fields described above. You can limit search results to this set of terms of selecting the 'Limit ‘Limit results to these fields?' ’ box.

Note that you will have to put the PID field in if you want a link back to the object from the search results. This means that configuring PID as one of the fields, particularly in your results is strongly recommended.

8. Minimum/Maximum Facet Fields and Results per Page

These options let you control the minimum number of facets that must be available in order to display them to the user, and the maximum number of fields to display in the facet block. A negative maximum number will indicate unlimited fields. You can also limit the number of results to display per page.

9. Advanced Solr Query Configuration for Site Administrators

...

• Solr Default Query: This option allows you to specify a default query used to browse results when no explicit query has been entered. For example, if a user runs a search and then deletes their search term from the breadcrumbs, this default query will be applied in its place.
• Solr Base Filter: You can use this option as a blanket way to filter all Solr search queries. For example, you can apply date-based or collection-based restrictions. For more information on Solr, see the Solr Reference Guide.

You have successfully configured your Solr client.