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.


Make a backup of the file before you start!

In the section beginning with something like

 <server id="biblioserver"  listenref="biblioserver">





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

Then after the line


add the following lines

     <xi:include href="/etc/koha/zebradb/retrieval-info-bib-dom.xml"

and after the <retrievalinfo> section that looks like this




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


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

Save the file.


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)


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


After the following part

 recordId: (bib1,Local-number)



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