Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding a known issue/fix when C7 to AL9 upgrade #592

Merged
merged 2 commits into from
Mar 7, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion docs/elevate/ELevate-frequent-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: ELevate Frequent Issues
---

###### last updated: 2024-09-20
###### last updated: 2025-03-05

# ELevate Frequent Issues

Expand Down Expand Up @@ -128,6 +128,25 @@ After the ELevate upgrade process has completed, you may encounter an error like

To enable CRB or any other AlmaLinux repository, please reference [this article](/repos/AlmaLinux.html)

## Error Detected While Processing /etc/virc

When performing a progressive upgrade from CentOS 7 to AlmaLinux 9, you may encounter the following issue on EL 9 while using `vi` (not `vim`):
```
Error detected while processing /etc/virc:
line 40:
E319: Sorry, the command is not available in this version: let skip_defaults_vim=1
```
To fix this error:
* Open `/etc/virc` file using a text editor of your choice.
* Search for the line containing the text *content added by Leapp*.
* Locate and remove the following line:
```
let skip_defaults_vim=1
```
* Save the file and exit the editor.

After making these changes, the error should no longer appear when using `vi`.

## Known issues

AlmaLinux Team is working hard to get a solution for these issues. Any contribution is valuable and helps us out. If you want to help and contribute, see [how to contribute](/elevate/#how-to-contribute) information.
Expand Down
26 changes: 24 additions & 2 deletions docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "ELevating CentOS 7 to AlmaLinux 9"
---

###### last updated: 2024-11-14
###### last updated: 2025-03-05

# ELevating CentOS 7 to AlmaLinux 9

Expand Down Expand Up @@ -227,10 +227,13 @@ After these preparations are completed, you can upgrade your AlmaLinux 8 machine
```
dnf update --allowerasing
```
* When performing a progressive upgrade from CentOS 7 to AlmaLinux 9, you may encounter the following issue on EL 9 while using `vi` (not `vim`). For more details and a fix, please check the [Important Notes](#important-notes-about-the-upgrade-process) section below.

## Important Notes about the Upgrade Process

* During the upgrade, ELevate uses a multitude of repositories to migrate and upgrade the system. Among them is the usage of the CRB repository. Important to note, if the CRB repository was not enabled on your system prior to using ELevate, it will remain disabled after the upgrade. This can cause future system updates via dnf to fail as one or more packages/package dependencies may now depend on packages within the CRB repository. The errors can look something like this:
### Package Dependency Error After ELevate Upgrade

During the upgrade, ELevate uses a multitude of repositories to migrate and upgrade the system. Among them is the usage of the CRB repository. Important to note, if the CRB repository was not enabled on your system prior to using ELevate, it will remain disabled after the upgrade. This can cause future system updates via dnf to fail as one or more packages/package dependencies may now depend on packages within the CRB repository. The errors can look something like this:
```
Error:
Problem: package nss_db-2.34-100.el9_4.2.x86_64 from @System requires glibc(x86-64) = 2.34-100.el9_4.2, but none of the providers can be installed
Expand All @@ -246,6 +249,25 @@ After these preparations are completed, you can upgrade your AlmaLinux 8 machine

To enable CRB or any other AlmaLinux repository, please reference [this article](/repos/AlmaLinux.html)

### Error Detected While Processing /etc/virc

When performing a progressive upgrade from CentOS 7 to AlmaLinux 9, you may encounter the following issue on EL 9 while using `vi` (not `vim`):
```
Error detected while processing /etc/virc:
line 40:
E319: Sorry, the command is not available in this version: let skip_defaults_vim=1
```
To fix this error:
* Open `/etc/virc` file using a text editor of your choice.
* Search for the line containing the text *content added by Leapp*.
* Locate and remove the following line:
```
let skip_defaults_vim=1
```
* Save the file and exit the editor.

After making these changes, the error should no longer appear when using `vi`.

## Get Help

For more help and assistance reach out to us in the ~migration channel on the [AlmaLinux Community Chat](https://chat.almalinux.org/almalinux/channels/migration).