Switching to dom indexing

From Koha Wiki

Jump to: navigation, search
Home > Documentation
Home > Documentation > Installation
Home > Documentation > Search Engine > Zebra
Koha > Technical > Administration

If you started using Koha before 3.14, your system may still be using GRS1 indexing. You have to make a few changes to koha-conf.xml if you want to switch to DOM indexing. The following should work for a package installation. If you have done personalization (for example add/modify an index) you need to port your modifications in standard dom configuration.

koha-conf.xml

Make a backup of the file before you start!

In the section beginning with something like

 <server id="biblioserver"  listenref="biblioserver">
     <directory>/var/lib/koha/koha/biblios</directory>

change

     <config>/etc/koha/sites/koha/zebra-biblios.cfg</config>

to

     <config>/etc/koha/sites/koha/zebra-biblios-dom.cfg</config>

(the only important thing is adding '-dom' to the filename. if your path is different, keep it that way!)

Then after the line

     <cql2rpn>/etc/koha/zebradb/pqf.properties</cql2rpn>

add the following lines

     <xi:include href="/etc/koha/zebradb/retrieval-info-bib-dom.xml"
                 xmlns:xi="http://www.w3.org/2001/XInclude">
     <xi:fallback>

and after the <retrievalinfo> section that looks like this

      <retrievalinfo>
        …
      </retrievalinfo>

include

      </xi:fallback>
      </xi:include>

At the end of the file, right before </config>, include

 <zebra_bib_index_mode>dom</zebra_bib_index_mode>
 <zebra_auth_index_mode>dom</zebra_auth_index_mode>
 <use_zebra_facets>1</use_zebra_facets>

(or change the values to the ones shown here, if the entries are already in the file.)

Save the file.


zebra-biblios.cfg

On a package installation, the correct zebra-biblios-dom.cfg is already present these days. If you installed in a different way, you also have to change this configuration file to use DOM.

Copy zebra-biblios.cfg to zebra-biblios-dom.cfg and open zebra-biblios-dom.cfg

At the end of the line beginning with

 profilePath …

append (to the same line)

 :/etc/koha/zebradb/xsl

Comment out the GRS1-related things

 # Can use -g iso2709 to batch index raw iso2709 records in a single or
 # multiple files, or marcxml records that are split into separate files
 # the trailing .record tells zebraidx to use record.abs
 # iso2709.recordType:grs.marcxml.record
 
 # Can use -g marcxml to batch index marcxml files
 # zebraidx uses record.abs because of <record> is the root element
 # marcxml.recordType:grs.sgml
 
 # Koha uses grs.xml internally when updating a single record, no idea
 # why it knows to use record.abs
 # recordType:grs.xml

and insert

 recordtype:dom./etc/koha/zebradb/biblios/etc/dom-config.xml
 marcxml.recordtype:dom./etc/koha/zebradb/biblios/etc/dom-config.xml
 iso2709.recordtype:dom./etc/koha/zebradb/biblios/etc/dom-config-marc.xml

After the following part

 recordId: (bib1,Local-number)
 storeKeys:1
 storeData:1

add

 facetNumRecs:1000

And save the file.

Restart Zebra with

 koha-restart-zebra instancename

Rebuild Zebra with

 koha-rebuild-zebra -f -v instancename

In the staff client, open About Koha > System information and check that there are no GRS1/DOM-related warnings.

Personal tools