X-Git-Url: http://lists.indexdata.com/cgi-bin?a=blobdiff_plain;ds=sidebyside;f=doc%2Fgfs-virtual.xml;h=66f0bd801934b44199acd734d978c0fec43d48b4;hb=7673cf27f5be351a18a5d3ea1baf6c4aee06eb3b;hp=b32589b89ea885ae5a6596037f1f2829cb6f902a;hpb=23403c6f31b26b0e819a47980c42f3fc8c57d84d;p=yaz-moved-to-github.git
diff --git a/doc/gfs-virtual.xml b/doc/gfs-virtual.xml
index b32589b..66f0bd8 100644
--- a/doc/gfs-virtual.xml
+++ b/doc/gfs-virtual.xml
@@ -1,5 +1,4 @@
-
@@ -30,7 +29,7 @@
The YAZ frontend server uses XML to describe the backend
- configurations. Command-line option -f
+ configurations. Command-line option -f
specifies filename of the XML configuration.
@@ -40,14 +39,14 @@
The listen describes listener (transport end point),
- such as TCP/IP, Unix file socket or SSL server. Content for
+ such as TCP/IP, Unix file socket or SSL server. Content for
a listener:
CDATA (required)
The CDATA for the listen element holds the
- listener string, such as tcp:@:210,
+ listener string, such as tcp:@:210,
tcp:server1:2100,
etc.
@@ -85,10 +84,11 @@
attribute listenref (optional)
- 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
- must match (if specified in the configuration).
+ Specifies one or more listeners for this server. Each server ID is
+ separated by a comma.
+ If this attribute is not given, the server is accessible from all
+ listeners. In order for the server to be used for real, however, the
+ virtual host must match if specified in the configuration.
@@ -130,7 +130,17 @@
Specifies a filename that includes CQL to RPN conversion for this
backend server. See &reference-tools-cql-map;
- If given, the backend server will only "see" a Type-1/RPN query.
+ If given, the backend server will only "see" a Type-1/RPN query.
+
+
+
+
+ element ccl2rpn (optional)
+
+
+ Specifies a filename that includes CCL to RPN conversion for this
+ backend server. See &reference-tools-ccl-qualifiers;
+ If given, the backend server will only "see" a Type-1/RPN query.
@@ -145,7 +155,17 @@
-
+
+ element client_query_charset (optional)
+
+
+ If specified, a conversion from the character set given to UTF-8 is
+ performed by the generic frontend server. It is only executed for
+ Z39.50 search requests (SRU/Solr are assumed to be UTF-8 encoded already).
+
+
+
+
element docpath (optional)
@@ -158,7 +178,7 @@
-
+
element explain (optional)
@@ -169,9 +189,32 @@
+
+ element maximumrecordsize (optional)
+
+
+ Specifies maximum record size/message size, in bytes. This
+ value also servers as maximum size of incoming
+ packages (for Record Updates etc). It's the same value as that
+ given by the -k option.
+
+
+
+
+ element retrievalinfo (optional)
+
+
+ Enables the retrieval facility supporting conversions and
+ specifications of record formats/types.
+ See for
+ more information.
+
+
+
+
-
+
The XML below configures a server that accepts connections from
two ports, TCP/IP port 9900 and a local UNIX file socket.
@@ -188,7 +231,7 @@
/var/www/s1
config.cfg
-
+
server2.mydomain
/var/www/s2
config.cfg
@@ -211,9 +254,11 @@
There are three configured backend servers. The first two
servers, "server1" and "server2",
- can be reached by both listener addresses - since
- no listenref attribute is specified.
- In order to distinguish between the two a virtual host has
+ can be reached by both listener addresses.
+ "server1" is reached by all (two) since no
+ listenref attribute is specified.
+ "server2" is reached by the two listeners specified.
+ In order to distinguish between the two, a virtual host has
been specified for each of server in the host
elements.
@@ -229,15 +274,7 @@