Troubleshooting Agent Error Codes for DWA and DLA
Topic
This article lists the Agent Error Codes that may be displayed in the Datto Device GUI for Datto Windows Agent and Datto Linux Agent related errors. Resources for diagnosing and resolving the issues that cause the underlying error are also included.
The Agent codes listed in this article are error alerts that will appear in device banners and alert e-mails specifically for issues with the Datto Windows Agent (DWA) or Datto Linux Agent (DLA).
Environment
- Datto Windows Agent
- Datto Linux Agent
Description
Agent errors are displayed in both the local device GUI and the Datto Device Web, when a backup has failed as the result of an agent related issue. Agent errors will display both the error number and a brief explanation of the error as per the example below:
Below is a list of Agent Errors that you may see displayed on Datto BCDR devices as well as a brief description of the error. Most of the errors listed are unique to the Datto Windows Agent, but some may also occur with the Datto Linux Agent as indicated. The last column includes links to resources to help troubleshoot and resolve the underlying issue that causes the alert.
| Error Code | Description | Agents DWA (Datto Windows Agent) or DLA (Datto Linux Agent) | Knowledge Base Resource |
|---|---|---|---|
| AGENT256 | An unexpected error occurred while attempting to snapshot. | DWA, DLA | This is a generic snapshot error, something went wrong when the agent tried to create a backup. See:. |
| AGENT257 | The <volName> volume requires 10GB free space to perform a backup. | DWA, DLA | Not enough free space on the volume being backed up. See space requirements outlined in: |
| AGENT258 | An error occurred while configuring the backup job. | DWA, | This error may be recoverable on the next backup. Try another backup and if the issue persists,see: |
| AGENT259 | Snapshot in error state | DWA | This may be recoverable on the next backup. Try another backup and if the issue persists,see: Datto Windows Agent: Error: "Snapshot not in a good state - State 5 Error 0x00000028" |
| AGENT260 | No snapshot was taken | DWA | Datto Windows Agent: Error Reading from Snapshot. Error: 21 |
| AGENT262 | The backup could not start because the snapshot control file is missing. | DWA | Datto Windows Agent: Error Reading from Snapshot. Error: 21 |
| AGENT263 | The backup could not complete because the snapshot control file is full. | DWA, DLA | This error can occur on DWA versions prior to 3.0, or on DLA. The COW file (Copy on Write) is full. See troubleshooting steps in: Datto Windows Agent: Error Reading from Snapshot. Error: 21 and Datto Windows Agent: Error: "Snapshot not in a good state - State 5 Error 0x00000028" |
AGENT278 | The volume is too small to make a snapshot. | DWA | The volume is too small to make a snapshot.See volume size requirements in: |
AGENT279 | The control file is too fragmented to make a snapshot. | DWA | The control file is too fragmented to make a snapshot. See: |
AGENT288 | VSS failed to prepare snapshots for backup. (see comment) | DWA | This is a VSS writer issue. See: Resolving VSS Writer Errors in Windows 8, Server 2012, and Up |
AGENT289 | Timeout waiting for VSS. HRESULT: (0x00080430) (see comment) | DWA | This is a VSS writer issue. See: Resolving VSS Writer Errors in Windows 8, Server 2012, and Up |
AGENT290 | The backup could not complete due to a VSS writer communication error. | DWA | This is a VSS writer issue. See: Resolving VSS Writer Errors in Windows 8, Server 2012, and Up |
AGENT336 | DBD failed to prepare snapshots for backup | DWA | Driver error. This error can occur on DWA versions prior to 3.0. See |
AGENT384 | Could not enable Datto VSS provider | DWA | |
AGENT385 | Could not validate that the Datto VSS provider is properly configured. | DWA | |
AGENT513 | A network error occurred when attempting to open a connection to the remote target. | DWA, DLA | There is a network communication issue. See the networking prerequisites outlined in: |
AGENT514 | The backup could not complete due to a problem writing data to the remote target. | DWA, DLA | The Datto device cant write to the protected machine. Check the prerequisites oulined in: |
AGENT515 | The backup could not complete due to a problem reading data from the remote target. | DWA | The Datto device cant read from the protected machine. Check the prerequisites oulined in: |
AGENT1024 | The backup could not complete due to a problem reading the protected volume.. | DWA, DLA | Datto Windows Agent: "Error reading from snapshot. Error: 23 |
AGENT1025 | The <volName> volume was unavailable during the backup process. | DWA, DLA | The agent tried to read the volume when setting up the backup, but failed. It may indicate the volume is in a bad state (busy) or was removed. See the "Common causes and solutions" section in: Datto Windows Agent: "Error reading from snapshot. Error: 23 |
AGENT1029 | [Backup error occurred during backup run: Error ocurred reading the protected volume: ]Data error (cyclic redundancy check) (VOLUME_READ_ERROR_CRC) | DWA | The Datto device cannot read from the protected volume. Cyclic Redundency Check Error (CDC).. See Datto Windows Agent: "Error reading from snapshot. Error: 23" |
AGENT1280 | Unable to allocate memory | DWA | Unable to allocate enough memory for the backup. See the memory requirements outlined in: |
