Page tree
Skip to end of metadata
Go to start of metadata

Overview

If your transfers have problems that you cannot resolve with the standard transfer and restore logs, use the xferdebug touch file to add additional events to the logs.

When you create the touch file, transfers send the calls through the Whostmgr::Remote::_exec_sshcontrol: module, which shows the SSH options that the system passed to the module. Also, restores will show every restore action instead of just the category headings of the restoration process.

Create or remove the touch file

To create the touch file, run the following command via an SSH connection as the root user:

touch /var/cpanel/xferdebug && /usr/local/cpanel/scripts/synctransfers

Once the touch file exists, transfers will contain the additional diagnostic lines.

To remove the touch file, run the following command:

rm -fv /var/cpanel/xferdebug && /usr/local/cpanel/scripts/synctransfers

Examples

Version 11.44 and later

cPanel & WHM version 11.44 has separate log files for transfers and restores.

Transfer log with the touch file

The following three examples demonstrate the SSH options that a user passed to the module. These help diagnose connectivity or authentication issues between the servers.

Whostmgr::Remote::_exec_sshcontrol: [/usr/local/cpanel/scripts/sshcontrol --ctl ssh --host 192.168.0.1 --port 22 --authuser username --escmethod sudo --sshkey username@example.com --stay_alive 1 --die_on_pid 25762]
Whostmgr::Remote::_exec_sshcontrol: [/usr/local/cpanel/scripts/sshcontrol --ctl scp --host 192.168.0.1.xxx --port 22 --authuser username --escmethod sudo --sshkey username@example.com --direction download --srcfile /home/username/cpmove-cprichsu-split/cpmove-cprichsu.tar.gz.part00001 --destfile . --external_master /root/.libnet-openssh-perl/username-208.74.1-25767-830516 --die_on_pid 25762]
Copying account package file... ...
Whostmgr::Remote::_exec_sshcontrol: [/usr/local/cpanel/scripts/sshcontrol --ctl ssh --host 192.168.0.1 --port 22 --authuser username --escmethod sudo --sshkey username@example.com --external_master /root/.libnet-openssh-perl/username-208.74.1-25767-830516 --die_on_pid 25762]

 

Example restore log without the touch file

The following example is a normal restore log.

Domains
Retrieving and sanitizing main userdata ...
Parsing domain databases ...
...Subdomains...
...ParkedDomains...
...AddonDomains...
Restoring Domains ...
Restoring Subdomain "site1.ajeff.test" ...
The subdomain, site1.ajeff.test has been added.
Done
Restoring Addon Domain "ajeff2.test" on to "site1.ajeff.test" ...
Domain was successfully parked.
Done
Restoring Subdomain "sub1.ajeff.test" ...
The subdomain, sub1.ajeff.test has been added.
Done
Domains
Domains restored
Cron
Restoring crontab
Cron
Roundcube
Roundcube
CustomLocale
CustomLocale
OK
Password
Restoring password ...
Password for "ajeff" has been changed.
Password 

Restore log with the touch file

The following is a log of the same restoration, but with the touch file in place:

