[Koha] Configuring Koha to expose Z39.50/SRU services

[Magnus Enger]

Hi, all!

According to the documentation at
http://koha.org/documentation/faq/could-someone-tell-me-the-exact-steps-i-need-to-take-to-configure-zebra-to-expose-my-koha-3-db-as-a-public-z39.50-service
configuring Koha/Zebra to expose Z39.50/SRU services should be as
simple as changing

<!-- <listen id="publicserver" >tcp:@:9999</listen> -->

to

<listen id="publicserver" >tcp:@:9999</listen>

in koha-conf.xml.

In my experience it has not been that simple. Just doing the above
gives a 404 not found message from Zebra.

What I have found to work is to copy the server- and
serverinfo-elements for biblioserver, and replacing biblioserver with
publicserver, so I get both

 <server id="biblioserver"  listenref="biblioserver">
   <directory>/var/lib/koha/zebradb/biblios</directory>
   <config>/etc/koha/zebradb/zebra-biblios.cfg</config>
   <cql2rpn>/etc/koha/zebradb/pqf.properties</cql2rpn>
    <!-- <docpath>xsl</docpath> -->
    <!-- <stylesheet>xsl/default.xsl</stylesheet> -->
    <!-- <maximumrecordsize>2000000</maximumrecordsize> -->
    <retrievalinfo>
 ...
    </retrievalinfo>
   <xi:include href="/etc/koha/zebradb/explain-biblios.xml"
               xmlns:xi="http://www.w3.org/2001/XInclude">
     <xi:fallback>
     <explain xmlns="http://explain.z3950.org/dtd/2.0/">
         <serverInfo>
           <host>localhost</host>
           <port>9998</port>
           <database>biblios</database>
         </serverInfo>
       </explain>
     </xi:fallback>
   </xi:include>
 </server>
 <serverinfo id="biblioserver">
       <ccl2rpn>/etc/koha/zebradb/ccl.properties</ccl2rpn>
       <user>****</user>
       <password>****</password>
 </serverinfo>

and

 <server id="publicserver"  listenref="publicserver">
   <directory>/var/lib/koha/zebradb/biblios</directory>
   <config>/etc/koha/zebradb/zebra-biblios.cfg</config>
   <cql2rpn>/etc/koha/zebradb/pqf.properties</cql2rpn>
    <!-- <docpath>xsl</docpath> -->
    <!-- <stylesheet>xsl/default.xsl</stylesheet> -->
    <!-- <maximumrecordsize>2000000</maximumrecordsize> -->
    <retrievalinfo>
 ...
    </retrievalinfo>
   <xi:include href="/etc/koha/zebradb/explain-biblios.xml"
               xmlns:xi="http://www.w3.org/2001/XInclude">
     <xi:fallback>
     <explain xmlns="http://explain.z3950.org/dtd/2.0/">
         <serverInfo>
           <host>localhost</host>
           <port>9998</port>
           <database>biblios</database>
         </serverInfo>
       </explain>
     </xi:fallback>
   </xi:include>
 </server>
 <serverinfo id="publicserver">
       <ccl2rpn>/etc/koha/zebradb/ccl.properties</ccl2rpn>
       <user>****</user>
       <password>****</password>
 </serverinfo>

(Here are the same examples with a bit of formatting, if the above
fails: http://wiki.biblab.no/index.php/Hvordan_aktivisere_Z39.50_og_SRU_i_Koha)

Has anyone else had the same experience, or found some other workaround?

Regards,
Magnus
libriotech.no