In v5.4.0+, we resolved an issue related to how subdomains and addon domains are handled during restores, specifically on environments with complex, multi-level domain structures. From this version forward, you may encounter the following error:
[ERROR] Failed making API Call to cPanel/WHM (cpapi2). Error: (XID dk2fi) The system failed to create the file “/home/USER/.cpanel/caches/.tmp.937ee.rewriteinfo” with permissions “0600” (as EUID: 1110, EGID: 1111 1111) because of the following error: Disk quota exceededPreviously, JetBackup relied on cPanel uapi API calls to fetch and map domain relationships. However, when an account had deeply nested subdomains, the API couldn't accurately trace which specific DNS zone file a subdomain actually belonged to.
To fix this, we utilized cPanel’s cpapi2 API (specifically functions like listsubdomains) which is able to track and return the exact root domain mapping for every single subdomain, regardless of how many layers deep it is. As a result, JetBackup can now cleanly and accurately pinpoint the correct zone file, minimizing the false-positive DNS conflicts during restores.
Because cpapi2 executes commands natively within the context of the individual cPanel user, cPanel will briefly write standard internal cache files to that user's home directory (under /home/username/.cpanel/caches/) during backup and restore tasks.
If you are encountering a Disk quota exceeded error during a backup after this update, this is actually a sign that the new API is working properly, but the client's cPanel account has reached the quota limit. Because their quota is maxed out, the operating system blocks cPanel from writing the cache files, and you can verify this with the following whmapi1 command:
# whmapi1 --output=json accountsummary user=exampleUSER |jq |grep -E "disk|inode"
"inodeslimit": 50000,
"disklimit": "100000M",
"inodesused": 50505,
"diskused": "12456M",To resolve this error, please increase that specific user's disk quota in WHM or clear out temporary files/trash in their home directory to allow cache files to be created.
If you require further assistance, please contact our Technical Support Team by emailing [email protected]