Domains
Retrieving and sanitizing main userdata ...
Parsing domain databases ...
...Subdomains...
...ParkedDomains...
...AddonDomains...
Restoring Domains ...
Restoring Subdomain "site1.ajeff.test" ...
The subdomain, site1.ajeff.test has been added.
Done
Restoring Addon Domain "ajeff2.test" on to "site1.ajeff.test" ...
Domain was successfully parked.
Done
Restoring Subdomain "sub1.ajeff.test" ...
The subdomain, sub1.ajeff.test has been added.
Done
Domains
Domains restored
NobodyFiles
NobodyFiles
Frontpage
Restoring Frontpage (if installed)...
Frontpage
Frontpage restored
Counter
Counter
BackupConfig
Restoring backup config
Updated backup config for "ajeff"
Restoring legacy backup config
Updated legacy backup config for "ajeff"
BackupConfig
Reseller
Restoring reseller packages and features (if any)
Restoring reseller privileges (if any)
Reseller
DKIM
DKIM
The account does not have any DKIM keys to restore.
Mail
Restoring Mail files
Mail
Unsuspend
Unsuspending .htaccess files for domains: "ajeff.test, site1.ajeff.test, ajeff2.test, and sub1.ajeff.test"
Unsuspend
MailRouting
Update mail routing
LOCAL MAIL EXCHANGER: This server will serve as a primary mail exchanger for ajeff.test's mail.This configuration has been manually selected.
LOCAL MAIL EXCHANGER: This server will serve as a primary mail exchanger for site1.ajeff.test's mail.This configuration has been automatically detected based on your mx entries.
LOCAL MAIL EXCHANGER: This server will serve as a primary mail exchanger for ajeff2.test's mail.This configuration has been automatically detected based on your mx entries.
LOCAL MAIL EXCHANGER: This server will serve as a primary mail exchanger for sub1.ajeff.test's mail.This configuration has been automatically detected based on your mx entries.
MailRouting
CustomLocale
CustomLocale
OK
Roundcube
Roundcube
DigestShadow
DigestShadow
FileProtect
Doing fileprotect conversion
FileProtect
VhostIncludes
Restoring custom virtualhost templates...
VhostIncludes
ZoneFile
Restoring DNS zones
Restoring zone: ajeff2.test.db
Changed all instances of [192.168.1.203] -> [10.5.40.48] in ajeff2.test
Restoring zone: ajeff.test.db
Changed all instances of [192.168.1.203] -> [10.5.40.48] in ajeff.test
Zone updates: ajeff.test, ajeff2.test
ZoneFile
Ftp
Ftp
Password
Restoring password ...
Password for "ajeff" has been changed.
Password
MailFix
Fixing mail permissions
Converting to maildir if needed
MailFix
Mailman
Restoring Mailman lists
Mailman
Mailman Restored
BandwidthData
Restoring Bandwidth Data
BandwidthData
Postgres
Preparing PostgreSQL restore ...
This system does not have PostgreSQL.
Postgres
Logaholic
Logaholic
Cron
Restoring crontab
Cron
ProxySubdomains
Update Proxy subdomains for "ajeff"
ajeff.test [ajeff.test, 10.5.40.48, +A@webdisk, +A@whm, +A@cpanel]
ajeff2.test [ajeff2.test, 10.5.40.48, +A@webdisk]
site1.ajeff.test [ajeff.test, 10.5.40.48, +A@webdisk.site1]
sub1.ajeff.test [ajeff.test, 10.5.40.48, +A@webdisk.sub1]
ProxySubdomains
SSL
Migrating pre-SSLStorage home directory resources...
SSL
Mysql
Preparing MySQL restore ...
Restoring MySQL databases
Restoring the database "ajeff_db1" as "ajeff_db1" ...
The system has created a new database named "ajeff_db1".
Granting "ajeff" access to "ajeff_db1" with temporary password ...
Connecting to MySQL server as "ajeff" in order to restore "ajeff_db1".
Restoring database data for "ajeff_db1".
The system has restored the contents of the database "ajeff_db1".
Restoring MySQL database mappings
Restoring MySQL privileges
Restoring MySQL grants
Restoring MySQL access hosts
Reloading MySQL
Mysql
SPF
Updating SPF Records
SPF
Logs
Logs
userdata
Restoring userdata...
Restoring userdata for "ajeff.test".
Restoring userdata for "site1.ajeff.test".
Restoring userdata for "ajeff2.test".
Restoring userdata for "sub1.ajeff.test".
userdata 

The additional information shows you the details of each step of the restore process, which can help you determine whether the syste, did not restore or renamed a portion of the account.

Version 11.42 and earlier

cPanel & WHM version 11.42 has a single combined log file for transfers and restores. The log file marks the additional entries with the prefix (verbose) as follows:

Using the archive split method!
File #1: /home/richard.asp/cpmove-ajeff-split/cpmove-ajeff.tar.gz.part00001: 60f5cbcc1a6d3ff1b610dda36506b617
Copy Destination: /home
Remote file is: /home/richard.asp/cpmove-ajeff-split/cpmove-ajeff.tar.gz.part00001
(verbose) : exec: [/usr/local/cpanel/scripts/sshcontrol --ctl ssh --authmethod user --authtype publickey --authuser username --escmethod sudo --sshkey migtesting --host 208.74.124.4 --port 22]
Setting permissions on the account package...

Done
(verbose) : exec: [/usr/local/cpanel/scripts/sshcontrol --ctl scp --authtype publickey --user username --sshkey migtesting --host 208.74.124.4 --port 22 --direction download --srcfile /home/username/cpmove-ajeff-split/cpmove-ajeff.tar.gz.part00001 --destfile .]
Copying account package file (attempt 1).....0%.. ..100%.. ...Done
Verifying tarball checksum.....Checksum Matches (Actual username is ajeff)!
The file list contains: /home/richard.asp/cpmove-ajeff-split/cpmove-ajeff.tar.gz.part00001
The local assemble list contains: /home/cpmove-ajeff.tar.gz.part00001
Archive Recombine in progress (part [/home/cpmove-ajeff.tar.gz.part00001] 1)..... Done
Tarball copy ok!
Restore Dir: /home Extracting tarball................... Done
Extracting Domain....Done