comparison doc/admin_guide.txt @ 8297:03513f5066f3

fix: issue2551238 - roundup-server should exit with error ... if -d <pidfile> is used without -l <logfile>. Now exits with error if -l or -L are not specified with -d. This exposed a problem with relative paths when using a logging config file. -d enables deamon mode by default. This changes the current direcory to /. So relative paths in a logging config file are opened in / and fail. Added documentation to dmin guide noting the problem.
author John Rouillard <rouilj@ieee.org>
date Mon, 20 Jan 2025 15:51:53 -0500
parents 2a7c3eeaf167
children 6ea309c6d17c
comparison
equal deleted inserted replaced
8296:4d3b371ed543 8297:03513f5066f3
221 ``-----END PRIVATE KEY-----`` and 221 ``-----END PRIVATE KEY-----`` and
222 ``-----BEGIN CERTIFICATE-----``, 222 ``-----BEGIN CERTIFICATE-----``,
223 ``-----END CERTIFICATE-----``. 223 ``-----END CERTIFICATE-----``.
224 If not specified, roundup will generate a temporary, self-signed certificate 224 If not specified, roundup will generate a temporary, self-signed certificate
225 for use. 225 for use.
226 **loghttpvialogger** section
227 If you:
228
229 * have **loghttpvialogger** enabled
230 * use **pidfile**
231 * use a logging config file in the tracker's config.ini
232
233 it is essential to specify absolute paths for log files in the
234 tracker's logging.config file. The use of pidfile causes the
235 server to switch to the root directory ('/'). As a result
236 relative paths in the logging ini configuration file (as
237 opposed to the tracker's config.ini) will be written to the
238 system's root directory. The access error will cause the server
239 to exit.
226 **trackers** section 240 **trackers** section
227 Each line denotes a mapping from a URL component to a tracker home. 241 Each line denotes a mapping from a URL component to a tracker home.
228 Make sure the name part doesn't include any url-unsafe characters like 242 Make sure the name part doesn't include any url-unsafe characters like
229 spaces. Stick to alphanumeric characters and you'll be ok. 243 spaces. Stick to alphanumeric characters and you'll be ok.
230 244

Roundup Issue Tracker: http://roundup-tracker.org/