dsmonrot.ps1

   1 # DSMonRot
   2 # Script for rotating Drive Snapshot backups monthly
   3 #
   4 # Author: Patrick Canterino <patrick@patrick-canterino.de>
   5 # WWW: https://www.patrick-canterino.de/
   6 #      https://github.com/pcanterino/dsmonrot
   7 # License: 2-Clause BSD License
   8 #
   9 # Drive Snapshot is copyright by Tom Ehlert
  10 # http://www.drivesnapshot.de/
  11
  12 # Config
  13
  14 # Path to backup directory
  15 [String]$backupDir = "Z:\"
  16 # Keep backup for this amount of months (excluding the current month),
  17 # -1 for indefinite
  18 [Int32]$keepMonths = 2
  19 # Rotate BEFORE the beginning of a full backup (default is after a successful
  20 # full backup)
  21 # WARNING: If this option is set to $True and the full backup fails you have
  22 # NO backup
  23 $rotateBeforeBackup = $False
  24 # Path to Drive Snapshot
  25 [String]$dsPath = "C:\Users\Patrick\Desktop\DSMonRot\snapshot.exe"
  26 # Path to Drive Snapshot log file (specify only the file name if you set
  27 # $dsLogFileToBackup to $True)
  28 #[String]$dsLogFile = "C:\Users\Patrick\Desktop\DSMonRot\snapshot.log"
  29 [String]$dsLogFile = "snapshot.log"
  30 # Set to $True if you want to put the log file of Drive Snapshot into the same
  31 # directory as the backup
  32 [Boolean]$dsLogFileToBackup = $True
  33 # Disks to backup, see http://www.drivesnapshot.de/en/commandline.htm
  34 [String]$disksToBackup = "HD1:1"
  35 # Path to DSMonRot log file
  36 [String]$logFile = "C:\Users\Patrick\Desktop\DSMonRot\dsmonrot.log"
  37
  38 # Map network share to this drive letter, comment out if you don't want to use it
  39 [String]$smbDrive = "Z"
  40 # Path to network share
  41 [String]$smbPath = "\\192.168.0.3\ds"
  42 # User and password for connecting to network share, comment out if you don't want to use it
  43 # (for example if you want to pass current Windows credentials)
  44 [String]$smbUser = "patrick"
  45 [String]$smbPassword = ""
  46
  47 # Send an email if an error occured
  48 [Boolean]$emailOnError = $True
  49 # From address of email notification
  50 [String]$emailFromAddress = "alarm@test.local"
  51 # To address of email notification
  52 [String]$emailToAddress = "patrick@test.local"
  53 # Subject of email notification
  54 [String]$emailSubject = "DSMonRot on $env:computername"
  55 # Mail server
  56 [String]$emailMailserver = "localhost"
  57 # SMTP Port
  58 [Int32]$emailPort = 25
  59 # Use SSL?
  60 [Boolean]$emailSSL = $False
  61 # Use SMTP Auth?
  62 [Boolean]$emailAuth = $False
  63 # SMTP Auth User
  64 [String]$emailUser = ""
  65 # SMTP Auth Password
  66 [String]$emailPassword = ""
  67
  68 # End of config
  69
  70 $dsAdditionalArgs = @("--UseVSS")
  71
  72 # Allow SMTP with SSL and SMTP Auth
  73 # see: http://petermorrissey.blogspot.de/2013/01/sending-smtp-emails-with-powershell.html
  74 function Send-Email([String]$body) {
  75         Write-Host "Sending email: $emailToAddress, $body"
  76
  77         try {
  78                 $smtp = New-Object System.Net.Mail.SmtpClient($emailMailServer, $emailPort)
  79
  80                 $smtp.EnableSSL = $emailSSL
  81
  82                 if($emailAuth) {
  83                         $smtp.Credentials = New-Object System.Net.NetworkCredential($emailUser, $emailPassword)
  84                 }
  85
  86                 $smtp.Send($emailFromAddress, $emailToAddress, $emailSubject, $body)
  87         }
  88         catch {
  89                 Write-Host "Could not send email: $_.Exception.Message"
  90         }
  91 }
  92
  93 function Rotate-Backup {
  94         if($keepMonths -lt 0) {
  95                 return
  96         }
  97
  98         Write-Host "Rotating"
  99
 100         $keepMonthsCount = $keepMonths
 101
 102         Get-ChildItem $backupDir -Directory | Where-Object {($_.Name -ne $currMonth) -and ($_.Name -match "^\d{4,}-\d{2}$")} | Sort-Object -Descending |
 103         Foreach-Object {
 104                 Write-Host $_ "=>" $_.FullName
 105
 106                 if($keepMonthsCount -ge 0) {
 107                         $keepMonthsCount--
 108                 }
 109
 110                 if($keepMonthsCount -eq -1) {
 111                         Write-Host "Deleting $_"
 112                         Remove-Item -Recurse -Force $_.FullName
 113                 }
 114         }
 115 }
 116
 117 $startTime = Get-Date -format "yyyy-MM-dd HH:mm:ss"
 118 Write-Host "Started at $startTime"
 119
 120 $errorMessages = @()
 121
 122 $smbConnected = $False
 123 $doBackup = $False
 124 $success = $False
 125
 126 if($smbDrive) {
 127         Try {
 128                 Write-Host "Connecting network drive"
 129
 130                 if($smbUser -and $smbPassword) {
 131                         Write-Host "With credentials"
 132
 133                         $secSmbPassword = $smbPassword | ConvertTo-SecureString -asPlainText -Force
 134                         $smbCredential = New-Object System.Management.Automation.PSCredential($smbUser, $secSmbPassword)
 135
 136                         New-PSDrive -Name $smbDrive -PSProvider "FileSystem" -Root $smbPath -Credential $smbCredential -Persist -ErrorAction Stop
 137                 }
 138                 else {
 139                         Write-Host "Without credentials"
 140
 141                         New-PSDrive -Name $smbDrive -PSProvider "FileSystem" -Root $smbPath -Persist -ErrorAction Stop
 142                 }
 143
 144                 $smbConnected = $True
 145         }
 146         Catch {
 147                 Write-Host "Could not connect to network drive $smbDrive`: $_.Exception.Message"
 148                 exit
 149         }
 150 }
 151
 152 if(!(Test-Path $backupDir)) {
 153         Write-Host "Directory $backupDir does not exist!"
 154         exit
 155 }
 156
 157 $currMonth = Get-Date -format "yyyy-MM"
 158 $currDay = Get-Date -format "yyyy-MM-dd"
 159
 160 Write-Host $currMonth
 161
 162 $backupTarget = $backupDir + "\" + $currMonth
 163 $backupTargetFull = $backupTarget + "\" + "Full"
 164
 165 $backupTargetDiff = $backupTarget + "\" + "Diff-" + $currDay
 166
 167 Write-Host $backupTarget
 168
 169 $isDiff = $False
 170
 171 if((Test-Path $backupTarget) -and (Test-Path $backupTargetFull) -and (Test-Path "$backupTargetFull\*.hsh")) {
 172         Write-Host "Differential backup"
 173
 174         $isDiff = $True
 175
 176         if(!(Test-Path $backupTargetDiff)) {
 177                 Write-Host "Creating directory $backupTargetDiff"
 178
 179                 try {
 180                         New-Item -ItemType directory -Path $backupTargetDiff -ErrorAction Stop
 181                         $doBackup = $True
 182                 }
 183                 catch {
 184                         Write-Host "Could not create directory $backupTargetDiff`: $_.Exception.Message"
 185                         $errorMessages += "Could not create directory $backupTargetDiff`: $_.Exception.Message"
 186                 }
 187
 188                 if($doBackup) {
 189                         $dsLogPath = if($dsLogFileToBackup) { "$backupTargetDiff\$dsLogFile" } else { $dsLogFile }
 190
 191                         $dsArgs = @($disksToBackup, "--logfile:$dsLogPath", "$backupTargetDiff\`$disk.sna", "-h$backupTargetFull\`$disk.hsh") + $dsAdditionalArgs
 192                         Write-Host $dsPath ($dsArgs -join " ")
 193
 194                         & $dsPath $dsArgs
 195
 196                         if($LastExitCode -ne 0) {
 197                                 Write-Host "Drive Snapshot failed to backup! Exit code: $LastExitCode"
 198                                 $errorMessages += "Drive Snapshot failed to backup! Exit code: $LastExitCode"
 199                         }
 200                         else {
 201                                 $success = $True
 202                         }
 203                 }
 204         }
 205         else {
 206                 Write-Host "Directory $backupTargetDiff already exists!"
 207                 $errorMessages += "Directory $backupTargetDiff already exists!"
 208         }
 209 }
 210 else {
 211         Write-Host "Full backup"
 212
 213         if(!(Test-Path $backupTarget)) {
 214                 Write-Host "Creating directory $backupTarget"
 215
 216                 try {
 217                         New-Item -ItemType directory -Path $backupTarget -ErrorAction Stop
 218                 }
 219                 catch {
 220                         Write-Host "Could not create directory $backupTarget`: $_.Exception.Message"
 221                         $errorMessages += "Could not create directory $backupTarget`: $_.Exception.Message"
 222                 }
 223         }
 224
 225         if(!(Test-Path $backupTargetFull)) {
 226                 Write-Host "Creating directory $backupTargetFull"
 227
 228                 try {
 229                         New-Item -ItemType directory -Path $backupTargetFull -ErrorAction Stop
 230                         $doBackup = $True
 231                 }
 232                 catch {
 233                         Write-Host "Could not create directory $backupTargetFull`: $_.Exception.Message"
 234                         $errorMessages += "Could not create directory $backupTargetFull`: $_.Exception.Message"
 235                 }
 236         }
 237         else {
 238                 $doBackup = $True
 239         }
 240
 241         if($doBackup) {
 242                 if($rotateBeforeBackup) {
 243                         Rotate-Backup
 244                 }
 245
 246                 $dsLogPath = if($dsLogFileToBackup) { "$backupTargetFull\$dsLogFile" } else { $dsLogFile }
 247
 248                 $dsArgs = @($disksToBackup, "--logfile:$dsLogPath", "$backupTargetFull\`$disk.sna") + $dsAdditionalArgs
 249                 Write-Host $dsPath ($dsArgs -join " ")
 250
 251                 & $dsPath $dsArgs
 252
 253                 if($LastExitCode -ne 0) {
 254                         Write-Host "Drive Snapshot failed to backup! Exit code: $LastExitCode"
 255                         $errorMessages += "Drive Snapshot failed to backup! Exit code: $LastExitCode"
 256                 }
 257                 else {
 258                         $success = $True
 259                 }
 260
 261                 if($rotateBeforeBackup -eq $False -and $success -eq $True) {
 262                         Rotate-Backup
 263                 }
 264         }
 265 }
 266
 267 if($smbConnected) {
 268         Write-Host "Disconnecting network drive"
 269
 270         try {
 271                 Remove-PSDrive $smbDrive -ErrorAction Stop
 272         }
 273         catch {
 274                 Write-Host "Could not disconnect network drive $smbDrive`: $_.Exception.Message"
 275                 $errorMessages +=  "Could not disconnect network drive $smbDrive`: $_.Exception.Message"
 276         }
 277 }
 278
 279 if($emailOnError -and $errorMessages.Count -gt 0) {
 280         $emailBody  = "This is DSMonRot on $env:computername, started at $startTime.`n"
 281         $emailBody += "An error occured while performing a backup. Below are the error messages and some status information.`n`n"
 282         $emailBody += "Differential backup: $isDiff`n"
 283         $emailBody += "Backup successfull:  $success`n`n"
 284         $emailBody += ($errorMessages -join "`n")
 285
 286         Send-Email ($emailBody)
 287 }
 288
 289 $endTime = Get-Date -format "yyyy-MM-dd HH:mm:ss"
 290 Write-Host "Ended at $endTime"