Valid for versions 82 through the latest version
Version:
82
Overview
The Account Restore interface displays the status and progress of your account restoration, and any warnings.
This interface only displays if an account restoration is in progress.
Do not use the skip-name-resolve setting in your server’s MySQL® configuration. This setting will cause serious issues with server operations. If you are not an advanced MySQL administrator, expect issues with this setting. For example, you will see issues with account transfers and restorations. This setting will also cause issues with phpMyAdmin.
In Progress
To pause this process, click Pause.
If you accidentally close this interface, navigate to the Review Transfers and Restores interface (WHM >> Home >> Transfers >> Review Transfers and Restores) and click View.
Use the /usr/local/cpanel/bin/view_transfer script to watch the process’s progress via the command line. The correct command appears at the bottom of the WHM interface:
You may close this window and view the transfer on the command line: /usr/local/cpanel/bin/view_transfer DHGfWHNIu8STwNfZ3ywIOLLSGiCQtSCompleted
After the transfer and restoration process is complete, the top of the interface displays a Completed message.
The links below the Restore section allow you to review the account’s restoration log, which can help you identify and resolve any warnings or skipped items. The total number of warnings and skipped items appears below each account’s link.
- Success (
) — A successful transfer or restoration.
- Altered (
) — Items that the system modified during the restoration process. For example, this may indicate conflicts between MySQL® or PostgreSQL® users and databases.
- Failed (
) — Items that failed to transfer. For example, this may indicate that no available IP addresses exist on your system, or you do not have permission to use more IP addresses.
- Dangerous (
) — Items that the system marked as dangerous and which it will not restore. For example, this may indicate:
- Symlinks inside the archive that do not exist in the
homedirectory. setuidbinaries.- Items that a user or domain owns and which the system will not restore.
- Symlinks inside the archive that do not exist in the
- Skipped (
) — Items that the system did not mark as dangerous, but do not meet the current security context. For example, this may indicate:
vhostincludes.- Reseller privileges.
- Warning (
) — Non-fatal problems during the restoration process that do not fit any of the above categories. For example, this may indicate that the system couldn’t read the reseller privileges file.
To view a log file, click the appropriate link to the log file.
To confirm that the system added the newly-transferred account to your backup configuration, navigate to WHM’s Backup Configuration interface (WHM >> Home >> Backup >> Backup Configuration).
Summary
In addition to the transfer and restoration logs, the Summary section provides a list of severe warnings:
- Invalid log files that the system rejected.
- Renamed databases.
- Renamed database users.
- Skipped database grant tables.
You can click Rename to change the names of accounts, databases, and usernames.
Restricted Restore errors
If a component of the backup file experiences an issue (for example, a MySQL grant table is compromised, or a symbolic link attack occurs), the system will not restore that portion of the backup file, and the interface will issue a warning.
For more information about this feature, read our Transfer or Restore a cPanel Account documentation.
