/usr/share/doc/refdb/refdb-manual/ch05s04.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>Configure 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="ch05.html" title="Chapter 5. refdbd administration" /><link rel="prev" href="ch05s03.html" title="Add or remove a user" /><link rel="next" href="ch05s05.html" title="Add, edit, or delete bibliography styles" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Configure the application server</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch05s03.html">Prev</a> </td><th width="60%" align="center">Chapter 5. refdbd administration</th><td width="20%" align="right"> <a accesskey="n" href="ch05s05.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp66892224"></a>Configure the application server</h2></div></div></div><p>There are several ways to configure the application server refdbd to your needs. Two of these ways will modify the behaviour at startup, while the remaining two ways will reconfigure the server only for the duration of the current run.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp66893648"></a>Configuration at startup</h3></div></div></div><p>There are two ways to permanently change the refdbd configuration. First, you can edit the <a class="link" href="ch04s03.html#sect1-mystery-init-files" title="The mystery of the configuration files">configuration file</a> which holds the default values. Second, you can modify the <a class="link" href="re02.html" title="refdbd">command line parameters</a> in the script that starts refdbd in the first place (e.g. an init.d script).</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp66896480"></a>Reconfiguring a running refdbd process</h3></div></div></div><p>Again there are two ways to reconfigure an already running refdbd server. The recommended way is to send a HANGUP signal to the server (<span class="command"><strong>kill -HUP <em class="replaceable"><code>pid</code></em></strong></span>) after editing the <a class="link" href="ch04s03.html#sect1-mystery-init-files" title="The mystery of the configuration files">configuration file</a>. You can send the signal either manually or use the <a class="link" href="re01.html" title="refdbctl">refdbctl</a> script instead. This of course requires that you have a shell on the machine running refdbd. This should not be a problem if you sit in front of that machine. If you don't, and you can't do a remote login (e.g. because it is not supported, as on Windows), this won't help. In that case you may use the second possibility. refdb supports remote administration via refdba if refdbd is started with the appropriate <a class="link" href="re02.html#app-d-switch-remote">parameter</a>. This allows you to use the refdba <a class="link" href="re06.html#app-a-command-confserv" title="confserv"><span class="command"><strong>confserv</strong></span></a> command to reconfigure the server.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a id="note-confserv-access-control"></a>Note</h3><p>The current implementation of the access control to use the <a class="link" href="re06.html#app-a-command-confserv" title="confserv"><span class="command"><strong>confserv</strong></span></a> command requires the refdb administrator to be a database server administrator. This is different from being root on the machine.</p></div><p>You can change the settings for the timeout and the settings for the logging facility.</p><pre class="screen"><code class="prompt">refdba: </code>confserv timeout 60</pre><p>This will set the timeout to 60 s, i.e. a client-server connection has to be stalled for 60 seconds before refdbd gives up.</p><pre class="screen"><code class="prompt">refdba: </code>confserv loglevel 7</pre><p>This will set the log level to 7.</p><pre class="screen"><code class="prompt">refdba: </code>confserv logdest 1</pre><p>This will set syslog as the log info destination.</p><pre class="screen"><code class="prompt">refdba: </code>confserv logfile /var/log/mylog</pre><p>This will use <code class="filename">/var/log/mylog</code> as logfile if logdest is set appropriately.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch05s03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch05.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch05s05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Add or remove a user </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Add, edit, or delete bibliography styles</td></tr></table></div></body></html>
|