X-Git-Url: http://git.indexdata.com/?p=idzebra-moved-to-github.git;a=blobdiff_plain;f=doc%2Fzebrasrv-virtual.xml;h=63d4d27610ed984606d20d19d390188ed5143db9;hp=eb240e52acbefc9a1f89034f870a26e37b3e1842;hb=0dedb6a7a6a0f0ddaf56cb0673978fdd85e64be1;hpb=b19b79e382ef8196f1625763db1af3a82b1e0c81 diff --git a/doc/zebrasrv-virtual.xml b/doc/zebrasrv-virtual.xml index eb240e5..63d4d27 100644 --- a/doc/zebrasrv-virtual.xml +++ b/doc/zebrasrv-virtual.xml @@ -1,5 +1,4 @@ @@ -7,31 +6,31 @@ The Virtual hosts mechanism allows a &yaz; frontend server to support multiple backends. A backend is selected on the basis of - the TCP/IP binding (port+listening adddress) and/or the virtual host. + the TCP/IP binding (port+listening address) and/or the virtual host. A backend can be configured to execute in a particular working - directory. Or the &yaz; frontend may perform &cql; to &rpn; conversion, thus - allowing traditional &z3950; backends to be offered as a -&sru; service. - &sru; Explain information for a particular backend may also be specified. + directory. Or the &yaz; frontend may perform &acro.cql; to &acro.rpn; conversion, thus + allowing traditional &acro.z3950; backends to be offered as a +&acro.sru; service. + &acro.sru; Explain information for a particular backend may also be specified. For the HTTP protocol, the virtual host is specified in the Host header. - For the &z3950; protocol, the virtual host is specified as in the + For the &acro.z3950; protocol, the virtual host is specified as in the Initialize Request in the OtherInfo, OID 1.2.840.10003.10.1000.81.1. - Not all &z3950; clients allows the VHOST information to be set. + Not all &acro.z3950; clients allows the VHOST information to be set. For those the selection of the backend must rely on the TCP/IP information alone (port and address). - The &yaz; frontend server uses &xml; to describe the backend + The &yaz; frontend server uses &acro.xml; to describe the backend configurations. Command-line option -f - specifies filename of the &xml; configuration. + specifies filename of the &acro.xml; configuration. The configuration uses the root element yazgfs. @@ -87,7 +86,7 @@ Specifies listener for this server. If this attribute is not given, the server is accessible from all listener. In order - for the server to be used for real, howeever, the virtual host + for the server to be used for real, however, the virtual host must match (if specified in the configuration). @@ -107,7 +106,7 @@ Specifies a working directory for this backend server. If - specifid, the &yaz; fronend changes current working directory + specified, the &yaz; frontend changes current working directory to this directory whenever a backend of this type is started (backend handler bend_start), stopped (backend handler hand_stop) and initialized (bend_init). @@ -128,9 +127,9 @@ element cql2rpn (optional) - Specifies a filename that includes &cql; to &rpn; conversion for this - backend server. See &cql; section in &yaz; manual. - If given, the backend server will only "see" a Type-1/&rpn; query. + Specifies a filename that includes &acro.cql; to &acro.rpn; conversion for this + backend server. See &acro.cql; section in &yaz; manual. + If given, the backend server will only "see" a Type-1/&acro.rpn; query. @@ -138,7 +137,7 @@ element explain (optional) - Specifies &sru; ZeeRex content for this + Specifies &acro.sru; ZeeRex content for this server - copied verbatim to the client. As things are now, some of the Explain content seems redundant because host information, etc. is also stored elsewhere. @@ -154,7 +153,7 @@ - The &xml; below configures a server that accepts connections from + The &acro.xml; below configures a server that accepts connections from two ports, TCP/IP port 9900 and a local UNIX file socket. We name the TCP/IP server public and the other server internal. @@ -200,7 +199,7 @@ For "server2" elements for -&cql; to &rpn; conversion +&acro.cql; to &acro.rpn; conversion is supported and explain information has been added (a short one here to keep the example small).