/usr/share/doc/refdb/refdb-manual/ch12.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>Chapter 12. The application server</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="pt04.html" title="Part IV. Reference manual" /><link rel="prev" href="pt04.html" title="Part IV. Reference manual" /><link rel="next" href="re01.html" title="refdbctl" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 12. The application server</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pt04.html">Prev</a> </td><th width="60%" align="center">Part IV. Reference manual</th><td width="20%" align="right"> <a accesskey="n" href="re01.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="chapter-refdbd"></a>Chapter 12. The application server</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="refentry"><a href="re01.html">refdbctl</a></span></dt><dd><dl><dt><span class="refsect1"><a href="re01.html#refdbctl-description">Description</a></span></dt><dt><span class="refsect1"><a href="re01.html#refdbctl-options">Options</a></span></dt><dt><span class="refsect1"><a href="re01.html#refdbctl-files">Files</a></span></dt><dt><span class="refsect1"><a href="re01.html#refdbctl-see_also">See also</a></span></dt><dt><span class="refsect1"><a href="re01.html#refdbctl-author">Author</a></span></dt></dl></dd><dt><span class="refentry"><a href="re02.html">refdbd</a></span></dt><dd><dl><dt><span class="refsect1"><a href="re02.html#refdbd-description">Description</a></span></dt><dt><span class="refsect1"><a href="re02.html#refdbd-options">Options</a></span></dt><dt><span class="refsect1"><a href="re02.html#refdbd-configuration">Configuration</a></span></dt><dt><span class="refsect1"><a href="re02.html#refdbd-files">Files</a></span></dt><dt><span class="refsect1"><a href="re02.html#refdbd-see_also">See also</a></span></dt><dt><span class="refsect1"><a href="re02.html#refdbd-author">Author</a></span></dt></dl></dd><dt><span class="refentry"><a href="re03.html">refdb</a></span></dt><dd><dl><dt><span class="refsect1"><a href="re03.html#refdb-description">Description</a></span></dt><dt><span class="refsect1"><a href="re03.html#refdb-options">Options</a></span></dt><dt><span class="refsect1"><a href="re03.html#refdb-see_also">See also</a></span></dt><dt><span class="refsect1"><a href="re03.html#refdb-author">Author</a></span></dt></dl></dd><dt><span class="refentry"><a href="re04.html">refdbsru</a></span></dt><dd><dl><dt><span class="refsect1"><a href="re04.html#refdbsru-description">Description</a></span></dt><dt><span class="refsect1"><a href="re04.html#refdbsru-configuration">Configuration</a></span></dt><dt><span class="refsect1"><a href="re04.html#refdbsru-environment">Environment</a></span></dt><dt><span class="refsect1"><a href="re04.html#refdbsru-files">Files</a></span></dt><dt><span class="refsect1"><a href="re04.html#refdbsru-see_also">See also</a></span></dt><dt><span class="refsect1"><a href="re04.html#refdbsru-author">Author</a></span></dt></dl></dd><dt><span class="refentry"><a href="re05.html">refdb-sruserver</a></span></dt><dd><dl><dt><span class="refsect1"><a href="re05.html#refdb-sruserver-description">Description</a></span></dt><dt><span class="refsect1"><a href="re05.html#refdb-sruserver-configuration">Configuration</a></span></dt><dt><span class="refsect1"><a href="re05.html#refdb-sruserver-files">Files</a></span></dt><dt><span class="refsect1"><a href="re05.html#refdb-sruserver-see_also">See also</a></span></dt><dt><span class="refsect1"><a href="re05.html#refdb-sruserver-author">Author</a></span></dt></dl></dd></dl></div><p>refdbd is the RefDB application server, i.e. a program that runs in the background and handles the requests from the RefDB clients. This is the program that directly interacts with the database server and does most of the serious work.</p><p>refdbd can be configured at startup with the configuration file <code class="filename">refdbdrc</code> or by passing command-line options. The latter override the corresponding settings in the configuration files. While refdbd is running, most of the parameters can be changed remotely with <span class="application">refdba</span> (see the refdba command <a class="link" href="re06.html#app-a-command-confserv" title="confserv"><span class="command"><strong>confserv</strong></span></a>), but to make changes permanent you'll have to edit the configuration file or the script line that starts refdbd.</p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>In the current implementation, the remote administration via <span class="application">refdba</span> uses a fairly <a class="link" href="ch05s04.html#note-confserv-access-control" title="Note">indirect access control</a>. If this is a concern, you should not enable remote administration (it is disabled by default). You can use the command <span class="command"><strong>refdbctl reload</strong></span> instead to cause refdbd to reread its configuration file while running. Then the usual access controls for editing the configuration file and for sending a signal to a process apply.</p></div><p>You can run refdbd as a standalone application or as a daemon. The main difference between the standalone process and a daemon process is the fact that the daemon is no longer associated with a particular terminal. This means that no output to stdout or stderr will ever show up on a terminal and that the process will keep running even if the terminal that started the process terminates. This is good if you want it running unattended, similar to a web server or a ftp server. On the other hand it can be handy for debugging purposes to directly get log output (or additional <code class="function">printf()</code> output) on a terminal and to use the standard ways of process control, e.g. to kill refdbd with <span class="keycap"><strong>Ctrl-C</strong></span>. The <code class="option">-s</code> command line switch lets refdbd run as a normal application for exactly this purpose.</p><p>The above holds true for almost any Unix-like operating system. On Windowsish operating systems the story is somewhat different. First of all, the Win95/98/ME family does not support daemons at all. WinNT/2000 do support daemons (they're called <span class="quote">“<span class="quote">services</span>”</span> here just for the sake of having a different name for the same thing). The simplest way to run refdbd as a NT service is to use a service installer as described in the <a class="link" href="ch04.html" title="Chapter 4. Installation">Installation</a> chapter. In this case you should run refdbd as a standalone application (i.e. include the <code class="option">-s</code> switch), as the installer will take care of all the magic. Another possibility is to start refdbd from Cygwin <span class="application">inetd</span>. In that case you'd run refdbd as a daemon again, but this is currently beyond the scope of this manual.</p><p>You can run refdbd as a daemon either from the command line, i.e. start it manually when you need it, or you can start the daemon at the system start. For the latter, refer to the <a class="link" href="ch04.html" title="Chapter 4. Installation">Installation</a> chapter.</p><p>This chapter explains how to control refdbd from the command line. The easiest and strongly recommended way is to use the provided control script that will be explained in the first section. If you need further control, you can use the command line of refdbd directly as explained in the second section. The third section describes the script which is usually run automatically by your system if you install refdbd as a daemon. The final sections describe the two applications which provide SRU access to RefDB databases.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="pt04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt04.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part IV. Reference manual </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> refdbctl</td></tr></table></div></body></html>
|