mafalb / almalinux-deploy

EL to AlmaLinux migration tool.

almalinux-deploy

An EL to AlmaLinux migration tool.

Usage

In order to convert your EL8 operating system to AlmaLinux do the following:

1. As OS version 8.5 is required for migration, install the latest updates. It's also recommended to reboot after the update to boot with the latest kernel.

   sudo dnf update -y
   sudo reboot
   

2. Back up of the system. We didn't test all possible scenarios so there is a risk that something goes wrong. In such a situation you will have a restore point.

3. Download the almalinux-deploy.sh script:

   $ curl -O https://raw.githubusercontent.com/AlmaLinux/almalinux-deploy/master/almalinux-deploy.sh

4. Run the script and check its output for errors:

   $ sudo bash almalinux-deploy.sh
     ...
     Migration to AlmaLinux is completed

5. Reboot is recommended to boot with AlmaLinux kernel:

   sudo reboot
   

6. Ensure that your system was successfully converted:

   # check release file
   $ cat /etc/redhat-release
   AlmaLinux release 8.5 (Arctic Sphynx)
   
   # check that the system boots AlmaLinux kernel by default
   $ sudo grubby --info DEFAULT | grep AlmaLinux
   title="AlmaLinux (4.18.0-348.el8.x86_64) 8.5 (Arctic Sphynx)"

7. Thank you for choosing AlmaLinux!

Roadmap

• CentOS 8 support.
• Write debug information to a log file for failed migration analysis.
• Oracle Linux 8 support.
• RHEL 8 support.
• Rocky Linux 8 support.
• DirectAdmin control panel support.
• cPanel control panel support.
• Plesk control panel support.
• Cover all common scenarios with tests.
• Add OpenNebula support to Molecule test suite.

Get Involved

Any contribution is welcome:

• Find and report bugs.
• Submit pull requests with bug fixes, improvements and new tests.
• Test it on different configurations and share your thoughts in discussions.

Technology stack:

• The migration script is written in Bash.
• We use Bats for unit tests.
• Functional tests are implemented using Molecule, Ansible and Testinfra. Virtual machines are powered by Vagrant and VirtualBox.

To run the functional tests do the following:

1. Install Vagrant and VirtualBox.
2. Install requirements from the requirements.txt file.
3. Run molecule test --all in the project root.

License

Licensed under the GPLv3 license, see the LICENSE file for details.