X-Git-Url: https://git.p6c8.net/dsmonrot.git/blobdiff_plain/5264bd08ee3f8ae422b8429263cccab32ebd6d98..70fdaec308c09806a989e53aae914e5af4e9dae5:/README.md?ds=sidebyside diff --git a/README.md b/README.md index b745c0c..29c13dc 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,14 @@ # DSMonRot -DSMonRot is a script for rotating Drive Snapshot backups monthly (DSMonRot stands for **D**rive **S**napshot **Mon**thly **Rot**ate). +DSMonRot is a script for rotating [Drive Snapshot](http://www.drivesnapshot.de/) backups monthly (DSMonRot stands for **D**rive **S**napshot **Mon**thly **Rot**ate). It's main purpose is to create a full backup at the beginning and then create differential backups for the rest of the month. Furthermore it rotates the backups after every successful full backup allowing you to keep only a certain amount of monthly backup sets. DSMonRot creates monthly log files allowing you to check for success or errors. +## Requirements + +* PowerShell 4.0 (or higher) +* [Drive Snapshot](http://www.drivesnapshot.de/) (tested with version 1.45) + ## Basic installation 1. Copy *dsmonrot.ps1* to arbitrary directory (for example *C:\DSMonRot*). You should also sign this script file or set PowerShell execution policy to *Unrestricted*. @@ -16,9 +21,9 @@ It's main purpose is to create a full backup at the beginning and then create di 4. Specify the number of months to keep the backups by adjusting ``$keepMonths`` (the current month does not count, so if you set this variable to ``2``, DSMonRot keeps the current month **and** the last two months), set to ``0`` if you only want to keep the current month, set to ``-1`` if you don't want to delete any backup (not recommended) 5. After adjusting ``$keepMonths``, you should also adjust ``$keepLogs`` to at least the same amount. This variable controls the number of log files, DSMonRot keeps. 5. If your backup directory is on a SMB share, you have to edit the variables ``$smbDrive``, ``$smbPath``, ``$smbUser`` and ``$smbPassword`` - 6. If you want DSMonRot to send a mail if an error occuris, you have to edit the variables ``$emailOnError``, ``$emailFromAddress``, ``$emailToAddress``, ``$emailSubject``, ``$emailMailserver``, ``$emailPort``, ``$emailSSL``, ``$emailAuth``, ``$emailUser`` and ``$emailPassword`` + 6. If you want DSMonRot to send a mail if an error occurs, you have to edit the variables ``$emailOnError``, ``$emailFromAddress``, ``$emailToAddress``, ``$emailSubject``, ``$emailMailserver``, ``$emailPort``, ``$emailSSL``, ``$emailAuth``, ``$emailUser`` and ``$emailPassword`` 7. If you want to adjust more configuration variables, just have a look at the comments preceeding each variable. -5. Configure Windows task planner to execute your script +5. Configure Windows task planner to execute the script ## Credits