Skip to content

Latest commit

 

History

History
99 lines (68 loc) · 2.81 KB

README.md

File metadata and controls

99 lines (68 loc) · 2.81 KB
Raw

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.