{"id":35,"date":"2009-01-27T08:30:36","date_gmt":"2009-01-27T08:30:36","guid":{"rendered":"http:\/\/nsrd.wordpress.com\/?p=35"},"modified":"2018-12-12T16:37:34","modified_gmt":"2018-12-12T06:37:34","slug":"basics-listing-files-in-a-backup","status":"publish","type":"post","link":"https:\/\/nsrd.info\/blog\/2009\/01\/27\/basics-listing-files-in-a-backup\/","title":{"rendered":"Basics – Listing files in a backup"},"content":{"rendered":"

A fairly common question I get asked is “How can I find out what files were backed up?”<\/p>\n

This is actually fairly easy, particularly if you’re prepared to use the command line. You need to run two commands – mminfo, and nsrinfo.<\/p>\n

The command mminfo accesses the NetWorker media database, and is used to pull out details of the saveset whose files you want to view. The nsrinfo command is then used to retrieve the relevant information from the client file index.<\/p>\n

For example, consider the following situation – there’s two incremental backups of the “\/etc” directory on the machine “faero”, and we want to know what was backed up in each backup. First, run mminfo to retrieve the nsavetime<\/em>, which we use in nsrinfo. The mminfo command might resemble the following:<\/p>\n

# mminfo -q \"name=\/etc,volume=Default.001.RO,level=incr\"\n-r \"savetime(22),nsavetime\"\n     date     time      save time\n     01\/27\/09 09:57:52 1233010672\n     01\/27\/09 16:39:04 1233034744<\/pre>\n
Having retrieved the nsavetime<\/em> field, we can then feed that into nsrinfo in order to get the list of files for that backup:<\/p>\n
# nsrinfo -t 1233034744 faero\nscanning client `faero' for savetime 1233034744(Tue Jan 27 16:39:04 2009)\nfrom the backup namespace\n\/etc\/svc\/volatile\/\/\n\/etc\/svc\/\n\/etc\/mnttab\/\/\n\/etc\/\n\/\n5 objects found<\/pre>\n
(So the most common invocation format of nsrinfo is: “nsrinfo -t nsavetime clientName”)<\/p>\n
Like most NetWorker commands, nsrinfo will also accept a “-v” option for verbosity. Include this in your nsrinfo command and you get a whole lot more information. For example, a short excerpt from the same nsavetime\/saveset used above would resemble the following:<\/p>\n
# nsrinfo -v -t 1233034744 faero\nscanning client `faero' for savetime 1233034744(Tue Jan 27 16:39:04 2009)\nfrom the backup namespace\nUNIX ASDF v2 file `\/etc\/svc\/volatile\/\/', NSR size=160, fid = 0.0, file size=512\nUNIX ASDF v2 file `\/etc\/svc\/', NSR size=632, fid = 4294967295.1520, file size=1024\n  ndirentry->1433       ..\n  ndirentry->0  volatile\/\/\n  ndirentry->1945       repository.db\n  ndirentry->978        repository-boot\n  ndirentry->1002       repository-manifest_import\n  ndirentry->4310       repository-manifest_import-20070225_055641\n  ndirentry->714        repository-boot-20070907_074755\n  ndirentry->1001       repository-manifest_import-20070907_074828\n  ndirentry->44611      repository-manifest_import-20070225_093651\n  ndirentry->988        repository-boot-20071004_111149\n  ndirentry->1014       repository-boot-20080414_023012\n  ndirentry->1066       repository-boot-20070920_041017\nUNIX ASDF v2 file `\/etc\/mnttab\/\/', NSR size=156, fid = 0.0, file size=512\nUNIX ASDF v2 file `\/etc\/', NSR size=5040, fid = 4294967295.1433, file size=4608\n  ndirentry->2  ..\n  ndirentry->1434       TIMEZONE<\/pre>\n
As you can see, this is a lot more information. It’s not necessarily information you need all the time, but like so many other chunks of information retievable from NetWorker, it’s useful to know how<\/em> to retrieve it, and<\/em> that it’s available should you need it.<\/p>\n
If you’re wondering how<\/em> NetWorker knows which saveset to retrieve based on the nsavetime<\/em>, it’s simple – for any individual client, no two savesets will ever<\/em> be generated with the same nsavetime<\/em>. Check it out for yourself if you’re not sure. For example, from a backup with parallelism of 12 for one client (i.e,. higher parallelism than savesets), the savesets were generated as follows:<\/p>\n
# mminfo -q \"client=faero\" -r \"name,level,savetime(22),nsavetime\" -ot\n name                            lvl     date     time      save time\n\/opt\/ActivePerl-5.8             full     01\/27\/09 09:49:01 1233010141\n\/opt\/IDATA                      full     01\/27\/09 09:49:02 1233010142\n\/space\/debug\/2                  full     01\/27\/09 09:49:03 1233010143\n\/space\/debug\/1                  full     01\/27\/09 09:49:04 1233010144\n\/opt\/SUNWrtvc                   full     01\/27\/09 09:49:05 1233010145\n\/opt\/SUNWmlib                   full     01\/27\/09 09:49:06 1233010146\n\/etc                            full     01\/27\/09 09:50:15 1233010215\nindex:faero                     full     01\/27\/09 09:55:29 1233010529\nbootstrap                       full     01\/27\/09 09:55:30 1233010530<\/pre>\n
So you can see – even with parallelism greater than one, there’s always at least<\/em> one second difference between the start time for savesets.<\/p>\n","protected":false},"excerpt":{"rendered":"
A fairly common question I get asked is “How can I find out what files were backed up?” This is…<\/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":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[16,20],"tags":[464,1249,1253,871],"class_list":["post-35","post","type-post","status-publish","format-standard","hentry","category-networker","category-scripting","tag-index","tag-networker","tag-scripting","tag-scripts"],"aioseo_notices":[],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pKpIN-z","jetpack_sharing_enabled":true,"jetpack_likes_enabled":true,"_links":{"self":[{"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/posts\/35","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=35"}],"version-history":[{"count":1,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/posts\/35\/revisions"}],"predecessor-version":[{"id":7699,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/posts\/35\/revisions\/7699"}],"wp:attachment":[{"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/media?parent=35"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/categories?post=35"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nsrd.info\/blog\/wp-json\/wp\/v2\/tags?post=35"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}