This is an automated email from the ASF dual-hosted git repository.
sbp pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tooling-trusted-releases.git
The following commit(s) were added to refs/heads/main by this push:
new 0ea97c7 Add a note about session caching to the development
documentation
0ea97c7 is described below
commit 0ea97c7f3859783413b4775e7b1b5633a71e0ae6
Author: Sean B. Palmer <[email protected]>
AuthorDate: Fri Oct 24 16:07:28 2025 +0100
Add a note about session caching to the development documentation
---
atr/docs/running-the-server.html | 1 +
atr/docs/running-the-server.md | 2 ++
2 files changed, 3 insertions(+)
diff --git a/atr/docs/running-the-server.html b/atr/docs/running-the-server.html
index 9d795d4..ceaa4a8 100644
--- a/atr/docs/running-the-server.html
+++ b/atr/docs/running-the-server.html
@@ -45,3 +45,4 @@ make serve-local
<p><a
href="https://127.0.0.1:8080/";><code>https://127.0.0.1:8080/</code></a></p>
<p>Pick one or the other, because logging into the site on one host does not
log you in to the site on any other host.</p>
<p>It will take one or two minutes for the server to fetch committee and
project information from the ASF website. Until the fetch is complete, no
existing committees and projects will show.</p>
+<p>Developers without LDAP credentials will be unable to perform
<code>rsync</code> writes and certain tasks may also fail. To enable these
actions to succeed, visit <code>/user/cache</code> and press the "Cache me!"
button. This writes your session information to the ATR state directory, where
it will be consulted instead of an LDAP lookup if it exists. The same page also
allows you to clear your session cache data. When you clear your session cache
data, the <code>atr/principal.py</cod [...]
diff --git a/atr/docs/running-the-server.md b/atr/docs/running-the-server.md
index 18ee564..edc79b1 100644
--- a/atr/docs/running-the-server.md
+++ b/atr/docs/running-the-server.md
@@ -71,3 +71,5 @@ If you do not want to change your `/etc/hosts`, you can use
`127.0.0.1`. You sho
Pick one or the other, because logging into the site on one host does not log
you in to the site on any other host.
It will take one or two minutes for the server to fetch committee and project
information from the ASF website. Until the fetch is complete, no existing
committees and projects will show.
+
+Developers without LDAP credentials will be unable to perform `rsync` writes
and certain tasks may also fail. To enable these actions to succeed, visit
`/user/cache` and press the "Cache me!" button. This writes your session
information to the ATR state directory, where it will be consulted instead of
an LDAP lookup if it exists. The same page also allows you to clear your
session cache data. When you clear your session cache data, the
`atr/principal.py` module will still likely cache yo [...]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
