Troubleshooting
Common errors
Most frequent error codes seen by Easy Hybrid DR users, what they mean, and how to resolve them.
- Product
- Easy Hybrid DR
- Version
- v2.3.1
- Release status
- GA
- Documentation status
- Published
- Last updated
- Updated
- Reading time
- 1 min read
These are the errors most often raised by Easy Hybrid DR users in their first 90 days. Each entry includes the symptom, the most likely cause, and the action that resolves it.
Replication errors
| Code | Symptom | Likely cause | Action |
|---|---|---|---|
| REPL-001 | Replication stuck at 0 percent | Outbound TCP 443 blocked | Allow egress to the control plane endpoint listed under Network requirements. |
| REPL-004 | Hash mismatch on manifest | Source disk modified outside the storage stack | Discard the cycle, rebuild the manifest. Investigate whether a third-party process is writing directly to disk. |
| REPL-014 | CBT scan slow | Single-threaded CBT contending with backup software | Schedule the backup window outside the replication peak. |
Networking errors
| Code | Symptom | Likely cause | Action |
|---|---|---|---|
| NET-007 | Target unreachable from source | NAT or firewall rule missing | Add an egress rule to the source VPC for the target endpoint. See the [networking guide](/docs/dr/planning/networking). |
| NET-021 | Recovery DNS not updated after failover | DNS record not delegated to the platform | Verify the DNS provider integration. Re-attach the recovery DNS in the protection plan. |
Permissions errors
| Code | Symptom | Likely cause | Action |
|---|---|---|---|
| IAM-002 | Failover blocked, AssumeRole denied | IAM role trust policy missing the recovery account | Add the recovery account as a trusted principal on the source recovery role. |
| IAM-009 | API returns 403 on plan apply | Token role lacks plan write permission | Issue a token with the operator or admin role. |
Cloud-specific errors
| Code | Symptom | Likely cause | Action |
|---|---|---|---|
| AWS-013 | Recovery EC2 launch fails: InstanceLimitExceeded | Service quota too low in the recovery region | Open a quota increase request for the EC2 family used by the recovery template. |
| AZ-022 | Disk attach fails on the recovered VM | Managed disk SKU not allowed in the recovery zone | Pick a permitted SKU or change the recovery zone in the protection plan. |
Getting help
If your error is not listed here, gather the following and contact support:
- The plan name and the job id of the failed run
- The CLI output with
--output json - The last 200 lines from the source agent log
Related docs
Was this page helpful?