{"id":5329,"date":"2014-10-23T11:49:46","date_gmt":"2014-10-23T01:49:46","guid":{"rendered":"http:\/\/nsrd.info\/blog\/?p=5329"},"modified":"2018-12-11T13:39:45","modified_gmt":"2018-12-11T03:39:45","slug":"backing-up-renamed-directories","status":"publish","type":"post","link":"https:\/\/nsrd.info\/blog\/2014\/10\/23\/backing-up-renamed-directories\/","title":{"rendered":"Backing up renamed directories"},"content":{"rendered":"<p>Long-term NetWorker administrators&nbsp;may remember that NetWorker used to have a somewhat odd mechanism of dealing with renamed&nbsp;directories. Nowadays the&nbsp;<em>default<\/em> option for any new client is to&nbsp;enable&nbsp;<em>backup renamed directories<\/em>, and this is a good thing, even though it might end up using a bit more backup media.<\/p>\n<p>To explain the difference between&nbsp;<em>then<\/em> and&nbsp;<em>now<\/em>, and why the new default is so much better, I first have to setup a scenario.<\/p>\n<p>Consider a client that has a directory called&nbsp;<strong>\/renaming\/backup<\/strong>, and underneath that directory there&#8217;s another directory&nbsp;called&nbsp;<strong>\/renaming\/backup\/alpha<\/strong>. The named saveset for this client will be <strong>\/renaming\/backup<\/strong>, which will capture all subdirectories.<\/p>\n<p>In our scenario, there will first be a full backup of \/renaming\/backup, then the&nbsp;<em>alpha<\/em>&nbsp;directory will be renamed to&nbsp;<em>beta<\/em>, and a new backup taken.<\/p>\n<p>Temporarily reinstating the&nbsp;<em>old<\/em> mechanism by turning off &#8220;backup renamed directories&#8221; for this client, there&#8217;s a considerable difference between the full backup done with a \/renaming\/backup\/alpha subdirectory and the subsequent incremental with alpha renamed to beta. First, the full:<\/p>\n<p><a href=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-before-rename.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-5333\" src=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-before-rename-1024x900.png\" alt=\"Backup Renamed Directories Off, Full Backup\" width=\"695\" height=\"610\" srcset=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-before-rename-1024x900.png 1024w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-before-rename-300x263.png 300w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-before-rename-900x791.png 900w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-before-rename.png 1526w\" sizes=\"auto, (max-width: 695px) 100vw, 695px\" \/><\/a><\/p>\n<p>After that backup was taken, I renamed the&nbsp;<em>alpha<\/em> directory to&nbsp;<em>beta<\/em> and re-ran the backup. Here&#8217;s what the savegroup completion looked like:<\/p>\n<p><a href=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-after-rename.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-5334\" src=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-after-rename-1024x900.png\" alt=\"Backup renamed directories off, incremental backup after directory rename\" width=\"695\" height=\"610\" srcset=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-after-rename-1024x900.png 1024w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-after-rename-300x263.png 300w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-after-rename-900x791.png 900w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-off-backup-after-rename.png 1528w\" sizes=\"auto, (max-width: 695px) 100vw, 695px\" \/><\/a><\/p>\n<p>You&#8217;ll note there that&nbsp;the size of&nbsp;the incremental backup of \/renaming\/backup was just 2KB, which would be around consistent with backing up the details associated with a changed directory, but nothing underneath that directory.<\/p>\n<p>And that was sort of&nbsp;the problem with the old method, right there. A recovery following that second backup of \/renaming\/backup&nbsp;would yield&nbsp;<em>odd<\/em> results:<\/p>\n<pre>[root@centaur backup]# <strong>recover<\/strong>\nCurrent working directory is \/renaming\/backup\/\nrecover&gt; <strong>add beta<\/strong>\n\/renaming\/backup\/beta\n1 file(s) marked for recovery\nrecover&gt; <strong>relocate \/renaming\/recovery\/backup-rename-off<\/strong>\nrecover&gt; <strong>recover<\/strong>\nRecovering 1 file from \/renaming\/backup\/ into \/renaming\/recovery\/backup-rename-off\nVolumes needed (all on-line):\n&nbsp; &nbsp; &nbsp; &nbsp; centaur.003 at AFTD-01\nTotal estimated disk space needed for recover is 36 KB.\nRequesting 1 file(s), this may take a while...\nRecover start time: Mon 20 Oct 2014 19:52:42 AEDT\nRequesting 1 recover session(s) from server.\n91651:recover: Successfully established AFTD DFA session for recovering save-set ID '4114926770'.\n.\/beta\/\nReceived 1 file(s) from NSR server `centaur'\nRecover completion time: Mon 20 Oct 2014 19:52:42 AEDT\nrecover&gt; \n\n[root@centaur backup]# <strong>cd ..<\/strong>\n[root@centaur renaming]# <strong>ls<\/strong>\nbackup&nbsp; recovery\n[root@centaur renaming]# <strong>cd recovery<\/strong>\n[root@centaur recovery]# <strong>ls<\/strong>\nbackup-rename-off\n[root@centaur recovery]# <strong>cd backup-rename-off\/<\/strong>\n[root@centaur backup-rename-off]# <strong>ls<\/strong>\nbeta\n[root@centaur backup-rename-off]# <strong>cd beta<\/strong>\n[root@centaur beta]# <strong>ls<\/strong>\n<em>&lt;crickets chirping&gt;<\/em><\/pre>\n<p>To recover the contents of the&nbsp;<em>beta<\/em> directory, one had to instead switch to a browse time&nbsp;<em>before<\/em> the rename happened, and recover the old directory name. As you might imagine,&nbsp;this required rather intimate knowledge for&nbsp;the&nbsp;recovery operator of when&nbsp;directories had been renamed.<\/p>\n<p>Jumping forward to&nbsp;<em>now<\/em>, we have a much more agreeable mechanism. After a&nbsp;delete of all the backups for the client, the&nbsp;backup process takes up a bit more space, but results in a simpler, more reliable recovery. First, I renamed \/renaming\/backup\/beta <em>back<\/em> to \/renaming\/backup\/alpha. Then,&nbsp;the full backup:<\/p>\n<p><a href=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-directories-on-before-rename.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-5335\" src=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-directories-on-before-rename-981x1024.png\" alt=\"Full backup with backup renamed directories on\" width=\"695\" height=\"725\" srcset=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-directories-on-before-rename-981x1024.png 981w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-directories-on-before-rename-287x300.png 287w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-directories-on-before-rename-24x24.png 24w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-directories-on-before-rename-900x939.png 900w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-rename-directories-on-before-rename.png 1282w\" sizes=\"auto, (max-width: 695px) 100vw, 695px\" \/><\/a><\/p>\n<p>After that backup completed, I renamed \/renaming\/backup\/alpha to \/renaming\/backup\/beta and re-ran the backup &#8211; again, as an incremental:<\/p>\n<p><a href=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-renamed-directories-on-after-rename.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-5336\" src=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-renamed-directories-on-after-rename-981x1024.png\" alt=\"Backup renamed directories on, incr backup after renaming a directory\" width=\"695\" height=\"725\" srcset=\"https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-renamed-directories-on-after-rename-981x1024.png 981w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-renamed-directories-on-after-rename-287x300.png 287w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-renamed-directories-on-after-rename-24x24.png 24w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-renamed-directories-on-after-rename-900x939.png 900w, https:\/\/nsrd.info\/blog\/wp-content\/uploads\/2014\/10\/backup-renamed-directories-on-after-rename.png 1284w\" sizes=\"auto, (max-width: 695px) 100vw, 695px\" \/><\/a><\/p>\n<p>You&#8217;ll notice in this scenario the incremental is as big as the previous full, since the alpha (or beta) directory is the only subdirectory of \/renaming\/backup.<\/p>\n<p>However, that little hit on the backup space is more than made up for by a simplified&nbsp;recovery process.&nbsp;Executing a recovery after the&nbsp;second backup completes yields the following results:<\/p>\n<pre>[root@centaur backup]# <strong>recover<\/strong>\nCurrent working directory is \/renaming\/backup\/\nrecover&gt; <strong>ls<\/strong>\n&nbsp;beta\nrecover&gt; <strong>add beta<\/strong>\n11 file(s) marked for recovery\nrecover&gt; <strong>relocate \/renaming\/recovery\/backup-renamed-on<\/strong>\nrecover&gt; <strong>recover<\/strong>\nRecovering 11 files within \/renaming\/backup\/ into \/renaming\/recovery\/backup-renamed-on\nVolumes needed (all on-line):\n&nbsp; &nbsp; &nbsp; &nbsp; centaur.003 at AFTD-01\nTotal estimated disk space needed for recover is 1047 MB.\nRequesting 11 file(s), this may take a while...\nRecover start time: Mon 20 Oct 2014 20:03:29 AEDT\nRequesting 1 recover session(s) from server.\n91651:recover: Successfully established AFTD DFA session for recovering save-set ID '4014264195'.\n.\/beta\/file-2MB.dat\n.\/beta\/file-32MB.dat\n.\/beta\/file-1MB.dat\n.\/beta\/file-512MB.dat\n.\/beta\/file-128MB.dat\n.\/beta\/file-4MB.dat\n.\/beta\/file-16MB.dat\n.\/beta\/file-8MB.dat\n.\/beta\/file-256MB.dat\n.\/beta\/file-64MB.dat\n.\/beta\/\nReceived 11 file(s) from NSR server `centaur'\nRecover completion time: Mon 20 Oct 2014 20:03:36 AEDT<\/pre>\n<p>If the version of NetWorker you&#8217;re using was setup more recently,&nbsp;it&#8217;s more than likely&nbsp;clients you&#8217;ve created have&nbsp;<em>backup renamed directories<\/em> already turned on. If you&#8217;re working with an older version of NetWorker, or a NetWorker server that has been&nbsp;in use since version 7.4 or older, it&#8217;s possible legacy clients still have the option turned off.<\/p>\n<p>I heartily recommend all filesystem clients&nbsp;<em>always<\/em> have&nbsp;<em>backup renamed directories<\/em> enabled.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Long-term NetWorker administrators&nbsp;may remember that NetWorker used to have a somewhat odd mechanism of dealing with renamed&nbsp;directories. Nowadays the&nbsp;default option&hellip;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[5,19],"tags":[138,1190,818,1191],"class_list":["post-5329","post","type-post","status-publish","format-standard","hentry","category-backup-theory","category-recovery","tag-backup","tag-backup-renamed-directories","tag-rename","tag-renamed"],"aioseo_notices":[],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pKpIN-1nX","jetpack_sharing_enabled":true,"jetpack_likes_enabled":true,"_links":{"self":[{"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/posts\/5329","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/comments?post=5329"}],"version-history":[{"count":3,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/posts\/5329\/revisions"}],"predecessor-version":[{"id":7449,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/posts\/5329\/revisions\/7449"}],"wp:attachment":[{"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/media?parent=5329"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/categories?post=5329"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/tags?post=5329"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}