The Account Restore interface allows you to monitor the status and progress of your hosting account restoration in real-time. You can view detailed logs, warnings, and skipped items to ensure your data transfers successfully to your new server. This guide explains how to use the restoration interface and troubleshoot common issues during the account recovery process.
Understanding the Account Restore Interface
When you restore a hosting account backup, the system displays a progress screen showing real-time updates. This interface provides critical information about the restoration process, including:
- Current restoration progress and status
- Any warnings or errors encountered
- Items that were modified or skipped
- Command-line access to monitor the process remotely
Important Warning: Never use the skip-name-resolve setting in your MySQL configuration. This setting will cause serious problems with account transfers, restorations, and database management tools like phpMyAdmin. Unless you are an advanced MySQL administrator, avoid this setting completely.
Monitoring an Active Restoration
While your account is being restored, the interface displays an "In Progress" status. You can pause the restoration at any time by clicking the Pause button. This is useful if you need to address server resource issues or temporarily halt the process.
If you accidentally close the restoration window, don't worry. Navigate to the Review Transfers and Restores interface in your control panel (WHM >> Home >> Transfers >> Review Transfers and Restores) and click View next to your restoration job.
Command-Line Monitoring
For advanced users who prefer terminal access, you can monitor restoration progress using the command line. The interface displays the exact command at the bottom of the screen:
/usr/local/cpanel/bin/view_transfer [TRANSFER_ID]
This command allows you to watch the process even if you close the browser window, which is particularly useful for long-running restorations.
Understanding Restoration Results
When the restoration completes, the interface displays a "Completed" message along with detailed logs. Review these logs carefully to identify any issues that may require attention.
Status Indicators
The restoration log uses color-coded indicators to show the outcome of each restored item:
- Success (Green): Items that transferred and restored without any issues
- Altered (Yellow): Items that were modified during restoration, such as MySQL or PostgreSQL users and databases that had naming conflicts
- Failed (Yellow/Red): Items that could not be restored, often due to resource limitations like unavailable IP addresses or permission restrictions
- Skipped: Items intentionally excluded from the restoration process
Reviewing Warnings and Skipped Items
The interface displays links to detailed logs showing the total number of warnings and skipped items for each restored account. Click these links to view specific details about what was altered or failed during the restoration. This information is essential for troubleshooting and ensuring your account functions correctly after restoration.
Common Restoration Issues and Solutions
Several common problems can occur during account restoration:
- IP Address Conflicts: If no available IP addresses exist on your server, some items may fail to restore
- Database User Conflicts: Existing database users or databases with identical names will be modified automatically
- Permission Restrictions: Insufficient permissions may prevent certain features or files from restoring
- Disk Space Limitations: Ensure adequate disk space is available before starting large restorations
Review the restoration logs thoroughly to identify specific issues. OBHost's restoration process automatically handles many conflicts by renaming or modifying affected items.
Best Practices for Account Restoration
To ensure smooth account restorations, follow these recommendations:
- Verify sufficient server resources (disk space, RAM, CPU) before beginning
- Review backup integrity and completeness before restoration
- Check for IP address availability if restoring dedicated IP configurations
- Document any custom configurations that may need manual adjustment
- Test restored accounts thoroughly before directing traffic to them
Frequently Asked Questions
Can I close the restoration window and check progress later?
Yes, you can safely close the restoration interface window. The restoration process continues running in the background. To check progress, navigate to Review Transfers and Restores in your control panel and click View next to your restoration job. You can also use the command-line monitoring tool if you have shell access.
What should I do if items show as "Altered" in the restoration log?
Altered items are typically the result of automatic conflict resolution. Review the detailed logs to see exactly what was modified. Common alterations include renamed database users, modified database names, or adjusted email account settings. Verify that altered items still function correctly and update any application configurations that reference the original names.
How long does account restoration typically take?
Restoration time varies based on account size, server resources, and network speed. Small accounts may restore in minutes, while large accounts with extensive databases and files can take several hours. The restoration interface shows real-time progress, allowing you to estimate completion time based on the current transfer rate.
What happens if a restoration fails partway through?
Partial restoration failures are logged in the detailed restoration report. The system attempts to restore as much as possible, skipping or modifying problematic items. Review the failure logs to identify specific issues, address the underlying problems (such as freeing disk space or resolving permission issues), and consider re-running the restoration for failed items.
If you need assistance with account restoration or encounter issues during the process, OBHost's support team is available 24/7 to help. Contact us at https://www.obhost.net/contact or email support@obhost.org for expert guidance.
