Differences

This shows you the differences between two versions of the page.

--- indexing:solrmarc [2016/04/18 12:48] – [Compiled Custom Functions] demiankatz
+++ indexing:solrmarc [2016/12/16 13:56] – [Upgrading SolrMarc] demiankatz
@@ Line 1: / Line 1: @@
 ====== SolrMarc ======
-SolrMarc is used to import MARC metadata to the "biblio" index on Solr used by VuFind.  See [[development:architecture:solr_index_schema|Solr Index Schema]] for notes on the layout of the index.
+[[https://github.com/solrmarc/solrmarc|SolrMarc]] is used to import MARC metadata to the "biblio" index on Solr used by VuFind.  See [[development:architecture:solr_index_schema|Solr Index Schema]] for notes on the layout of the index.
-===== Upgrading SolrMarc =====
+===== SolrMarc Versions =====
-There should rarely be a need to do so, but if you wish, you can update to the latest version of the tool, available [[http://code.google.com/p/solrmarc/|here]].  Instructions on setting up SolrMarc with VuFind are available [[http://code.google.com/p/solrmarc/wiki/VufindHowTo|here]].
+VuFind's [[:changelog|changelog]] can help you determine which version of SolrMarc you are currently running.
+:!: Prior to VuFind 3.1, SolrMarc 2.x was used. With the introduction of SolrMarc 3.x, many performance benefits and enhanced features became available.
+Users are strongly encouraged to upgrade to VuFind 3.1 or later in order to take advantage of the improved indexing tool. Manually installing the new SolrMarc in an earlier version of VuFind should also be possible with relatively minimal work by replacing the necessary .jar files and adapting the revised indexing scripts found in later releases.
+Manually upgrading SolrMarc to a later 3.x version is simply a matter of updating import/solrmarc-core.jar and any necessary dependencies found in import/lib.
 ===== Customizing Import Mappings =====
@@ Line 30: / Line 36: @@
 By default, formats are generated using the getFormat function built into SolrMarc.  However, the logic used by getFormat is also replicated in a BeanShell script packaged with VuFind.  If you want to customize the behavior, here are the steps to follow:
-  - Copy import/index_scripts/format.bsh into your [[configuration:local_settings_directory|local settings directory]] and edit it to customize the behavior as needed.  BeanShell borrows its syntax and libraries from Java, so the code should look familiar to many developers.  The MARC access is accomplished with the [[http://marc4j.tigris.org/|MARC4J]] library.
+  - Copy import/index_scripts/format.bsh into the import/index_scripts subdirectory of your [[configuration:local_settings_directory|local settings directory]] and edit it to customize the behavior as needed.  BeanShell borrows its syntax and libraries from Java, so the code should look familiar to many developers.  The MARC access is accomplished with the [[http://marc4j.tigris.org/|MARC4J]] library.
   - If your new custom script returns different values than the old script, or if you want to change the way the existing values are mapped into your index, edit a local copy of the translation map found in import/translation_maps/format_map.properties.
   - Uncomment the format line (format = script(format.bsh), getFormat, format_map.properties) in a local copy of import/marc_local.properties to ensure that VuFind imports using the custom BeanShell version of getFormat instead of the built-in SolrMarc version.
@@ Line 48: / Line 54: @@
 </code>
+More details can be found [[https://code.google.com/archive/p/solrmarc/wikis/WritingCustomScripts.wiki|here]].
 ==== SolrMarc Mixins ====