Arkady L. Shane
a8415b1a5c
|
5 months ago | |
---|---|---|
.gitignore | 9 months ago | |
.yamllint | 9 months ago | |
Jenkinsfile | 9 months ago | |
LICENSE | 9 months ago | |
README.md | 9 months ago | |
Vagrantfile | 9 months ago | |
msvsphere-deploy.sh | 5 months ago | |
requirements.txt | 9 months ago | |
test_almalinux-deploy.bats | 9 months ago |
README.md
msvsphere-deploy
An EL to MSVSphere migration tool.
Usage
In order to convert your EL8 and EL9 operating systems to MSVSphere do the following:
-
CentOS 8.4 or 8.5 is required to convert to MSVSphere. It is recommended to update to 8.5 prior to moving to MSVSphere but not required if you are on at least CentOS 8.4. Rebooting after the updates is recommended if your system received new updates.
sudo dnf update -y sudo reboot
- As of January 31, 2022 the CentOS 8 mirrorlists are offline. In order to successfully perform
dnf update -y
you need to update yourdnf
config files to point to a valid mirror. You can use the followingsed
commands for convenience to restorednf
to a functional state that will let you update to 8.5 and subsequently MSVSphere.-
sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[baseos\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/BaseOS/$basearch/os' /etc/yum.repos.d/CentOS-Linux-BaseOS.repo sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[appstream\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/AppStream/$basearch/os' /etc/yum.repos.d/CentOS-Linux-AppStream.repo sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[cr\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/ContinuousRelease/$basearch/os' /etc/yum.repos.d/CentOS-Linux-ContinuousRelease.repo sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[devel\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/Devel/$basearch/os' /etc/yum.repos.d/CentOS-Linux-Devel.repo sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[extras\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/extras/$basearch/os' /etc/yum.repos.d/CentOS-Linux-Extras.repo sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[fasttrack\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/fasttrack/$basearch/os' /etc/yum.repos.d/CentOS-Linux-FastTrack.repo sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[ha\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/HighAvailability/$basearch/os' /etc/yum.repos.d/CentOS-Linux-HighAvailability.repo sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[plus\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/centosplus/$basearch/os' /etc/yum.repos.d/CentOS-Linux-Plus.repo sudo sed -i -e '/mirrorlist=http:\/\/mirrorlist.centos.org\/?release=$releasever&arch=$basearch&repo=/ s/^#*/#/' -e '/baseurl=http:\/\/mirror.centos.org\/$contentdir\/$releasever\// s/^#*/#/' -e '/^\[powertools\]/a baseurl=https://mirror.rackspace.com/centos-vault/8.5.2111/PowerTools/$basearch/os' /etc/yum.repos.d/CentOS-Linux-PowerTools.repo
- You can use the
-f
flag (iesudo bash msvsphere-deploy.sh -f
) to handle this for you.
-
-
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.
-
Download the msvsphere-deploy.sh script:
curl -O https://git.inferitos.ru/msvsphere/msvsphere-deploy/raw/branch/main/msvsphere-deploy.sh
-
Run the script and check its output for errors:
$ sudo bash msvsphere-deploy.sh ... Migration to MSVSphere is completed
-
Reboot is recommended to boot with MSVSphere kernel:
sudo reboot
-
Ensure that your system was successfully converted:
# check release file $ cat /etc/redhat-release MSVSphere release 8.5 (Arctic Sphynx) # check that the system boots MSVSphere kernel by default $ sudo grubby --info DEFAULT | grep MSVSphere title="MSVSphere (4.18.0-348.el8.x86_64) 8.5 (Arctic Sphynx)"
-
Thank you for choosing MSVSphere!
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.
- Virtuozzo Linux (VZLinux) 8 support.
- DirectAdmin control panel support.
- cPanel control panel support.
- Plesk control panel support.
- CentOS Stream 8 downgrade support with
-d
option. - EL9 (RHEL 9, Oracle Linux 9, Rocky Linux 9, Virtuozzo Linux 9) and CentOS Stream 9 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.
- CI/CD: Jenkins and an agent with Vagrant Libvirt.
To run the functional tests do the following:
- Install Vagrant and VirtualBox.
- Install requirements from the requirements.txt file.
- Run
molecule test --all
in the project root.
License
Licensed under the GPLv3 license, see the LICENSE file for details.