Troubleshooting: Resolve exit code -312 in Linux Edition

Summary

This article explains how to investigate the causes of Exit -312 (snapshot error) in ActiveImage Protector 2018/2022 Linux Edition. When "exit code -312" appears in the task log, it indicates a possible Linux system error. 

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.

To investigate the snapshot error cause, examine the messages log at the same time. In this instance, a "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

This suggests that there's not enough available space on the device. 

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

Checking the "messages" log should help you identify the encountered error. For Linux System Error Codes, please visit the following site:

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

(13451227896345)