Account Restore Failed during Mailnode Offload (The domain already exists in the userdata)

Symptoms

The following error will occur if the following circumstances are present simultaneously:

• An account exists on the parent node
• The same account also exists on a child node
• An attempt is made via WHM's "Modify  an Account" interface on the parent node to distribute the account to the child node.

Cpanel::Exception/(XID kcckj5) Account Restore Failed: "Account failure: Failed to create the account: (XID 3vage7) The domain "cpaneltech.net" already exists in the userdata."

Description 

This error indicates that the account that you are trying to distribute already exists on the child node. This error occurs in order to prevent you from unintentionally overwriting data on the child node by distributing an account over the existing data on the child node.

If you encounter this error you should do the following: 

1. Verify that the account that are are trying to distribute has already been successfully de-distributed without any errors or problems. If there was a problem with the de-distribution  of the account previously, please contact cPanel support before proceeding.

2. Verify that all of the mail data for the account exists intact on the parent node -  OR - verify that you have a full  working backup of the account that you may use to restore the account in the event that some data goes missing.

If both of the above conditions have been satisfied, you may use the process outlined in the Workaround section below.

For more details about the process of redistributing an account, you may refer to our documentation: 

Cpanel Linked Nodes Guide: Managing Distributed Accounts

Workaround

Please make a backup of the account on the child mail-node server, and then remove the account. After the account is removed from the child-node, you can distribute the account from the parent-node via WHM in the "Modify an Account" interface.

Login to SSH on the child mail-node server then:

• /scripts/pkgacct $cpuser

After the backup completes, ensure that it exists outside of the home directory of the account you are about to remove. You could move the backup file to a directory such as: /root/mailnode-backups

If you do not successfully complete the backup portion of this guide, do not remove the account, and reach out to cPanel support instead.

Then remove the account with the following command:

• /scripts/removeacct $cpuser

You should be all set on the child mail-node at this point. Now login to WHM on the parent-node, navigate to "Modify an Account", and attempt to distribute the account once more.