Skip to content

Commit 4ea2ab5

Browse files
authored
AlmaLinux Migration Guide: (#598)
- warn to use reliable console when running migration tool
1 parent ba62d0b commit 4ea2ab5

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

docs/documentation/migration-guide.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: 'Migration Guide'
33
---
44

5-
# AlmaLinux Migration Guide
5+
# AlmaLinux Migration Guide
66

77
This guide describes how to convert your operating system to AlmaLinux using the [AlmaLinux Migration tool](https://github.com/AlmaLinux/almalinux-deploy).
88

@@ -15,17 +15,21 @@ What OSes can be converted:
1515
* Rocky Linux 8, 9
1616
* Virtuozzo Linux (VZLinux) 8, 9
1717

18-
This tool also supports cPanel, Plesk and DirectAdmin panels.
18+
This tool also supports cPanel, Plesk and DirectAdmin panels.
1919

2020
## How to Migrate
2121

2222
The minimal supported version of EL8 operating systems is 8.4. In case your OS version is lower, please, upgrade it.
2323

2424
:::tip
25-
It's recommended to have a backup or snapshot of your system. There'll be a restore point if something will go wrong.
25+
It's recommended to have a backup or snapshot of your system. There'll be a restore point if something will go wrong.
2626
:::
2727

28-
Follow these steps to convert your EL8 or EL9 system to AlmaLinux using CLI:
28+
::: warning
29+
Make sure you are using reliable console access to your system. It's recommended the migration tool is run from inside main console or via ssh.
30+
:::
31+
32+
Follow these steps to convert your EL8 or EL9 system to AlmaLinux using CLI:
2933

3034
* Run the following command to update your operating system if needed:
3135
```
@@ -60,7 +64,7 @@ sudo reboot
6064
## Migrating from CentOS versions lower than 8.4
6165

6266
There are a few additional moments when you are converting your CentOS System.
63-
CentOS 8.4 or 8.5 is required to convert to AlmaLinux. If your CentOS version is lower, it is recommended to update it to 8.5 before converting to AlmaLinux. Though, it's not necessary if your CentOS version is at least CentOS 8.4.
67+
CentOS 8.4 or 8.5 is required to convert to AlmaLinux. If your CentOS version is lower, it is recommended to update it to 8.5 before converting to AlmaLinux. Though, it's not necessary if your CentOS version is at least CentOS 8.4.
6468

6569
* As of January 31, 2022, the CentOS 8 mirror lists are offline. To successfully perform `dnf update -y` you need to update your `dnf` config files to point to a valid mirror. You can use the following `sed` commands for convenience to restore dnf to a functional state that will let you update to 8.5 and subsequently AlmaLinux.
6670
```
@@ -113,7 +117,6 @@ sudo bash almalinux-deploy.sh
113117
title="AlmaLinux (4.18.0-425.3.1.el8.x86_64) 8.7 (Stone Smilodon)"
114118
```
115119

116-
## Get Help
120+
## Get Help
117121

118122
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).
119-

0 commit comments

Comments
 (0)