Resolve the "failed to leapp upgrade" error

The "failed to leapp upgrade" error occurs during SMC Linux OS migration due to software package download failures or invalid /etc/fstab mount configurations.

Problem description

This error occurs when you migrate a Linux OS to Anolis OS by using SMC.

Cause

Possible causes:

Failed to download software packages.
Invalid mount configurations in /etc/fstab.

Solution

Failed to download software packages

Connect to the source server. (Connect to an instance).

Check the SMC client error logs.

Locate the log directory (View the SMC client). Sample command:

cat /smc/go2aliyun_client2.7.6_linux_x86_64/Logs/osm_prepare.log

Replace 2.7.6 with your actual SMC client version.

Run the following command to view the error details:

cat /var/log/leapp/leapp-preupgrade.log

2024-02-21 21:29:16.543 DEBUG    PID: 31683 leapp.workflow.TargetTransactionCheck.dnf_transaction_check: Transaction check:
2024-02-21 21:29:16.551 DEBUG    PID: 31683 leapp.workflow.TargetTransactionCheck.dnf_transaction_check:
2024-02-21 21:29:16.559 DEBUG    PID: 31683 leapp.workflow.TargetTransactionCheck.dnf_transaction_check:  Problem: problem with installed package lynx-2.8.8-0.3.dev15.1.al7.x86_64
2024-02-21 21:29:16.566 DEBUG    PID: 31683 leapp.workflow.TargetTransactionCheck.dnf_transaction_check:   - cannot install the best update candidate for package lynx-2.8.8-0.3.dev15.1.al7.x86_64
2024-02-21 21:29:16.575 DEBUG    PID: 31683 leapp.workflow.TargetTransactionCheck.dnf_transaction_check:   - lynx-2.8.8-0.3.dev15.1.al7.x86_64 does not belong to a distupgrade repository
2024-02-21 21:29:16.582 DEBUG    PID: 31683 leapp.workflow.TargetTransactionCheck.dnf_transaction_check:   - nothing provides anolis-indexhtml needed by lynx-2.8.9-4.0.1.al8.x86_64

The dnf_transaction_check actor found invalid dependencies during package updates. A required package may be missing from the repository, or dependencies may conflict. In this example, the anolis-indexhtml package required by lynx is not found in the repository.

Identify the problematic package from the error log and uninstall it. For example, uninstall lynx:
```
yum remove lynx-2.8.8-0.3.dev15.1.al7.x86_64
```
After you resolve the network issue, run the SMC client to retry the migration. For more information, see Run the SMC client.

Invalid mount configurations in the /etc/fstab file

Connect to the source server. (Connect to an instance).
Check the SMC client error logs.
Locate the log directory (View the SMC client). Sample command:
```
cat /smc/go2aliyun_client2.7.6_linux_x86_64/Logs/osm_prepare.log
```
Replace 2.7.6 with your actual SMC client version.
Verify the mount configurations in /etc/fstab:
- Each file system entry must be on a single line.
- All file systems must be mountable. Run mount -a to verify.
- The file must not contain Chinese characters.
After you resolve the network issue, run the SMC client to retry the migration. For more information, see Run the SMC client.