Troubleshooting: Exit -312 with Linux Edition

Summary

This article provides the description about how to investigate the causes of Exit -312 (snapshot error) in ActiveImage Protector 2018 / 2022 Linux Edition.
When “exit code -312” is recorded in task log, Linux system error is possibly occurring.

03/23/2022 05:21:43.799 Take snapshot with command: dbdctl setup-snapshot /dev/sda4 /.datto 2
03/23/2022 05:22:13.808 Create snapshot /dev/datto2 for volume /dev/sda4 failed, return
03/23/2022 05:22:13.808 GetSnapshotName returns empty, perhaps failed to create the snapshot of /dev/sda4. Level = ERROR[2]
03/23/2022 05:22:13.808 do snapshots for volume failed Level = ERROR[2]
:
03/23/2022 05:22:13.904 {IDS_STRING3167}Complete task 1001, 1, exit code -312
03/23/2022 05:22:13.944 {IDS_STRING3190}Copy engine fails with error: [-312] snapshot not found Level = ERROR[2]
03/23/2022 05:22:14.110 {IDS_STRING3013}Processed 0.00 GB in 00:01:16 ID=1648012855; {IDS_STRING3019}3 Errors; {IDS_STRING3009}There were errors during the operation.

In order to investigate the cause of snapshot error, please check messages log recorded at the equal-time.
In this case “system error 28” occurred.

Mar 23 14:21:43 localhost kernel: datto: error performing fallocate on file '/.datto': -28
Mar 23 14:21:43 localhost kernel: datto: error during cow manager initialization: -28
Mar 23 14:21:43 localhost kernel: datto: error setting up cow manager: -28
Mar 23 14:21:43 localhost kernel: datto: error setting up tracer as active snapshot: -28
Mar 23 14:21:43 localhost kernel: datto: error during setup ioctl handler: -28

The above indicates that there is not sufficient available space in the device.

define ENOSPC 28 /* No space left on device */

By checking “messages” you should be able to identify what error you encounter.

Please access the following site for Linux System Error Code.
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/include/uapi/asm-generic/errno-base.h
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/include/uapi/asm-generic/errno.h

Target Product

– ActiveImage Protector 2018 / 2022 Linux