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

* Adding a known issue/fix when C7 to AL9 upgrade * Add mentioning in one more place
AlmaLinux · Mar 7, 2025 · 7534ad8 · 7534ad8
1 parent b427587
commit 7534ad8
Show file tree

Hide file tree

Showing 2 changed files with 44 additions and 3 deletions.
diff --git a/docs/elevate/ELevate-frequent-issues.md b/docs/elevate/ELevate-frequent-issues.md
@@ -2,7 +2,7 @@
 title: ELevate Frequent Issues
 ---
 
-###### last updated: 2024-09-20
+###### last updated: 2025-03-05
 
 # ELevate Frequent Issues
 
@@ -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. 

diff --git a/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md b/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md
@@ -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
 
@@ -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
@@ -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).