Account restore failed: Exceeded max filesystem nodes while making permissions safe at /usr/local/cpanel/Cpanel/Archive/Utils.pm line 66.

Symptoms

A restore fails with the following error in the logs:

Failed to extract the archive at “/home/cpmove-user.tar.gz”: Exceeded max filesystem nodes while making permissions safe at /usr/local/cpanel/Cpanel/Archive/Utils.pm line 66. 
Failed: Account Restore Failed: “Failed to extract the archive at “/home/cpmove-user.tar.gz”: Exceeded max filesystem nodes while making permissions safe at /usr/local/cpanel/Cpanel/Archive/Utils.pm line 66. ”

Description

The restore process has an upper limit on the number of files within an archive it can extract. Archives that exceed 2 Million individual files can be restored by a different process.

Workaround

The account can be restored by skipping the home directory, which contains the majority of the account's files, and syncing them manually from the extracted backup archive.

1. Access the server via SSH as the root user
2. Perform a restore of the account using "restorepkg" and skipping the home directory:

   /scripts/restorepkg --disable Homedir /path/to/cpmove-user.tar.gz

3. When the account restore has been completed, it will be without the contents of the home directory. Extract the "homedir" from the backup archive according to the instructions here:
   How to manually locate and extract a file or directory from a cPanel backup
4. You can sync the contents of the homedir folder into the account manually by using the rsync tool.