summaryrefslogtreecommitdiff
path: root/doc/installation.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2020-02-08 18:36:32 +0000
committerPaul Buetow <paul@buetow.org>2020-02-08 18:36:32 +0000
commit95bae52787162b869ecb021e2bbc841bb8b6a65c (patch)
tree03c0a302b006aa08a63d986fdabcb3810ddc48aa /doc/installation.md
parentf2ce541c1383474b439347a22f2237c5d08899d8 (diff)
enable systemd keycache timer
Diffstat (limited to 'doc/installation.md')
-rw-r--r--doc/installation.md15
1 files changed, 9 insertions, 6 deletions
diff --git a/doc/installation.md b/doc/installation.md
index dca7e38..6e2c8cc 100644
--- a/doc/installation.md
+++ b/doc/installation.md
@@ -38,14 +38,14 @@ uid=670(dserver) gid=670(dserver) groups=670(dserver)
```console
% sudo mkdir /etc/dserver
% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/dtail.json.sample |
- sudo tee /etc/dserver/dtail.json >/dev/null
+ sudo tee /etc/dserver/dtail.json
```
5. It is recommended to configure DTail server as a service to ``systemd``. An example unit file for ``systemd`` can be found [here](../samples/dserver.service.sample).
```console
% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/dserver.service.sample |
- sudo tee /etc/systemd/system/dserver.service >/dev/null
+ sudo tee /etc/systemd/system/dserver.service
% sudo systemctl daemon-reload
% sudo systemctl enable dserver
```
@@ -77,17 +77,20 @@ To start the DTail server via ``systemd`` run:
The DTail server now runs as a ``systemd`` service under system user ``dserver``. The system user ``dserver`` however has no permissions to read the SSH public keys from ``/home/USER/.ssh/authorized_keys``. Therefore, no user would be able to establish a SSH session to DTail server. As an alternative path DTail server also checks for public SSH key files in ``/var/run/dserver/cache/USER.authorized_keys``.
-It is recommended to execute [update_key_cache.sh](../samples/update_key_cache.sh.sample) periodically to update the key cache. In case you manage your public SSH keys via Puppet you could subscribe the script to corresponding module. Or alternatively just configure a cron job or a systemd timer to run every once in a while.
+It is recommended to execute [update_key_cache.sh](../samples/update_key_cache.sh.sample) periodically to update the key cache. In case you manage your public SSH keys via Puppet you could subscribe the script to corresponding module. Or alternatively just configure a cron job or a systemd timer to run every once in a while, e.g. every 30 minutes:
```console
% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/update_key_cache.sh.sample |
- sudo tee /var/run/dserver/update_key_cache.sh >/dev/null
+ sudo tee /var/run/dserver/update_key_cache.sh
% sudo chmod 755 /var/run/dserver/update_key_cache.sh
% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/dserver-update-keycache.service.sample |
- sudo tee /etc/systemd/system/dserver-update-keycache.service >/dev/null
+ sudo tee /etc/systemd/system/dserver-update-keycache.service
% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/dserver-update-keycache.timer.sample |
- sudo tee /etc/systemd/system/dserver-update-keycache.timer >/dev/null
+ sudo tee /etc/systemd/system/dserver-update-keycache.timer
% sudo systemctl daemon-reload
+% sudo systemctl start dserver-update-keycache.service
+% sudo systemctl enable dserver-update-keycache.timer
+% sudo systemctl start dserver-update-keycache.timer
```
# Run DTail client