Merge pull request #303 from cpanel/no-leapp

Add --no-leapp option to pause the process

docs-website-src/content/_index.md

@@ -218,6 +218,28 @@ Remove the `elevate-cpanel` service used during the upgrade process.
 
 A final reboot is performed at the end of this stage.
 
+## Advanced Options
+
+### Using an alternative tool to upgrade your distro
+
+By default, the elevate script runs the [leapp process](https://almalinux.org/elevate/)
+to upgrade you from 7 to 8. `Leapp` may not be compatible with your system.
+
+Using the `--no-leapp` option gives you a way to do the actual distro upgrade in your own way.
+This, for instance, can be used to allow `Virtuozzo` systems to upgrade cPanel systems, which are not supported by `Leapp`.
+
+A `--no-leapp` upgrade would look like:
+
+1. User runs `/scripts/elevate-cpanel --start --no-leapp` which starts the upgrade process.
+2. `elevate-cpanel` does all preparatory steps to upgrade the system prior to the distro upgrade.
+3. Elevate will then create the file `/waiting_for_distro_upgrade` to indicate that the operating system is ready for an upgrade.
+    * This is when you would use your distro upgrade tool.
+    * When you have completed upgrading your system to 8, simply remove `/waiting_for_distro_upgrade` and reboot the system into normal multi-user mode.
+5. Elevate will resume upon reboot and complete the upgrade just like it would have without `--no-leapp`
+
+The regular workflow is the following
+NOTE: `--no-leapp` is not required for helper commands like `--continue` or `--status`
+
 ## FAQ
 
 ### How to check the current status?