Touch File for Additional Transfer and Restore Log Diagnostic Entries

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

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:

Restore log without the touch file

The following example is a normal restore log:

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.

Did you find this article useful?