Skip to main content

Veeam NAS Backup: Invalid Root Item Type

  • October 25, 2023
  • 6 comments
  • 780 views

MicoolPaul
Forum|alt.badge.img+23
Alt Text: Title image with the topic title as it’s text

Hi, a quick workaround story today from the field.

I configured a NAS Backup job that was to protect an SMB share with a bunch of sub-folders & files. When the job ran, no files and only a few folders had been processed. When I browsed the backup, the folders I was critically aiming to protect were all missing.

Upon further investigation of the share, the folders weren’t “actual” folders, but were instead unsupported symlinks. I discovered this because I attempted to change the scope of the backup job to a particular subfolder to confirm access. When I tried this, I received the following error message:

Unable to backup root folder <Folder Name>: folder is unavailable. Invalid root item type: a file or a symlink is detected when a folder is required. Path: [Path [<Path>], RootId [ffffffffffffffff]]

Well, that’s not good! Because these were soft symlinks, this was the reason why Veeam was unable to process the data. But there is a workaround!

If you add a new file share to Veeam that contains the symlink as part of its path, Veeam can process the symlink’d path absolutely fine.

For example, if you were targeting:

\\Servername\ShareName

And trying to backup a folder called ‘SymlinkFolder’ and its subfolder contents, you would instead add the following share:

\\Servername\ShareName\SymlinkFolder

Then your backup job will process the folder as normal.

Hope this helps!

6 comments

coolsport00
Forum|alt.badge.img+21
  • Veeam Legend
  • 4903 comments
  • October 25, 2023

Nice share! I was juuuuust re-reading about this (if I was reading it right) in the What’s New doc by Anton last night. See under “Backup Engine” section. At least I assume that’s what he was referring to?


Chris.Childerhose
Forum|alt.badge.img+21
  • Veeam Legend, Veeam Vanguard
  • 9585 comments
  • October 25, 2023

Great summary to help the community.  I read this already on your blog and it is nice to see a workaround.


MicoolPaul
Forum|alt.badge.img+23
  • Author
  • 2425 comments
  • October 25, 2023

Nice share! I was juuuuust re-reading about this (if I was reading it right) in the What’s New doc by Anton last night. See under “Backup Engine” section. At least I assume that’s what he was referring to?

I believe so, I haven’t compared this behaviour to V11 as it’s the first time I’ve seen symbolic links in a NAS Backup, won’t have any time to test in the near future to confirm though.


CarySun
Forum|alt.badge.img+7
  • Veeam Vanguard
  • 206 comments
  • October 26, 2023

Good to know. Thank you for sharing.


leduardoserrano
Forum|alt.badge.img+6
  • On the path to Greatness
  • 353 comments
  • October 26, 2023

Thanks for sharing, @MicoolPaul 


Moustafa_Hindawi
Forum|alt.badge.img+6

Nice share @MicoolPaul Thank you so much for your efforts