The xferdebug touch file enhances transfer and restore logs by adding detailed diagnostic entries. Once enabled, it records all restore actions, helping diagnose connectivity and authentication issues between servers.
Important: Enabling the xferdebug touch file logs passwords in plain text, which may pose a security risk.
Creating or Removing the Touch File
- Create the Touch File
Run the following command as the root user via SSH to enable extended logging:touch /var/cpanel/xferdebug && /usr/local/cpanel/scripts/synctransfers
- Remove the Touch File
To disable extended logging, remove the touch file using:rm -fv /var/cpanel/xferdebug && /usr/local/cpanel/scripts/synctransfers
Log Examples
- Transfer Log with the Touch File:
- Displays the SSH options used during transfer, aiding in debugging connectivity or authentication problems.
- Helps identify issues in server-to-server migrations.
- Restore Log Without the Touch File:
- Shows a standard restore log without extra diagnostic details.
- List each step of the restoration process to help pinpoint potential issues.
Using the xferdebug touch file provides deeper insights into transfer and restore processes, making troubleshooting easier and more efficient. However, ensure you disable it after debugging to avoid logging sensitive data.
Looking for a complete backup and restore guide for Plesk? Check out How do you backup and restore a Plesk site