Docs

Server Migration Center

Troubleshooting

How to handle exceptions during "File replication" migrations?

Symptom

During full or incremental migration of data based on the "File replication" method, an exception occurred, or the migration failed.

Cause

For data migration based on the "File replication" method, the rsync tool installed on the source server is used to transfer data. Issues related to rsync may cause migration errors.

Solution

Execute the following command to enter the directory where the Agent is located.

cd /root/download/

Execute the following command to view the most recent content in the rsync.log file.

tip

This log file is generated only for migrations performed based on the "File replication" method.

tail -f rsync.log

Sample output

As shown in the figure below, you can determine the cause of the exception based on the ERROR message. In this example, the exception occurred because the file name exceeded the maximum path length.

Last updated: 2026.01.07 15:11:32