1223 - ESE warning: Target referenced by symlink is not selected for backup – Redstor

Symptom

The ESE Agent presents a warning when a symlink is selected for backup, but its target file is not. For example: "Warning: The target ‘C:\ProgramData’ referenced by symlink ‘C:\Users\All Users’ is not selected for backup".

Cause

This is intended behaviour to prevent accidental backup exclusions.

In more recent versions of Windows (such as Windows 10), the C:\Users\All Users folder is actually a symbolic link or junction that points to the C:\ProgramData folder. This is done for compatibility with older software that expects the All Users folder to exist in that location.

By default, Windows hides system files and folders to prevent accidental deletion or modification by users. Therefore, the C:\Users\All Users folder may not be visible in File Explorer unless you have enabled the option to show hidden files and folders.

To show hidden files and folders in File Explorer, you can follow these steps:

Open File Explorer.
Click on the View tab in the ribbon at the top.
Tick the Hidden items checkbox in the Show/hide section of the ribbon.

After enabling this option, you should be able to see the C:\Users\All Users folder, which will appear as a shortcut or link to the C:\ProgramData folder.

Optional workaround

To avoid seeing a warning message with every backup, you can exclude these symlinks. To do this:

Stop the Redstor Pro ESE service.
Open the a5backup.properties file.
Add the following:
```
symlink.warning.exclusions=path1,path2
```
where the specified paths are the symlinks, not the target files. Colon (:) and backslash (\) characters must always be escaped with a backslash (\), for example: "C\:\\Users\\All Users".
Save the file.
Start the ESE Agent service again.

For example:

The following warnings are seen in a Linux ESE Agent:

WARN : 11:09:08 The target '/proc/self/mounts' referenced by symlink '/etc/mtab' is not selected for backup
WARN : 11:09:08 The target '/run/cups/printcap' referenced by symlink '/etc/printcap' is not selected for backup
WARN : 11:09:08 The target '/run/systemd/resolve/stub-resolv.conf' referenced by symlink '/etc/resolv.conf' is not selected for backup

To avoid getting these warnings, excluding the following symlinks:

symlink.warning.exclusions=/etc/mtab,/etc/printcap,/etc/resolv.conf

You can also simply exclude the following:

  symlink.warning.exclusions=/etc

Or, to effectively disable all symlink warnings, exclude the following:

symlink.warning.exclusions=/

Quotation marks around the paths are optional, so "/etc/mtab","/etc/printap","/etc/resolv.conf" will also work.

Symptom

Cause

Optional workaround

Related articles