Child pages
  • Touch File for Additional Transfer and Restore Log Diagnostic Entries
Skip to end of metadata
Go to start of metadata

Overview

Use the xferdebug touch file to display all restore actions in those logs. After you create the touch file, transfers will contain additional diagnostic lines.

The xferdebug touch file sends transfer calls through the Whostmgr::Remote::_exec_sshcontrol: module, which displays the SSH options that the system passed to the module.

Important:

When the xferdebug touch file exists, the system will log passwords in plain text.

Create or remove the touch file

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

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

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 and later possesses separate log files for transfers and restores.

Transfer log with the touch file

The following examples show the SSH options that a user passed to the module to 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]

 

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 example is a log of the same restoration with a touch file enabled:

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 touch file information displays the details of each step in the restoration process. This can help you to determine whether the system did not restore or rename part of an account.

Version 11.42 and earlier

In cPanel & WHM version 11.42 and earlier, there is a combined log file for transfers and restores. This log file marks additional entries with the (verbose) prefix:

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

Additional documentation