A new version of the EL8 operating system to AlmaLinux conversion script is available. This update comes with better secure boot detection. Secure boot is currently not supported by AlmaLinux.

almalinux-deploy

An EL to AlmaLinux migration tool.

Usage

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

1. Make a backup 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.
2. Disable Secure Boot because AlmaLinux doesn't support it yet ( almbz#3). Detailed instructions for bare metal hardware can be found  here. Instructions for VMWare are available  here.
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. Ensure that your system was successfully converted:

   # check release file
   $ cat /etc/redhat-release 
   AlmaLinux release 8.3 (Purple Manul)
   
   # check that the system boots AlmaLinux kernel by default
   $ sudo grubby --info DEFAULT | grep AlmaLinux
   title="AlmaLinux (4.18.0-240.el8.x86_64) 8"

6. 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.
•  DirectAdmin control panel support.
•  cPanel control panel support.
•  Plesk control panel support (blocked from Plesk side).
•  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.