The Account Transfer interface in WHM lets you monitor the status and progress of your account restoration and transfers in real-time. You can view transfer progress on the left side of the interface and site restoration details on the right side, along with any warnings or issues that occur during the process.
This guide explains how to track your account transfers, understand status indicators, and troubleshoot common transfer issues.
Understanding Transfer Progress
When an account transfer is in progress, the interface displays real-time updates about the current status. You can pause the transfer at any time by clicking the Pause button.
If you accidentally close the Account Transfer interface, you can resume monitoring by navigating to WHM >> Home >> Transfers >> Review Transfers and Restores and clicking the appropriate View link for your transfer.
Monitoring Transfers via Command Line
For users who prefer command-line access, you can watch the transfer progress using the /usr/local/cpanel/bin/view_transfer script. The exact 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 [transfer_id]
This command allows you to monitor transfers even when the WHM interface is closed, which is especially useful for long-running transfers.
Understanding Completion Status
After the transfer and restoration process completes, the interface displays a Completed message at the top. Below the Transfer and Restore sections, you'll find links to detailed logs that help identify and resolve any warnings or skipped items.
The total number of warnings and skipped items appears below each account's link, making it easy to spot issues that need attention.
Transfer Status Indicators
The Account Transfer interface uses visual indicators to show the outcome of each transfer component:
- Success (green icon): The transfer or restoration completed successfully with no issues
- Altered (yellow icon): Items that the system modified during the restoration process, such as conflicts between MySQL or PostgreSQL users and databases
- Failed (yellow icon): Items that failed to transfer, often due to issues like no available IP addresses on your system or insufficient permissions to use additional IP addresses
Reviewing Transfer Logs
Transfer logs provide detailed information about what happened during the account transfer process. These logs are essential for troubleshooting any warnings or failures.
You can access transfer logs through the links provided in the Completed interface. Review these logs carefully to understand:
- Which files or databases transferred successfully
- What items were modified during transfer
- Why certain items failed or were skipped
- Specific error messages that can guide troubleshooting
Common Transfer Issues and Solutions
Several common issues can occur during account transfers. Understanding these helps you resolve problems quickly.
IP Address Conflicts
If your transfer fails due to IP address issues, this typically means no available IP addresses exist on your target system, or you lack permission to assign additional IPs. Contact your hosting provider to request additional IP addresses or adjust your transfer settings to use shared IPs.
Database User Conflicts
When transferring accounts with MySQL or PostgreSQL databases, username conflicts can occur if users with the same names already exist on the destination server. The system may automatically modify these usernames, which appears as an Altered status. Review the logs to see exactly what changes were made.
Skipped Files
Files may be skipped during transfer due to permissions issues, file corruption, or incompatible formats. Check the transfer logs to identify which files were skipped and why, then manually transfer these files if necessary.
Best Practices for Account Transfers
To ensure smooth account transfers, follow these recommendations:
- Review disk space availability on the destination server before starting the transfer
- Verify that required PHP versions and software packages are available on the destination
- Keep the transfer interface or command-line monitor open to catch issues early
- Plan transfers during low-traffic periods to minimize user impact
- Always review completion logs, even when the transfer shows as successful
Frequently Asked Questions
What should I do if my transfer gets stuck or takes too long?
If your transfer appears stuck, check the command-line monitor using the view_transfer script to see current activity. Large accounts with many files or databases can take several hours to transfer. If the transfer shows no progress for an extended period, pause it and review the logs for errors before resuming or restarting.
Can I perform multiple account transfers simultaneously?
Yes, you can initiate multiple account transfers at the same time. However, running too many simultaneous transfers can strain server resources and slow down all transfers. For optimal performance, limit concurrent transfers based on your server's available bandwidth and processing power.
How do I fix altered database connections after transfer?
When database usernames are altered during transfer, you may need to update database connection settings in your applications. Check your application's configuration files for database credentials and update them to match the new usernames shown in the transfer logs. Common configuration files include wp-config.php for WordPress and configuration.php for Joomla.
Where can I find detailed transfer error messages?
Detailed error messages appear in the transfer logs, which you can access through the Review Transfers and Restores interface. These logs provide specific information about what failed and why, including file paths, database names, and system error codes that help troubleshooting.
If you encounter issues with account transfers or need assistance interpreting transfer logs, our support team is available 24/7 to help. Contact us at https://www.obhost.net/contact or email support@obhost.org for technical assistance.
