From ef36901ba245f242e98120a11e74c1a6f39d22b3 Mon Sep 17 00:00:00 2001
From: Carl Edquist <edquist@cs.wisc.edu>
Date: Fri, 6 May 2022 12:47:19 -0500
Subject: [PATCH 1/2] doco how to modify the osg-token-renewer timer frequency
 (SOFTWARE-5156)

---
 docs/other/osg-token-renewer.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/other/osg-token-renewer.md b/docs/other/osg-token-renewer.md
index 1b8627c40..bddf04620 100644
--- a/docs/other/osg-token-renewer.md
+++ b/docs/other/osg-token-renewer.md
@@ -122,6 +122,24 @@ account = myclient1234
 token_path = /etc/osg/tokens/myclient1234.mytoken567.token
 ```
 
+### Adjusting token renewal frequency
+
+It is possible to override the default `osg-token-renewer` systemd timer
+frequency for this service by creating a config override file under
+`/etc/systemd/system/osg-token-renewer.timer.d/`.
+
+For example, to configure the token renewal service to run every 10 minutes,
+run the following:
+
+```console
+root@host # cat << EOF > /etc/systemd/system/osg-token-renewer.timer.d/timer-frequency.conf
+[Timer]
+OnBootSec=10min
+OnUnitActiveSec=10min
+EOF
+root@host # systemctl daemon-reload
+```
+
 Managing the OSG Token Renewal Service
 --------------------------------------
 

From 785948b89ac6faae1e6cbcad4c5fb0f84d866439 Mon Sep 17 00:00:00 2001
From: Carl Edquist <edquist@cs.wisc.edu>
Date: Fri, 6 May 2022 13:27:15 -0500
Subject: [PATCH 2/2] add note about random 3min delay (SOFTWARE-5156)

---
 docs/other/osg-token-renewer.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/other/osg-token-renewer.md b/docs/other/osg-token-renewer.md
index bddf04620..b2e3ce415 100644
--- a/docs/other/osg-token-renewer.md
+++ b/docs/other/osg-token-renewer.md
@@ -140,6 +140,13 @@ EOF
 root@host # systemctl daemon-reload
 ```
 
+!!! note
+    Be aware that the default timer configuration also has a 3 minute random
+    delay built in, via the parameter `RandomizedDelaySec=3min`.
+    Thus setting the frequency to `10min` only guarantees runs every 13 minutes.
+    This parameter is also configurable in the above systemd override file.
+
+
 Managing the OSG Token Renewal Service
 --------------------------------------