etc/fennica.xml

   1 <?xml version="1.0"?>
   2 <!-- $Id: fennica.xml,v 1.4 2004-08-13 13:54:51 adam Exp $ -->
   3 <proxy xmlns="http://indexdata.dk/yazproxy/schema/0.8/"
   4  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   5  xsi:schemaLocation="http://indexdata.dk/yazproxy/schema/0.8/ yazproxy.xsd"
   6 >
   7   <!-- define default target and name it voyager -->
   8   <target default="1" name="voyager">
   9     <!-- all backend addresses as seen from this proxy .. -->
  10     <url>193.166.7.194:11390</url>
  11
  12     <!-- set session timeout between proxy and backend target -->
  13     <target-timeout>300</target-timeout>
  14
  15     <!-- set session timeout between client and proxy.
  16     Should be lower than target-timeout -->
  17     <client-timeout>180</client-timeout>
  18
  19     <!-- if either bandwidth or pdu limit is reached the session is no
  20     longer kept alive -->
  21     <keepalive>
  22       <bandwidth>500000</bandwidth>
  23       <pdu>500</pdu>
  24     </keepalive>
  25
  26     <!-- client limits .. -->
  27     <limit>
  28       <bandwidth>200000</bandwidth>
  29       <pdu>31</pdu>
  30       <retrieve>50</retrieve>
  31     </limit>
  32
  33     <!-- use attributes -->
  34     <attribute type="1" value="1-13,16,17,20,21,25,27,31,33,41,42,43,48,51,54,56,57,58,59,63,1002-1005,1007,1009,1016,1018,1027,1032,1056,1074,1078,1079,1209"/>
  35     <attribute type="1" value="*" error="114"/>
  36
  37     <!-- relation attributes -->
  38     <attribute type="2" value="3"/>
  39     <attribute type="2" value="*" error="117"/>
  40
  41     <!-- position attributes -->
  42     <attribute type="3" value="1,2,3"/>
  43     <attribute type="3" value="*" error="119"/>
  44
  45     <!-- structure attributes -->
  46     <attribute type="4" value="1,2"/>
  47     <attribute type="4" value="*" error="118"/>
  48
  49     <!-- truncation attributes -->
  50     <attribute type="5" value="1,100"/>
  51     <attribute type="5" value="*" error="120"/>
  52
  53     <!-- completeness attributes -->
  54     <attribute type="6" value="1"/>
  55     <attribute type="6" value="*" error="122"/>
  56
  57     <!-- other types -->
  58     <attribute type="*" value="*" error="113"/>
  59
  60     <!-- list allowed record syntaxes and possible schemas (if any);
  61     reject all others at the end -->
  62     <syntax type="opac"/>
  63     <syntax type="finmarc" backendtype="usmarc"/>
  64     <zsyntax type="usmarc"/>
  65     <syntax type="usmarc" backendtype="canmarc"/>
  66     <syntax type="none" backendtype="usmarc"/>
  67
  68     <syntax type="xml" marcxml="1"
  69       identifier="info:srw/schema/1/marcxml-v1.1" backendtype="canmarc"
  70       >
  71       <title>MARCXML</title>
  72       <name>marcxml</name>
  73     </syntax>
  74     <syntax type="xml" marcxml="1" stylesheet="MARC21slim2SRWDC.xsl"
  75       identifier="info:srw/schema/1/dc-v1.1"
  76       >
  77       <title>Dublin Core</title>
  78       <name>dc</name>
  79     </syntax>
  80     <syntax type="xml" marcxml="1" stylesheet="MARC21slim2MODS.xsl"
  81       identifier="http://www.loc.gov/mods"
  82       >
  83       <title>MODS v2</title>
  84       <name>mods2</name>
  85     </syntax>
  86     <syntax type="xml" marcxml="1" stylesheet="MARC21slim2MODS3.xsl"
  87       identifier="info:srw/schema/1/mods-v3.0"
  88       >
  89       <title>MODS v3</title>
  90       <name>mods3</name>
  91       <name>mods</name>
  92     </syntax>
  93
  94     <syntax type="*" error="238"/>
  95
  96     <!-- keep this number of spare sessions for future sessions -->
  97     <preinit>0</preinit>
  98
  99     <explain xmlns="http://explain.z3950.org/dtd/2.0/">
 100       <serverInfo>
 101         <host>indexdata.dk</host>
 102         <port>9000</port>
 103         <database>voyager</database>
 104       </serverInfo>
 105
 106       <databaseInfo>
 107         <title>FENNICA</title>
 108         <description lang="en" primary="true">
 109           SRW/SRU/Z39.50 Gateway to FENNICA (the Finnish National Bibliography)
 110         </description>
 111       </databaseInfo>
 112
 113       <indexInfo>
 114         <set identifier="info:srw/cql-context-set/1/cql-v1.1"
 115           name="cql"/>
 116         <set identifier="info:srw/cql-context-set/1/dc-v1.1"
 117           name="dc"/>
 118         <set identifier="http://zing.z3950.org/cql/bath/2.0/"
 119           name="bath"/>
 120
 121         <index id="4">
 122           <title>title</title>
 123           <map><name set="dc">title</name></map>
 124         </index>
 125         <index id="21">
 126           <title>subject</title>
 127           <map><name set="dc">subject</name></map>
 128         </index>
 129         <index id="1003">
 130           <title>creator</title>
 131           <map><name set="dc">creator</name></map>
 132           <map><name set="dc">author</name></map>
 133         </index>
 134
 135         <index id="1020">
 136           <title>editor</title>
 137           <map><name set="dc">editor</name></map>
 138         </index>
 139
 140         <index id="1018">
 141           <title>publisher</title>
 142           <map><name set="dc">publisher</name></map>
 143         </index>
 144
 145         <index id="62">
 146           <title>description</title>
 147           <map><name set="dc">description</name></map>
 148         </index>
 149
 150         <index id="30">
 151           <title>date</title>
 152           <map><name set="dc">date</name></map>
 153         </index>
 154
 155         <index id="1002">
 156           <title>name</title>
 157           <map><name set="bath">name</name></map>
 158         </index>
 159
 160         <index id="7">
 161           <title>isbn</title>
 162           <map><name set="bath">isbn</name></map>
 163         </index>
 164         <index id="8">
 165           <title>issn</title>
 166           <map><name set="bath">issn</name></map>
 167         </index>
 168       </indexInfo>
 169
 170       <schemaInfo>
 171         <schema identifier="info:srw/schema/1/marcxml-v1.1"
 172           sort="false" name="marcxml">
 173           <title>MARCXML</title>
 174         </schema>
 175
 176         <schema identifier="info:srw/schema/1/dc-v1.1"
 177           sort="false" name="dc">
 178           <title>Dublin Core</title>
 179         </schema>
 180
 181         <schema identifier="http://www.loc.gov/mods"
 182           sort="false" name="mods2">
 183           <title>MODS v2</title>
 184         </schema>
 185
 186         <schema identifier="info:srw/schema/1/mods-v3.0"
 187           sort="false" name="mods">
 188           <title>MODS v3</title>
 189         </schema>
 190
 191       </schemaInfo>
 192
 193       <configInfo>
 194         <default type="numberOfRecords">0</default>
 195       </configInfo>
 196     </explain>
 197    <cql2rpn>pqf.properties</cql2rpn>
 198   </target>
 199
 200
 201   <!-- maximum number of client sessions. Remember to allow for
 202      at least max-clients*2+5 sockets. Use 'ulimit -n 1040' on bash -->
 203   <max-clients>500</max-clients>
 204
 205   <!-- what we log. Allowed tokens: client-apdu, server-apdu,
 206   client-requests, server-requests -->
 207   <log>client-requests server-requests</log>
 208   <!-- commentary:
 209 Observerations on the Helsinki Voyager Server.
 210
 211 1. Observerations:
 212
 213 1.1 A client must issue different OID than effective syntax OID.
 214 To get USMARC, CanMarc must be sent. To get FINMARC, USMARC must be sent.
 215 (OID for MARC21 and USMARC are equivalent).
 216
 217 Solution: This is fixed by the 'backend' attribute for 'syntax' sections
 218 in the proxy config.
 219
 220 1.2 Attribute 1=12 seems to work - unlike the Voyager target at LoC.
 221
 222 Solution: ensure that yazproxy accepts this attribute now that it seems
 223 to work.
 224
 225 1.3 All attributes are accepted by the Server. The appropriate behavior is
 226 to return a diagnostic.
 227
 228 Solution: "attribute" sections in config is set to only accepts certain
 229 attributes. Others are rejected with a diagnostic.
 230
 231 1.4 When no preferred Record syntax is provided by a client, the Voyager
 232 server returns SUTRS record: Failed to retrieve record #x. The correct
 233 behavior is to return a default record, say USMARC. The server could also
 234 return a diagnostic, but there do not seem to be an appropriate diagnostic
 235 for that one.
 236
 237 Solution: This is fixed by the 'backend' attribute and type='none' for
 238 'syntax' sections in the proxy config.
 239
 240 1.5 Speed of initialize phase. The speed of initilization
 241 (init-request/init-response) for the the Voyager target at Helsinki
 242 seem to be acceptable.
 243
 244 Solution: No special precaution to limits/bandwidth needs to be taken.
 245
 246 1.6 Present Requests out of range. The voyager target does not return
 247 a diagnostic when a client presents a record at a position out of the
 248 range of a result set.
 249
 250 Solution: The yazproxy automatically deals with this fault.
 251
 252 2. List of targets:
 253
 254 |Database:   |HELKA  (The OPAC of the Helsinki University Libraries)     |
 255 |Domain name:|193.166.7.193                                              |
 256 |Port:       |7590                                                       |
 257 |Database    |voyager                                                    |
 258 |name:       |                                                           |
 259 |Availability|24 hours a day, 7 days per week. The system is unavailable |
 260 |:           |for about 15minutes daily at 1.00am GMT for routine        |
 261 |            |maintenance.                                               |
 262
 263 |Database:   |FENNICA (the Finnish National Bibliography)                |
 264 |Domain name:|193.166.7.194                                              |
 265 |Port:       |11390                                                      |
 266 |Database    |voyager                                                    |
 267 |name:       |                                                           |
 268 |Availability|24 hours a day, 7 days per week. The system is unavailable |
 269 |:           |for about 15minutes daily at 1.00am GMT for routine        |
 270 |            |maintenance.                                               |
 271
 272 |Database:   |LINDA (The Database of Finnish University Libraries)       |
 273 |Domain name:|193.166.7.194                                              |
 274 |Port:       |11190                                                      |
 275 |Database    |Voyager                                                    |
 276 |name:       |                                                           |
 277 |Availability|24 hours a day, 7 days per week. The system is unavailable |
 278 |:           |for about 15minutes daily at 1.00am GMT for routine        |
 279 |            |maintenance.                                               |
 280
 281 |Database:   |MANDA  (Database of Major Public Libraries)                |
 282 |Domain name:|193.166.7.194                                              |
 283 |Port:       |11290                                                      |
 284 |Database    |Voyager                                                    |
 285 |name:       |                                                           |
 286 |Availability|24 hours a day, 7 days per week. The system is unavailable |
 287 |:           |for about 15minutes daily at 1.00am GMT for routine        |
 288 |            |maintenance.                                               |
 289
 290 -->
 291 </proxy>