http://hg.code.sf.net:8000/p/roundup/code/atom-log/tip/share/man/man1/roundup-server.1 Mercurial Repository: p/roundup/code: share/man/man1/roundup-server.1 history 2024-12-01T17:38:15-05:00 allow roundup-server to log real client IP behind reverse proxy http://hg.code.sf.net:8000/p/roundup/code/#changeset-627c5d6a0551aa663b80f0c6f58284c0edf7c5b9 John Rouillard rouilj@ieee.org 2024-12-01T17:38:15-05:00 2024-12-01T17:38:15-05:00
changeset 627c5d6a0551
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description allow roundup-server to log real client IP behind reverse proxy

added -P flag to roundup-server to log client address from
X-Forwarded-For reverse proxy header rather than connecting
address. This logs the actual client address when roundup-server is
run behind a reverse proxy. It also appends a '+' sign to the logged
address/name.

This makes correlating reverse proxy logs to roundup logs much easier
by propagating the IP address.

Also added documentation for -D flag that was undocumented.
files
issue2551219 - use of PEM file with roundup-server http://hg.code.sf.net:8000/p/roundup/code/#changeset-0f5d31be5418b49953f8e272924c0e0bee47951c John Rouillard rouilj@ieee.org 2024-06-08T04:52:59-04:00 2024-06-08T04:52:59-04:00
changeset 0f5d31be5418
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description issue2551219 - use of PEM file with roundup-server

Document requirements of PEM file when using roundup-server in SSL/TLS
mode in the config.ini generated by roundup-server --save-config.

Trap errors produced by missing cert or key when reading a pem file
and try to produce a more useful error.

Man page already had correct documentation. However because man pages
are justified, the marker lines get additional internal spacing. Use
example macros to prevent this spacing in case somebody cuts/pastes
the marker lines.
files
docs: issue2551311 document when index returned from roundup-server http://hg.code.sf.net:8000/p/roundup/code/#changeset-55238195033f351b7a8c883c0af9ec254ad0ff6b John Rouillard rouilj@ieee.org 2024-06-06T20:14:43-04:00 2024-06-06T20:14:43-04:00
changeset 55238195033f
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description docs: issue2551311 document when index returned from roundup-server

in issue2551311 a user was confused when setting the tracker web to
the root URL path. While resolving this, it turns out there was no
explanation of what was returned when the root URL was accessed
compared to a tracker URL.

Added explanation that index is returned for multiple trackers and a
redirect for only one tracker.

Now that the man pages are available online, this is a reasonable
place to put the doc as there are no suitable places in the core docs.
files
update man pages with see also section. http://hg.code.sf.net:8000/p/roundup/code/#changeset-d614d8e1c09d09149cce2c2b104710a904aed525 John Rouillard rouilj@ieee.org 2024-05-25T23:43:51-04:00 2024-05-25T23:43:51-04:00
changeset d614d8e1c09d
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description update man pages with see also section.
files
- issue2551275 - Allow configuring max_children in roundup-server. http://hg.code.sf.net:8000/p/roundup/code/#changeset-46f92ac4e170835d7232e3f94726812d0013e782 John Rouillard rouilj@ieee.org 2023-05-23T23:34:06-04:00 2023-05-23T23:34:06-04:00
changeset 46f92ac4e170
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description - issue2551275 - Allow configuring max_children in roundup-server.

new -m and --max_children command line arguments and max_children
config file setting for roundup_server.py/roundup-server.

CHANGES.txt, admin_guide.txt, roundup-server.1 updated.
files
document result of running save-config in a tracker home directory http://hg.code.sf.net:8000/p/roundup/code/#changeset-b84718ea422881a7090232a6c5eb03a8a8f67113 John Rouillard rouilj@ieee.org 2023-05-14T01:03:09-04:00 2023-05-14T01:03:09-04:00
changeset b84718ea4228
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description document result of running save-config in a tracker home directory
files
Clean up docs on roundup-sever SSL use. http://hg.code.sf.net:8000/p/roundup/code/#changeset-7a48f771cd4f20fe09d569e1756285859b78d71b John Rouillard rouilj@ieee.org 2022-08-18T14:57:15-04:00 2022-08-18T14:57:15-04:00
changeset 7a48f771cd4f
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description Clean up docs on roundup-sever SSL use.

Duplicate sections from man page update to admin_guide as the man
page often isn't installed anywhere man can find it.

Remove warning that SSL is only supported on python 3. Suprisingly my
change to fix it on Python 3 also inadvertantly fixed it on python 2.
files
issue2551137, 2551138 - roundup-server SSL issues. http://hg.code.sf.net:8000/p/roundup/code/#changeset-5129fc03dc1f41f013cbbcae872b1ba97e1340cb John Rouillard rouilj@ieee.org 2022-08-18T14:44:16-04:00 2022-08-18T14:44:16-04:00
changeset 5129fc03dc1f
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description issue2551137, 2551138 - roundup-server SSL issues.

Python3 no longer supports socket._fileobject, so fake it using
SocketIO and layering io.BufferedReader as in:

