/usr/share/doc/refdb/refdb-manual/re05.html is in refdb-doc 1.0.2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>refdb-sruserver</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="RefDB handbook" /><link rel="up" href="ch12.html" title="Chapter 12. The application server" /><link rel="prev" href="re04.html" title="refdbsru" /><link rel="next" href="ch13.html" title="Chapter 13. Administration tools" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">refdb-sruserver</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re04.html">Prev</a> </td><th width="60%" align="center">Chapter 12. The application server</th><td width="20%" align="right"> <a accesskey="n" href="ch13.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="refentry-refdb-sruserver"></a><div class="titlepage"></div><div class="refnamediv"><a id="refdb-sruserver-name"></a><h2>Name</h2><p>refdb-sruserver — Simple SRU server for RefDB databases</p></div><div class="refsynopsisdiv"><a id="refdb-sruserver-synopsis"></a><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">refdb-sruserver</code> </p></div></div><div class="refsect1"><a id="refdb-sruserver-description"></a><h2>Description</h2><p>refdb-sruserver is a simple standalone web server which povides a SRU service for RefDB databases. It is intended solely for local single-user access. For anything more ambitious, please see the CGI version of the SRU service, refdbsru(1).</p><p>Before starting the SRU service, make sure to set up the refdbsrurc configuration file which it shares with the CGI variant. The RefDB application server refdbd(1) must also be up and running. Now start the script which will run in the foreground until you kill it with Ctrl-c. The SRU service is available at the URL http://localhost:8080. Pointing your web browser to this address should return the output of the SRU explain command in a nicely formatted page. To run real queries, append the SRU query strings to the above URL.</p></div><div class="refsect1"><a id="refdb-sruserver-configuration"></a><h2>Configuration</h2><p><span class="command"><strong>refdb-sruserver</strong></span> evaluates the file <code class="filename">refdbsrurc</code> to initialize itself. It shares this configuration file with refdbsru(1), the CGI variant of the SRU service.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The parameters starting with "zeerex_" do not actually influence how the script operates. They provide some of the site-specific information which appears in the SRU <span class="command"><strong>explain</strong></span> output.</p></div><div class="table"><a id="idp69479440"></a><p class="title"><strong>Table 12.3. refdb-sruserverrc</strong></p><div class="table-contents"><table summary="refdb-sruserverrc" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Variable</th><th>Default</th><th>Comment</th></tr></thead><tbody><tr><td>logfile</td><td>/var/log/refdb-sruserver.log</td><td>The full path of a custom log file. This is used only if logdest is set appropriately.</td></tr><tr><td>logdest</td><td>1</td><td>The destination of the log information. 0 = print to stderr; 1 = use the syslog facility; 2 = use a custom logfile. The latter needs a proper setting of logfile.</td></tr><tr><td>loglevel</td><td>6</td><td>The log level up to which messages will be sent. A low setting (0) allows only the most important messages, a high setting (7) allows all messages including debug messages. -1 means nothing will be logged.</td></tr><tr><td>serverip</td><td>127.0.0.1</td><td>The IP address or hostname of the machine where <span class="application">refdbd</span> runs. Use the default (localhost) address if the clients and refdbs run on the same machine.</td></tr><tr><td>port</td><td>9734</td><td>The port on which <span class="application">refdbd</span> listens. Change this for all clients and the server if this value interferes with another program using this port.</td></tr><tr><td>timeout</td><td>180</td><td>The timeout in seconds. After this time has elapsed, a stalled connection is taken down. Increase this value if you encounter frequent timeout errors due to high network traffic or refdbd overload.</td></tr><tr><td>username</td><td>login name</td><td>The username which is used for authentication with the database server.</td></tr><tr><td>passwd</td><td> </td><td>The password which is used for authentication with the database server.</td></tr><tr><td>pdfroot</td><td>(none)</td><td>This value will be used as the root of the paths to PDF or Postscript offprints that can be specified with the AV field in a RIS dataset. The path should not rely on shell expansion, e.g. use <code class="filename">/home/me/literature/</code> instead of <code class="filename">~/literature/</code>. The <a class="link" href="ch08s10.html" title="Use pdfroot">pdfroot</a> allows you to shorten the paths that you enter for each dataset and to maintain a certain portability if you have to move the offprints to a different directory or want to access them remotely. The html output routine will concatenate the relative path of each dataset with the pdfroot to construct the link to the offprint. Instead of a local path name you can specify an URL starting with http:// or ftp:// if your offprints are accessible through a web server or ftp server.</td></tr><tr><td>cssurl</td><td>(none)</td><td>In spite of the parameter name, this may be the URL either of a Cascading Style Sheet (CSS) file, or of a XSLT file. This file, if specified, is used to format the SRU output in the web browser.</td></tr><tr><td>dbserver</td><td>(none)</td><td>This is the name of the database engine that refdbd uses (currently either mysql, pgsql, sqlite, or sqlite3). refdb-sruserver can obtain this value at runtime, but it has to send one additional query per searchRetrieve or scan operation. If you provide the value here instead, response times will be faster.</td></tr><tr><td>zeerex_host</td><td>www.change.me</td><td>The hostname of the computer that runs your web server and refdb-sruserver</td></tr><tr><td>zeerex_port</td><td>80</td><td>The port that your web server listens to.</td></tr><tr><td>zeerex_database</td><td>cgi-bin/refdb-sruserver</td><td>The path section of the URL which provides SRU access to your database, without the leading slash. zeerex_host, a slash, and this option combined make up the URL which a user has to type into his web browser to access your SRU service.</td></tr><tr><td>zeerex_databaseInfo_title</td><td>Reference Database</td><td>A public name of your database.</td></tr><tr><td>zeerex_databaseInfo_description</td><td>A reference database</td><td>A brief description of your database.</td></tr><tr><td>zeerex_databaseInfo_author</td><td>Your Name</td><td>The name of the person who is in charge of running the database.</td></tr><tr><td>zeerex_databaseInfo_contact</td><td>your@email</td><td>How to contact the database maintainer. Usually the email address.</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="refsect1"><a id="refdb-sruserver-files"></a><h2>Files</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="filename">PREFIX/etc/refdb/refdbsrurc</code></span></dt><dd><p>The global configuration file of refdb-sruserver.</p></dd></dl></div></div><div class="refsect1"><a id="refdb-sruserver-see_also"></a><h2>See also</h2><p><span class="emphasis"><em>RefDB</em></span> (7)</p><p><span class="emphasis"><em>refdbsru</em></span> (1)</p><p><span class="emphasis"><em>RefDB manual (local copy) </em></span> PREFIX/share/doc/refdb-<version>/refdb-manual/index.html</p><p><span class="emphasis"><em>RefDB manual (web) </em></span> <<a class="ulink" href="http://refdb.sourceforge.net/manual/index.html" target="_top">http://refdb.sourceforge.net/manual/index.html</a>></p><p><span class="emphasis"><em>RefDB on the web </em></span> <<a class="ulink" href="http://refdb.sourceforge.net/" target="_top">http://refdb.sourceforge.net/</a>></p><p><span class="emphasis"><em>SRU (Search and Retrieve via URL) </em></span> <<a class="ulink" href="http://www.loc.gov/standards/sru/" target="_top">http://www.loc.gov/standards/sru/</a>></p></div><div class="refsect1"><a id="refdb-sruserver-author"></a><h2>Author</h2><p>refdb-sruserver was written by Markus Hoenicka <markus@mhoenicka.de>.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch12.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch13.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">refdbsru </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 13. Administration tools</td></tr></table></div></body></html>
|