/almalinux-deploy

EL to AlmaLinux migration tool.

Primary LanguageShellGNU General Public License v3.0GPL-3.0

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:

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.