https://bugs.launchpad.net/python-glanceclient/+bug/1812525

Also handle SSL.ZeroReturnError exception by ignoring it. This
exception is thrown when the SSL layer has been closed and a read
happens. There is a warning in openssl as well as python docs that the
underlying (unencrypted) socket may not be closed. In manual testing,
netstat -anp didn't show any unclosed socket so.... Could it leak a fd
still, unknown.

This also seesm to have fixed an error when running under python2
where socket shutdown throws an error. Maybe ignoring ZeroErrorREturn
handled that case?

Also added doc to man page recommending not using -s and using a real
web server instead. Also added doc on format of pem file passed to -e.

No automated testing on this, so no test updates 8-(.
files
Fix spelling. http://hg.code.sf.net:8000/p/roundup/code/#changeset-da9a78957bd47cdda8884b6ab50732aac08500cd John Rouillard rouilj@ieee.org 2022-08-16T22:42:38-04:00 2022-08-16T22:42:38-04:00
changeset da9a78957bd4
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description Fix spelling.
files
Expand on explanation for multiprocess-mode in roundup-server.1. http://hg.code.sf.net:8000/p/roundup/code/#changeset-e0b29e3fe995c967e7ed92c078e9daeab15e0b39 John Rouillard rouilj@ieee.org 2022-08-16T18:31:09-04:00 2022-08-16T18:31:09-04:00
changeset e0b29e3fe995
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description Expand on explanation for multiprocess-mode in roundup-server.1.
files
add thread option to roundup-server.1 man page. http://hg.code.sf.net:8000/p/roundup/code/#changeset-36cf8a12a26b10329a0f11b80c7852f19f6341ff John Rouillard rouilj@ieee.org 2022-08-16T18:25:07-04:00 2022-08-16T18:25:07-04:00
changeset 36cf8a12a26b
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description add thread option to roundup-server.1 man page.
files
Enable HTTP/1.1 support for roundup-server http://hg.code.sf.net:8000/p/roundup/code/#changeset-a036712c96f47e6d917cb2474522d569900309f8 John Rouillard rouilj@ieee.org 2021-10-18T20:12:09-04:00 2021-10-18T20:12:09-04:00
changeset a036712c96f4
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description Enable HTTP/1.1 support for roundup-server

This enables keepalives and seems to prevent a lot of hangs/slowness
in my configuration.

configuration.py: add new HttpVersionOption. This is used by the
command line/config in roundup-server. Validates http version
string.

roundup-server.py: enable HTTP 1.1 by default. use -V to set HTTP/1.0
on command line or set http_version in config file.

Fix typo in config description for option include_headers.

Add more vertical spacing for error report and usage display.

roundup-server.1: add doc on -V also doc -I which was missing. Remove
uneeded "to" from a sentence on ssl.
files
issue2550885 - man page documentation roundup-server.1 http://hg.code.sf.net:8000/p/roundup/code/#changeset-247f176f9020138b557579a6c266d8a468bf92d5 John Rouillard rouilj@ieee.org 2019-11-03T14:43:29-05:00 2019-11-03T14:43:29-05:00
changeset 247f176f9020
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description issue2550885 - man page documentation roundup-server.1
files
issue2550882. Reported by Karl-Philipp Richter. Fixed http://hg.code.sf.net:8000/p/roundup/code/#changeset-c54720396f40b2a4e9e58c6618e8483ffe14fd7b John Rouillard rouilj@ieee.org 2016-07-09T17:44:20-04:00 2016-07-09T17:44:20-04:00
changeset c54720396f40
branch
bookmark
tag
user John Rouillard <rouilj@ieee.org>
description issue2550882. Reported by Karl-Philipp Richter. Fixed
installation.txt documentation to include better directions on
starting roundup-server on different ports/ip addresses. Also
updated man page to include default use of localhost for -n and use
of -n 0.0.0.0 to bind to all addresses on the host.
files
issue2550760: Several improvements to the manpages (thanks Kai Storbeck) http://hg.code.sf.net:8000/p/roundup/code/#changeset-a5a9b81f8f6beb97fa722fdc24103ca4948b28e6 John Kristensen john@jerrykan.com 2012-12-18T15:16:14+11:00 2012-12-18T15:16:14+11:00
changeset a5a9b81f8f6b
branch
bookmark
tag
user John Kristensen <john@jerrykan.com>
description issue2550760: Several improvements to the manpages (thanks Kai Storbeck)

- include downstream Debian man page patches
files
Move man pages into 'share/man/man1' and simplify setup.py http://hg.code.sf.net:8000/p/roundup/code/#changeset-ab542607f2fbcdce43ebf320b91b5d87be4c05c4 Stefan Seefeld stefan@seefeld.name 2009-03-12T14:27:20+00:00 2009-03-12T14:27:20+00:00
changeset ab542607f2fb
branch
bookmark
tag
user Stefan Seefeld <stefan@seefeld.name>
description Move man pages into 'share/man/man1' and simplify setup.py
files