From 5264bd08ee3f8ae422b8429263cccab32ebd6d98 Mon Sep 17 00:00:00 2001 From: Patrick Canterino Date: Fri, 9 Mar 2018 14:38:06 +0100 Subject: [PATCH] Added a basic installation guide (still needs work) --- README.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 7c6ee29..b745c0c 100644 --- a/README.md +++ b/README.md @@ -2,11 +2,23 @@ DSMonRot is a script for rotating Drive Snapshot 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. +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. -## Installation +## Basic installation -TODO +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*. +2. Download Drive Snapshot from http://www.drivesnapshot.de/ and copy it to the directory mentioned in the step above +3. Create a directory for your backups (for example *D:\Backup*) +4. Edit *dsmonrot.ps1* and edit the following variables: + 1. Set ``$backupDir`` to the path you created in step 3 + 2. Specify the disks and partitions you want to backup in ``$disksToBackup``, see http://www.drivesnapshot.de/en/commandline.htm for syntax + 3. Adjust ``$dsPath`` to point to the path of Drive Snapshot (for example *C:\DSMonRot\snapshot.exe*) + 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`` + 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 ## Credits -- 2.34.1