Veeam NAS Backup: Invalid Root Item Type

  • 25 October 2023
  • 6 comments
  • 169 views

Userlevel 7
Badge +20
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

Userlevel 7
Badge +17

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?

Userlevel 7
Badge +20

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

Userlevel 7
Badge +20

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.

Userlevel 7
Badge +7

Good to know. Thank you for sharing.

Userlevel 7
Badge +6

Thanks for sharing, @MicoolPaul 

Userlevel 7
Badge +6

Nice share @MicoolPaul Thank you so much for your efforts

Comment