Greenstone Wiki

User Tools

Site Tools

You are here: index » en » user_advanced » z3950
en:user_advanced:z3950

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
en:user_advanced:z3950 [2018/03/26 01:29] – [Known Problems/Issues list] kjdonen:user_advanced:z3950 [2020/11/11 23:36] – [Using the z3950 server] kjdon
Line 2: Line 2:
 **[[http://www.loc.gov/z3950/agency/|Z39.50]]** is an international client/server protocol for searching bibliographic data. It can use the Internet Protocol (TCP/IP), which makes the databases on a server available from almost anywhere around the globe. It is widely used, for example, in on-line library catalogues. It allows a user to search one or more databases and retrieve the results of the query. **[[http://www.loc.gov/z3950/agency/|Z39.50]]** is an international client/server protocol for searching bibliographic data. It can use the Internet Protocol (TCP/IP), which makes the databases on a server available from almost anywhere around the globe. It is widely used, for example, in on-line library catalogues. It allows a user to search one or more databases and retrieve the results of the query.
  
-Greenstone has support for Z39.50, both as a client and a server. GLI can download MARC records using Z39.50 and MARCXML records using SRU. These records can then be included in a collection. This support is enabled by default.+Greenstone has support for Z39.50, both as a client (Greenstone 2 and 3) and a server (Greenstone 2). GLI can download MARC records using Z39.50 and MARCXML records using SRU. These records can then be included in a collection. This support is enabled by default.
  
-The Greenstone run-time can also act as a client to multiple Z39.50 servers, and a Z39.50 server program is also available.  This support is not enabled by default, and recompilation is needed to enable it. To do this, you need the source code. If you don't already have the source, download the version of the source code component that matches the distribution you are using.+The Greenstone 2 run-time can also act as a client to multiple Z39.50 servers, and a Z39.50 server program is also available.  This support is not enabled by default, and recompilation is needed to enable it. To do this, you need the source code. If you don't already have the source, download the version of the source code component that matches the distribution you are using.
  
-Z39.50 support in Greenstone is based around the YAZ toolkit, written by [[http://www.indexdata.dk/|IndexData]]. We are currently using YAZ version 2.1.4. This is included in the Greenstone distribution without modification. Greenstone links against the ''libyaz.a'' library. We have also written ''yaz_zclient.h/cpp'', which is based on the sample ''client.h/cpp''. This is found in //greenstone/runtime-src/src/z3950//.+Z39.50 support in Greenstone is based around the YAZ toolkit, written by [[http://www.indexdata.dk/|IndexData]]. We are currently using YAZ version 2.1.4. This is included in the Greenstone 2 distribution without modification. Greenstone links against the ''libyaz.a'' library. We have also written ''yaz_zclient.h/cpp'', which is based on the sample ''client.h/cpp''. This is found in //greenstone/runtime-src/src/z3950//.
  
 ===== Download through Z39.50 ===== ===== Download through Z39.50 =====
Line 14: Line 14:
  
 ^Argument^Description^ ^Argument^Description^
-|Host (''-host'')|(REQUIRED) name of the Z39.50 server, for example //z3950.loc.gov//| +|Host (''-host'')|(REQUIRED) name of the Z39.50 server, for example // lx2.loc.gov//| 
-|Port (''-port'')|(REQUIRED) port number of the server, for example //7090//| +|Port (''-port'')|(REQUIRED) port number of the server, for example //210//| 
-|Database (''-database'')|(REQUIRED) name of the database to which the query will be sent| +|Database (''-database'')|(REQUIRED) name of the database to which the query will be sent, for example // LCDB_MARC8//| 
-|Find (''-find'')| (REQUIRED) query (//[[#querying in YAZ|see below]]//)|+|Find (''-find'')| (REQUIRED) query, for example //mozart// (//[[#querying in YAZ|see below]]//)|
 |Max records (''-max_records'')|Select to limit the size of result set; Default: 500| |Max records (''-max_records'')|Select to limit the size of result set; Default: 500|
  
Line 26: Line 26:
  
 As the files downloaded via Z39.50 are in MARC format, they can be processed by [[en:plugin:MARCPlugin|MARCPlugin]], which must be included in the collection plugin list.  As the files downloaded via Z39.50 are in MARC format, they can be processed by [[en:plugin:MARCPlugin|MARCPlugin]], which must be included in the collection plugin list. 
 +
 +[[https://www.loc.gov/z3950/lcserver.html#addr]] shows a list of the Library of Congress Z39.50 catalogs.
 +
  
 ==== Querying in YAZ ==== ==== Querying in YAZ ====
Line 38: Line 41:
 Greenstone also supports downloading from a Z39.50 server through SRU. If using the GLI, select SRU on the Download panel. The options for SRU are the same as for Z39.50 download, but different //host// and //port// values should be used here. For example, to connect to the Library of Congress Z39.50 server through SRU, the following host and port should be specified: Greenstone also supports downloading from a Z39.50 server through SRU. If using the GLI, select SRU on the Download panel. The options for SRU are the same as for Z39.50 download, but different //host// and //port// values should be used here. For example, to connect to the Library of Congress Z39.50 server through SRU, the following host and port should be specified:
 <code> <code>
- host: http://z3950.loc.gov + host: http://lx2.loc.gov 
- port: 7090/voyager?+ port: 210/LCDB?
 </code> </code>
  
Line 50: Line 53:
 To build a collection using the downloaded XML files, [[en:plugin:MARCXMLPlugin|MARCXMLPlugin]] must be added to the collection plugin list.  To build a collection using the downloaded XML files, [[en:plugin:MARCXMLPlugin|MARCXMLPlugin]] must be added to the collection plugin list. 
  
-===== Compiling Greenstone with Z39.50 support =====+===== Compiling Greenstone 2 with Z39.50 support =====
  
   * Linux/MacOS: in the top level greenstone directory, run   * Linux/MacOS: in the top level greenstone directory, run
Line 72: Line 75:
 ===== Using the Z39.50 client ===== ===== Using the Z39.50 client =====
  
-Once Greenstone has Z39.50 support compiled in, it can act as a client to multiple z39.50 servers. The file +Once Greenstone 2 has Z39.50 support compiled in, it can act as a client to multiple z39.50 servers. The file ''Greenstone/etc/packages/z3950/z3950.cfg'' specifies a list of servers to connect to. By default, no servers are set up, although the config file comes with one (commented out) example Z39.50 server, for the United States' Library of Congress.
-<TABAREA tabs="Greenstone3,Greenstone2"> +
-<TAB>''Greenstone/gs2build/etc/packages/z3950/z3950.cfg''</TAB> +
-<TAB>''Greenstone/etc/packages/z3950/z3950.cfg''</TAB> +
-</TABAREA> +
- +
- specifies a list of servers to connect to. By default, no servers are set up, although the config file comes with one (commented out) example Z39.50 server, for the United States' Library of Congress.+
  
 Each entry consists of: Each entry consists of:
Line 100: Line 97:
   * The ''gsdlsite.cfg'' file needs to be copied from the cgi-bin directory to the directory you are running z3950server from. Check that the 'gsdlhome' entry is valid. The other entries don't matter.   * The ''gsdlsite.cfg'' file needs to be copied from the cgi-bin directory to the directory you are running z3950server from. Check that the 'gsdlhome' entry is valid. The other entries don't matter.
   * Before running the server, set up your Greenstone environment in the terminal by running the following in your top level Greenstone directory:   * Before running the server, set up your Greenstone environment in the terminal by running the following in your top level Greenstone directory:
-<TABAREA tabs="Greenstone3,Greenstone2"> +Linux/Mac
-<TAB>Linux/Mac +
-<code> +
-source gs3-setup.bash +
-</code> +
-Windows +
-<code> +
-gs3-setup.bat +
-</code></TAB> +
-<TAB>Linux/Mac+
 <code> <code>
 source setup.bash source setup.bash
Line 116: Line 104:
 <code> <code>
 setup.bat setup.bat
-</code></TAB> +</code> 
-</TABAREA>+
   * By default, the server listens on localhost:9999. To change the port or address, run   * By default, the server listens on localhost:9999. To change the port or address, run
 <code> z3950server tcp:server-name:port-num</code> <code> z3950server tcp:server-name:port-num</code>
en/user_advanced/z3950.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1