From 9f4f6f72dbf16664d023c45a9e144081d0283fa0 Mon Sep 17 00:00:00 2001
From: Stonewall Jackson <stonewall@sacredheartsc.com>
Date: Thu, 9 Feb 2023 18:41:03 -0500
Subject: add archiver documentation

---
 roles/archive_client/README.md         | 33 +++++++++++++++++++++++++++++++++
 roles/archive_client/defaults/main.yml |  1 -
 2 files changed, 33 insertions(+), 1 deletion(-)
 create mode 100644 roles/archive_client/README.md

(limited to 'roles/archive_client')

diff --git a/roles/archive_client/README.md b/roles/archive_client/README.md
new file mode 100644
index 0000000..2234fb5
--- /dev/null
+++ b/roles/archive_client/README.md
@@ -0,0 +1,33 @@
+Archive Client
+==============
+
+Description
+-----------
+
+The _archiver_ is my method of performing periodic backups of application data.
+The general idea is that applications can write data to a dedicated directory in
+`/var/spool/archive`, and the [archive\_server](../archive_server) will rsync any
+of these files to a central location each night.
+
+The `archive_client` role prepares a host to perform [archive jobs](../archive_job).
+It adds the host to the `archive_clients` hostgroup and prepares the archive spool
+directory.
+
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable                          | Default    | Description
+----------------------------------|------------|------------
+`archive_server_user`             | s-archiver | Username of the archiver user
+`archive_cleanup_on_calendar`     | daily      | Systemd [calendar interval](https://www.freedesktop.org/software/systemd/man/systemd.time.html#Calendar%20Events) for deleting old archive files
+`archive_cleanup_older_than_days` | 7          | Max age of files to keep in the archive spool (days)
+
+
+Usage
+-----
+
+You should not need to call this role directory. It is a dependency of the
+[archive\_job](../archive_job) role.
diff --git a/roles/archive_client/defaults/main.yml b/roles/archive_client/defaults/main.yml
index 42d3aa7..470580b 100644
--- a/roles/archive_client/defaults/main.yml
+++ b/roles/archive_client/defaults/main.yml
@@ -1,4 +1,3 @@
 archive_server_user: s-archiver
 archive_cleanup_on_calendar: daily
 archive_cleanup_older_than_days: 7
-archive_server: '{{ groups.archive_servers | first }}'
-- 
cgit