X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fusing.xml;h=baff0885193b3eefcf0a55760dfd224b0093bb99;hb=786049a183f8872c8bf1136eb0c74e48d7725f98;hp=f6106f8aa71cfceb6166b3db83cfd8d653041d6e;hpb=101d9c2ca072f3cd7fb6cb89c67573318b14b8c1;p=yazproxy-moved-to-github.git
diff --git a/doc/using.xml b/doc/using.xml
index f6106f8..baff088 100644
--- a/doc/using.xml
+++ b/doc/using.xml
@@ -5,16 +5,10 @@
This chapter includes a few examples.
- -- All config directives --
- -- SRW/SRU ..
- -- Example config
- -- Mention XSLT conversion
-
-
The YAZ Proxy is useful for debugging SRW/SRU/Z39.50 software, logging
APDUs, redirecting Z39.50 packages through firewalls, etc.
Furthermore, it offers facilities that often
- boost performance for connectionless Z39.50 clients such
+ boost performance for connection-less Z39.50 clients such
as web gateways.
@@ -25,7 +19,7 @@
except any log files you ask for.
-
+ Using the Proxy to Log APDUs
Suppose you use a commercial Z39.50 client for which you do not
@@ -126,6 +120,116 @@
]]>
+
+
+ Using a configuration file
+
+ In the default backend server
+ was specified by a command line option. The same proxy behavior can
+ be achieved by creating a configuration with the following contents:
+
+
+
+ foo.bar.com:18398
+ client-apdu
+
+
+
+
+]]>
+
+
+
+ The proxy is started with
+
+
+
+
+ The last target section is used for all servers except foo.
+ Had the the last section been omitted, then
+ only foo could be reached via the proxy.
+
+
+
+
+ Offering SRW/SRU/Z39.50 service
+
+ In order to offer SRW/SRU service we must be specify sufficient
+ information to allow the proxy to convert from SRW/SRU to Z39.50.
+ This involves translating CQL queries
+ to Type-1 (also called RPN/PQF), since most
+ Z39.50 servers do not support CQL. The conversion
+ is specified by the cql2rpn element.
+
+
+ We must also ensure that the
+ server can return at least one kind of XML record (Dublin-Core
+ recommended).
+
+
+ An explain record for the SRW/SRU service must also be created.
+
+
+ The following is a relatively simple configuration file for
+ such a service. This service lives on indexdata.dk,
+ port 9000. The database is gils. The
+ backend server is also indexdata.dk (port 210) as
+ given by url.
+
+
+ The server may return USMARC/MARC21 (Z39.50/SRW/SRU) and
+ MARCXML (SRW/SRU only) as specified by the
+ syntax elements.
+
+
+
+
+
+ indexdata.dk
+ 240
+ 180
+
+
+
+
+
+ marcxml
+
+
+ 0
+
+
+ indexdata.dk
+ 9000
+ gils
+
+
+ pqf.properties
+
+
+]]>
+
+
+ The conversion from CQL to RPN is specified by a file whose name,
+ relative to the working directory, is given in the
+ cql2rpn element.
+ A complete Bath/DC conversion file,
+ pqf.properties is provided as part of the
+ yazproxy distribution in the etc
+ subdirectory.
+
+
+ Explain information is embedded in the configuration file.
+ Note that in this example,only a few mandatory
+ explain elements are specified. A well-behaving server should describe
+ index sets, indexes, record schemas as well.
+
+