Hi. I'm working on adding instructions to the documentation for how to migrate from a self-hosted engine to a stand alone manager. This will be the first time I've contributed anything to this project (or any larger open source project for that matter), so before I get too far in the weeds, I wanted to run this by the community so as not to waste my time if this is a bad idea.

My general high level documentation is pasted at the bottom of this email. These are the steps that I took when I did my own migration.

(Note to self: Need to add a step at the end to log into the Manager and disable the Gluster service by going to Computer --> Clusters --> (Edit the cluster) --> Uncheck the "Enable Gluster Service" checkbox.

And I've forked the ovirt-site repo and started working on the documentation here: https://github.com/dmwhite823/ovirt-site/tree/migrate-engine-to-standalone

I still have a ways to go before I'm ready to request a PR, but I'm open to any & all feedback. I think that I'm done with most of the changes necessary to ovirt-site/source/documentation/migrating_from_a_self-hosted_engine_to_a_standalone_manager/index.adoc, but I'm unclear why there's also a master.adoc file.

Note that I copied files into the new directory of migrating_from_a_self-hosted_engine_to_a_standalone_manager from the already existing  migrating_from_a_standalone_manager_to_a_self-hosted_engine structure directory, and am editing the files in the new directory.

Will this be useful / helpful? Would others on the team like to contribute to improving these instructions prior to issuing a PR to the ovirt-site git repo? Am I even doing this right?  ðŸ¤£

Thanks,
David

High level overview of steps required (pasted below):

Pre-req: Make sure VMs are not using HA lease of a gluster domain

1) Migrate all storage off Gluster

2) Remove all gluster volumes from oVirt

3) Put cluster into global maintenance
hosted-engine --set-maintenance --mode=global

4) On new VM:
Install CentOS Stream & add ovirt repos

dnf install centos-release-ovirt45
dnf module enable javapackages-tools pki-deps postgresql:12 mod_auth_openidc:2.3 nodejs:14

Stop & Disable the engine
# systemctl stop ovirt-engine
# systemctl disable ovirt-engine

Setup DNS in /etc/hosts if you don't have local DNS servers

Backup the engine
# engine-backup --mode=backup --file=file_name --log=log_file_name

Restore
# engine-backup --mode=restore --file=engine-backup-09172022-1 --log=restore --restore-permissions

Run engine-setup
# engine-setup