8df3a17cde
The formulation "Keep backups for the last N intervals" might suggest that intervals without backups also count, which they do not. Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
115 lines
5.2 KiB
HTML
115 lines
5.2 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<style>
|
|
/* similar to sphinx alabaster theme ones */
|
|
body {
|
|
max-width: 90ch;
|
|
margin-left: 2ch;
|
|
margin-right: 2ch;
|
|
line-height: 1.4em;
|
|
/* avoid the very high contrast of black on white, tone it down a bit */
|
|
color: #3E4349;
|
|
hyphens: auto;
|
|
text-align: left;
|
|
font-family: 'Open Sans', sans-serif;
|
|
font-size: 17px;
|
|
}
|
|
h1, h2, h3, h4, h5, h6 {
|
|
color: #2a2b2c;
|
|
font-family: Lato, sans-serif;
|
|
}
|
|
h1, h2, h3 {
|
|
font-size: 150%;
|
|
line-height: 1.2;
|
|
}
|
|
h4, h5, h6 {
|
|
font-size: 125%;
|
|
}
|
|
tt, code {
|
|
background-color: #ecf0f3;
|
|
color: #222;
|
|
}
|
|
pre, tt, code {
|
|
font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
|
|
font-size: 0.9em;
|
|
}
|
|
div.note {
|
|
background-color: #EEE;
|
|
border: 1px solid #CCC;
|
|
margin: 10px 0;
|
|
padding: 0px 20px;
|
|
}
|
|
p.note-title {
|
|
font-weight: bolder;
|
|
padding: 0;
|
|
margin: 10px 0 0 0;
|
|
}
|
|
div.note > p.last {
|
|
margin: 5px 0 10px 0;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<p>A simulator to experiment with different backup schedules and prune options.</p>
|
|
|
|
<h3>Simulation Options</h3>
|
|
<h4>Time Range</h4>
|
|
|
|
<p>A backup job scenario is simulated for a <code>Duration</code> in weeks, ending with the
|
|
configurable <code>End Date</code> and <code>End Time</code>. By default, 15 weeks are simulated,
|
|
ending with the current date and time.</p>
|
|
|
|
<h4>Schedule</h4>
|
|
<p>Select weekdays with the combobox and input hour and minute
|
|
specification separated by a colon, i.e. <code>HOUR:MINUTE</code>. Each of
|
|
<code>HOUR</code> and <code>MINUTE</code> can be either a single value or
|
|
one of the following:</p>
|
|
<ul class="simple">
|
|
<li>a comma-separated list: e.g., <code>01,02,03</code></li>
|
|
<li>a range: e.g., <code>01..10</code></li>
|
|
<li>a repetition: e.g, <code>05/10</code> (means starting at <code>5</code> every <code>10</code>)</li>
|
|
<li>a combination of the above: e.g., <code>01,05..10,12/02</code></li>
|
|
<li>a <code>*</code> for every possible value</li>
|
|
</ul>
|
|
|
|
<h3>Pruning</h3>
|
|
<p>Prune lets you systematically delete older backups, retaining backups for
|
|
the last given number of time intervals. The following retention options are
|
|
available:</p>
|
|
<dl class="docutils">
|
|
<dt><code class="docutils literal notranslate"><span class="pre">keep-last</span> <span class="pre"><N></span></code></dt>
|
|
<dd>Keep the last <code class="docutils literal notranslate"><span class="pre"><N></span></code> backup snapshots.</dd>
|
|
<dt><code class="docutils literal notranslate"><span class="pre">keep-hourly</span> <span class="pre"><N></span></code></dt>
|
|
<dd>Keep backups for the last <code class="docutils literal notranslate"><span class="pre"><N></span></code> hours. If there is more than one
|
|
backup for a single hour, only the latest is kept. Hours without backups do not count.</dd>
|
|
<dt><code class="docutils literal notranslate"><span class="pre">keep-daily</span> <span class="pre"><N></span></code></dt>
|
|
<dd>Keep backups for the last <code class="docutils literal notranslate"><span class="pre"><N></span></code> days. If there is more than one
|
|
backup for a single day, only the latest is kept. Days without backups do not count.</dd>
|
|
<dt><code class="docutils literal notranslate"><span class="pre">keep-weekly</span> <span class="pre"><N></span></code></dt>
|
|
<dd>Keep backups for the last <code class="docutils literal notranslate"><span class="pre"><N></span></code> weeks. If there is more than one
|
|
backup for a single week, only the latest is kept. Weeks without backups do not count.
|
|
<div class="last admonition note">
|
|
<p class="note-title">Note:</p>
|
|
<p class="last">Weeks start on Monday and end on Sunday. The software
|
|
uses the <a class="reference external" href="https://en.wikipedia.org/wiki/ISO_week_date">ISO week date</a> system and handles weeks at
|
|
the end of the year correctly.</p>
|
|
</div>
|
|
</dd>
|
|
<dt><code class="docutils literal notranslate"><span class="pre">keep-monthly</span> <span class="pre"><N></span></code></dt>
|
|
<dd>Keep backups for the last <code class="docutils literal notranslate"><span class="pre"><N></span></code> months. If there is more than one
|
|
backup for a single month, only the latest is kept. Months without backups do not count.</dd>
|
|
<dt><code class="docutils literal notranslate"><span class="pre">keep-yearly</span> <span class="pre"><N></span></code></dt>
|
|
<dd>Keep backups for the last <code class="docutils literal notranslate"><span class="pre"><N></span></code> years. If there is more than one
|
|
backup for a single year, only the latest is kept. Years without backups do not count.</dd>
|
|
</dl>
|
|
<p>The retention options are processed in the order given above. Each option
|
|
only covers backups within its time period. The next option does not take care
|
|
of already covered backups. It will only consider older backups.</p>
|
|
<p>For example, in a week covered by <code>keep-weekly</code>, one backup is
|
|
kept while all others are removed; <code>keep-monthly</code> then does not
|
|
consider backups from that week anymore, even if part of the week is part of
|
|
an earlier month.</p>
|
|
</body>
|
|
</html>
|