When starting a backup for a system protected by the ShadowSnap agent, you receive the error message, "Backup failed due to unknown error in the agent software."
In legacy versions of the Datto IRIS environment, this error message was "Errno 13 Permission denied."
- ShadowSnap Agent
- Database locks occurred with earlier versions of ShadowProtect and ShadowSnap causing files to become inaccessible.
- Domain permissions may be preventing access to shares hosted by the Datto that the ShadowSnap agent uses to transfer backup information.
- Datto device is joined to the domain and the domain is not configured properly.
- For encrypted agents, if the Datto is unable to properly clean up iSCSI targets it is hosting to capture transferred backup information due to an unexpected interruption, subsequent backups may fail with this error message.
- Check if the Datto device is joined to the domain. If it is, remove the device from the domain.
- Enable Share Compatibility from the Configure Agent Settings → Advanced → Share Compatibility Mode page of the device GUI.
- Force a differential merge from the Configure Agent Settings → Advanced → Force Differential Merge page of the device GUI.
- If the issue persists, attempt a ShadowProtect backup to a NAS share on the Datto appliance. Observe whether or not the backup fails in the same state. If it does, investigate the configuration of your domain permissions, which may be preventing access to shares hosted by the Datto appliance.
Clear iSCSI targets (encrypted agents only)
1. Open diskpart via the Windows command line, and run the command command
automount scrub. This will prune any of the iSCSI targets that are currently stuck on the host machine.
2. After running the scrub, confirm that the target has been removed by opening the Windows iSCSI Initiator, (Control Panel → iSCSI Initiator) and looking for any connected devices. If other encrypted agents are backing up to the same device, you may see other devices reporting as inactive. The naming convention of the targets will allow you to distinguish which targets are created for which agents. iSCSI connections to the Datto appliance contain the name of the Datto device, the agent IP/hostname, and randomly-generated characters for each volume needed.
3. After clearing any hung iSCSI connections, attempt another backup.