X-Git-Url: http://lists.indexdata.com/cgi-bin?a=blobdiff_plain;f=doc%2Fgfs-virtual.xml;h=66f0bd801934b44199acd734d978c0fec43d48b4;hb=12b96ce71560a566dfff5901e2b1aaa9d2dc94cc;hp=593e8bc90665bf75ad98958e8d79ad136b30942a;hpb=926357dcfb7a359cc7a23766460cef5fe21156ee;p=yaz-moved-to-github.git
diff --git a/doc/gfs-virtual.xml b/doc/gfs-virtual.xml
index 593e8bc..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)
@@ -180,10 +200,21 @@
-
+
+ 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.
@@ -200,7 +231,7 @@
/var/www/s1
config.cfg
-
+
server2.mydomain
/var/www/s2
config.cfg
@@ -223,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.
@@ -241,15 +274,7 @@