Skip to content

joaocorreiaCL/almalinux-deploy

 
 

Repository files navigation

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:

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.

About

EL to AlmaLinux migration tool.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 94.3%
  • Python 5.7%