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! If the file is not in that path the steps to created is in the next section.

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