One of a series of test instances for migrating the Koha Wiki MediaWiki database.
For the current Koha Wiki, visit https://wiki.koha-community.org .Troubleshooting Koha as a Z39.50 server
From Koha Test Wiki MediaWiki Postgres
After you have configured Koha to act as a Z39.50/SRU server, there are some problems you might run into. Here are some tips for figuring them out.
Contents |
Is your config right?
If you want to make public Z39.50 server which is accessible from Internet, you need these bits, and they need to be uncommented on /etc/koha/sites/library/koha-conf.xml:
<listen id="publicserver">tcp:@:nnn</listen> <server id="publicserver" listenref="publicserver">...</server> <serverinfo id="publicserver">...</serverinfo>
Where nnn is the port you want Z39.50 to be available on (usually 210).
Is zebra running?
ps aux | grep zebra
Is the right port open in your firewall?
sudo netstat -pn --udp --listen
Did you set a password for zebra?
If so, you need to use it when you search.
Can you connect with yaz-client?
Here is quick example when using port 210 and ccl syntax which is shown in Koha queries to Zebra:
dpavlin@koha-dev:~$ yaz-client -c /etc/koha/zebradb/ccl.properties localhost:210/biblios Connecting...OK. Sent initrequest. Connection accepted by v3 target. ID : 81 Name : Zebra Information Server/GFS/YAZ Version: 4.1.7 c43e561fdfe12989a6040163dae0e28ba0a02453 Options: search present delSet triggerResourceCtrl scan sort extendedServices namedResultSets Elapsed: 0.001445 Z> querytype ccl2rpn Z> find (kw,wrdl,rtrn=human ) not Suppress=1 Sent searchRequest. Received SearchResponse. Search was a success. Number of hits: 1935, setno 1 SearchResult-1: term= human cnt=1935, term= 1 cnt=21 records returned: 0 Elapsed: 0.025643 Z> show
Zebra logs
Zebra creates log files in which you can grep for errors using something like:
dpavlin@koha-dev:~$ grep ERROR /var/log/koha/koha-zebradaemon-output.log 18:31:51-29/03 zebrasrv(1) 60cae1f5 [request] Init ERROR 1011 ID:81 Name:ZOOM-C/YAZ Version:4.1.7 c43e561fdfe12989a6040163dae0e28ba0a02453
1011 in Bib-1 Diagnostics code for which you can find descriptions at http://www.loc.gov/z3950/agency/defns/bib1diag.html
In our example, it's bad userid or password.