From 21eeb6a4e94c6b4e32ab9db9baa675f1831de248 Mon Sep 17 00:00:00 2001 From: nikolai_voina <161150950+NikolayVoina@users.noreply.github.com> Date: Sun, 6 Sep 2026 02:56:02 +0400 Subject: [PATCH 1/3] docs: guide safe first-time and interrupted CloudLinux conversion --- .../cloudlinux_installation/README.md | 129 ++++++++++++++++-- .../cloudlinuxos/command-line_tools/README.md | 7 +- docs/introduction/solo/README.md | 4 +- 3 files changed, 127 insertions(+), 13 deletions(-) diff --git a/docs/cloudlinuxos/cloudlinux_installation/README.md b/docs/cloudlinuxos/cloudlinux_installation/README.md index 76212afa5..301c2ade2 100644 --- a/docs/cloudlinuxos/cloudlinux_installation/README.md +++ b/docs/cloudlinuxos/cloudlinux_installation/README.md @@ -105,8 +105,8 @@ To detect whether CloudLinux OS is installed and functional on a system, use the ### Conversion Process -It's easy to convert your existing installation through the `cldeploy` script. -The process takes a few minutes and replaces just a handful of packages. +Use the `cldeploy` script to convert a supported existing server to CloudLinux OS. +Conversion changes packages, repositories, and control panel integration. Its duration depends on the installed software and download speed. Plan a maintenance window and a reboot. :::warning Unlike [new server installation](#installing-new-servers), @@ -127,6 +127,10 @@ Currently supported operating systems for conversion: * Rocky Linux 10 ::: +:::warning OS version and edition +Conversion keeps the same major OS version; it is not an upgrade from CentOS 7 to CloudLinux OS 8 or later. CloudLinux OS Solo is not available on CentOS 6 or 7. For Solo, prepare a server with a supported OS and migrate the hosted accounts using your control panel's migration procedure. Check the [Solo requirements](/introduction/solo/) before choosing the source OS and license. +::: + :::warning SELinux SELinux is not supported on CloudLinux OS 6 and 7. SELinux is supported on CloudLinux OS 8+, but might not work or be compatible with control panels and various components. @@ -162,13 +166,55 @@ If you would like to convert from CentOS 8 to CloudLinux OS 8, follow these step ### Downloading and running the conversion script -#### Key-based activation +#### Before you start -If you want to use your activation key for activation, run the following commands: +1. Confirm that the OS, architecture, virtualization environment, control panel, and intended CloudLinux edition meet the [requirements](#requirements). Also check the requirements of the features you plan to use, such as PHP Selector or AccelerateWP. +2. Have a tested backup of hosted accounts, databases, and server configuration, and know how to restore it. Arrange access to the provider's console or rescue environment in case the server does not boot after conversion. +3. Schedule a maintenance window. Complete any running package installation, OS upgrade, or control panel update first. Do not run two conversions or another package operation at the same time. +4. Confirm that the activation key is valid for the intended edition, or that the server's public IP has the correct IP-based license. Keep the key private. +5. Resolve existing package-manager, repository, and control panel errors before conversion. Repositories must be reachable using valid certificates and credentials. Do not bypass a failed compatibility or certificate check to start conversion. +6. If an earlier conversion stopped, use [Troubleshooting](#troubleshooting) before running these commands. A partially converted server is not a clean starting point. -``` +Run the following commands as `root` to download the script: + +```bash yum install wget -y wget https://repo.cloudlinux.com/cloudlinux/sources/cln/cldeploy +``` + +Use an empty working directory for a new conversion so that `wget` does not save a new download as `cldeploy.1` while you continue to run an older `cldeploy` file. Preserve the script used by an interrupted conversion when investigating that run. + +#### Check readiness + +Review the options supported by the downloaded script: + +```bash +bash cldeploy --help +``` + +The `--precheck` option checks conversion prerequisites and writes `/var/log/cldeploy-precheck.log`. + +:::warning Precheck is not a full conversion test +In `cldeploy` 1.132, `--precheck` is not guaranteed to leave the system unchanged. It can import a package signing key and can offer to remove an incompatible Plesk Cgroups Manager extension. Review prompts and do not use `--noninteractive` or automatically answer yes when assessing an existing server. Treat precheck as a potentially changing operation within the maintenance window, unless the release notes for your script explicitly guarantee otherwise. + +A successful precheck does not prove that registration, package transactions, control panel setup, or the next boot will succeed. Read the reported failures and mandatory changes; the exit code alone is not a readiness verdict. + +The basic `--precheck` command below also does not establish eligibility for your chosen edition or license. Check the edition and control panel requirements independently before conversion. +::: + +After reviewing this limitation, run: + +```bash +bash cldeploy --precheck +``` + +Resolve the reported prerequisites before starting conversion. Do not use `--skip-os-check`, `--skip-kmod-check`, or `--skip-boot-check` to turn an unsupported configuration into a supported one. + +#### Key-based activation + +To start a clean conversion with an activation key: + +```bash bash cldeploy -k ACTIVATION_KEY ``` @@ -190,13 +236,19 @@ sh cldeploy -i --to-admin-edition ``` ### Next steps +Wait for the conversion to finish successfully and review its final instructions. If it reports an error or stops unexpectedly, follow [Troubleshooting](#troubleshooting) before rebooting or rerunning it. An installed `cloudlinux-release` package or a changed OS name alone does not prove that conversion completed. + After a successful conversion, reboot your system: ``` reboot ``` -Once you reboot, your server should be running with CloudLinux OS LVE kernel. +After rebooting, check the kernel as described below, sign in to the control panel, and verify the CloudLinux integration installed during conversion. Check a hosted website and its database connection before ending the maintenance window. CloudLinux OS 9 and later use an AlmaLinux kernel; they do not require `LVE` in the kernel name. + +Features such as PHP Selector, X-Ray, and AccelerateWP have their own installation, licensing, and control panel requirements. A completed OS conversion does not mean that every optional feature has been installed or is supported by the panel. Follow the setup guide for each feature you select: [PHP Selector](/cloudlinuxos/cloudlinux_os_components/#installation-and-update-4), [X-Ray](/cloudlinuxos/shared-pro/#x-ray), or [AccelerateWP](/cloudlinuxos/shared-pro/#getting-started). Verify each selected feature separately. + +If you intentionally used `--conversion-only`, control panel components were not installed. Once the OS conversion has completed successfully, follow the [component installation options](/cloudlinuxos/command-line_tools/#cldeploy). `--components-only` installs panel components on a converted system; it does not complete a failed OS conversion or repair registration and package transactions. #### Checking the booted kernel @@ -270,9 +322,68 @@ To do so, you need to do the following: ### Troubleshooting -If you receive any troubles during the conversion process, -please feel free to search our [knowledge base](https://cloudlinux.zendesk.com/hc/en-us) -or contact our support and attach the conversion log (/var/log/cldeploy.log). +#### Clean conversion or recovery + +Choose the next step from the outcome of the previous run: + +| Server state | Next step | +| --- | --- | +| Conversion has never run, or it stopped at a prerequisite check before any conversion changes | Resolve the reported prerequisite, then follow [Before you start](#before-you-start) and the normal conversion instructions. | +| Conversion stopped during registration, package installation, or panel setup, or you cannot establish where it stopped | Preserve the existing log and identify the failure below. Do not start another clean conversion against the partial installation. | +| Conversion completed, but a panel feature is missing or reports an error | Check the selected edition, any use of `--conversion-only`, and the feature's panel requirements. Investigate that component instead of converting the OS again. | + +:::warning Interrupted conversion and resume +The public `cldeploy` 1.132 script does not provide `--resume`. Do not add this option to that script. Any recovery instructions for a later release must match both the installed script and the state recorded by the original conversion; downloading a newer script does not create missing recovery state for an older failed run. + +Do not use `--skip-os-check` as a general recovery command. Do not delete `/etc/cl-convert-saved`, replace OS release packages, or force-remove conflicting packages to make a retry pass. These actions can destroy the information needed to recover safely. +::: + +#### Identify the failure + +| Reported problem | What to check | +| --- | --- | +| Unsupported source OS, edition, kernel, or panel | Compare the complete combination against [Requirements](#requirements) and the panel's requirements. Use a supported migration path. A license change or a skipped check does not add compatibility. | +| License or registration error | Check the intended edition, activation key validity or licensed public IP, and the server association in [CloudLinux Network](https://cln.cloudlinux.com/). If the error names a network or certificate failure, resolve that cause rather than repeatedly changing the key. | +| Repository, dependency, or conflicting-package error | Read the first failed transaction in the conversion log. Check which repository and package versions it names. Restore access to the intended repositories; do not disable signature checks, remove packages with `rpm --nodeps`, or add `--force-packages-installation` as a general fix. | +| Another package operation is running | Allow the existing update or installation to finish. Do not delete package-manager or conversion lock files to start a second operation. | +| CloudLinux Manager, Python environment, or PHP Selector error | Check the conversion's component-installation result and the affected feature's prerequisites. An import error or an incorrect panel name needs investigation before reinstalling packages or changing integration files. | + +Correcting the reported cause does not by itself establish that a partial conversion can be restarted. Use recovery instructions for that exact failure and script version. If no supported recovery path applies, stop further conversion changes and use the escalation guidance below. + +#### Inspect the existing state and logs + +The following queries do not install or remove packages: + +```bash +cat /etc/os-release +uname -r +rpm -q --qf '%{NAME} %{EPOCH}:%{VERSION}-%{RELEASE}.%{ARCH}\n' cloudlinux-release lve-utils cloudlinux-venv lvemanager cagefs +``` + +A missing package in this output is information for diagnosis, not an instruction to install it. On CloudLinux OS 10, `/etc/os-release` continues to identify the base OS; see [Subsystem Mode](#cloudlinux-os-10-subsystem-mode). + +If `/usr/bin/cldetect` is available, check its view of the edition and control panel: + +```bash +/usr/bin/cldetect --detect-edition +/usr/bin/cldetect --detect-cp +``` + +Compare the detected panel with the panel actually installed. If `cldetect` fails, retain its error rather than treating empty output as "no panel" or "not converted". + +Use the logs that the conversion already creates: + +* `/var/log/cldeploy.log` — conversion output, including registration, package transactions, and panel setup. +* `/var/log/cldeploy-precheck.log` — readiness checks, if precheck was run. +* The package-manager logs for the same time period, such as `/var/log/dnf.log` and `/var/log/dnf.rpm.log` on DNF-based systems, or `/var/log/yum.log` on CentOS 7. + +Preserve the failed run's logs before a retry. Review them locally and remove activation keys, passwords, tokens, and private customer information from any copy you share. Do not paste full logs or license keys into a public issue. + +#### When to stop and escalate + +If the recovery procedure is unclear, the server has conflicting release or core packages, or you cannot confirm a safe boot configuration, stop before further package changes or a reboot. Search the [knowledge base](https://cloudlinux.zendesk.com/hc/en-us) for the exact error. If no matching procedure applies, [contact support](https://cloudlinux.zendesk.com/hc/en-us/requests/new) through the private channel with the existing conversion log, the first failed step, the source OS and panel versions, and the command used with secrets removed. Include any changes made after the failure. + +This is an exception path for an unsafe or unknown state. For an eligible server that has not been partially converted, the normal conversion and validation steps above are the self-service path. #### Server panics or reboots during conversion on Intel CPUs with IBT diff --git a/docs/cloudlinuxos/command-line_tools/README.md b/docs/cloudlinuxos/command-line_tools/README.md index a987a2676..013777963 100644 --- a/docs/cloudlinuxos/command-line_tools/README.md +++ b/docs/cloudlinuxos/command-line_tools/README.md @@ -2679,6 +2679,7 @@ Usage: |`--serverurl`|Use non-default registration server (default is `https://xmlrpc.cln.cloudlinux.com/XMLRPC`)| |`--components-only`|Install control panel components only| |`--conversion-only`|Do not install control panel components after converting| +|`--precheck`|Check conversion prerequisites and write `/var/log/cldeploy-precheck.log`. Read the [precheck limitations](/cloudlinuxos/cloudlinux_installation/#check-readiness) before running it.| |`--hostinglimits`|Install mod_hostinglimits rpm| |`--skip-kmod-check`|Skip check for unsupported kmods| |`--skip-version-check`|Do not check for script updates| @@ -2691,7 +2692,9 @@ Usage: |`--force-packages-installation `|Automatically resolve dependencies and remove conflicting packages| |`--allow-lower-version `|Convert to lower minor version (Almalinux x.y to CL x.y-1) if current version (CL x.y) is not available| -The script will perform the following actions: +For first-time conversion, follow the [preparation and readiness guide](/cloudlinuxos/cloudlinux_installation/#before-you-start). For a failed or partial conversion, use the [recovery decision guide](/cloudlinuxos/cloudlinux_installation/#clean-conversion-or-recovery) before choosing options. `--components-only` is not a recovery mode for an incomplete OS conversion, and `--force-packages-installation` can remove conflicting packages. + +During a normal conversion, the script will perform the following actions: 1. Register server with CLN. 2. Install CloudLinux OS kernel, lve libraries, lve-utils, lve-stats and pam_lve packages. @@ -4095,4 +4098,4 @@ For resellers' users with reseller limits enabled admin should use the \ No newline at end of file + diff --git a/docs/introduction/solo/README.md b/docs/introduction/solo/README.md index 1a3a07534..71c514d15 100644 --- a/docs/introduction/solo/README.md +++ b/docs/introduction/solo/README.md @@ -170,7 +170,7 @@ Please feel free to ask your questions [here](https://cloudlinux.zendesk.com/hc/ ### Can I convert to CloudLinux OS Solo from another OS? -You can convert CentOS/AlmaLinux OS to CloudLinux OS Solo. Please refer to [this instruction](/solo/installation/#converting-existing-servers). +You can convert a supported source OS to CloudLinux OS Solo. Check the [current OS and panel requirements](/cloudlinuxos/cloudlinux_installation/#requirements) and follow the [preparation and conversion instructions](/cloudlinuxos/cloudlinux_installation/#before-you-start). ### What is the Website Monitoring tool intended for? @@ -208,7 +208,7 @@ No, you cannot. ### Can I convert CentOS 6,7 to CloudLinux OS Solo 8+ using the cldeploy script? -No, you cannot. Only CentOS 8/AlmaLinux 8+ can be converted. +No. `cldeploy` keeps the same major OS version; it does not upgrade CentOS 6 or 7 to CloudLinux OS 8 or later. CloudLinux OS Solo requires a supported OS version and control panel. Prepare a supported server and migrate the hosted accounts using your panel's migration procedure, then follow the [conversion requirements and preparation guide](/cloudlinuxos/cloudlinux_installation/#before-you-start). Check the current [supported source operating systems](/cloudlinuxos/cloudlinux_installation/#requirements); CentOS 8 is not a supported direct conversion source. ### Does CloudLinux OS Solo work with LiteSpeed? From c9d0dfb0b1ce95d7996d734b74f9ebabd48b4047 Mon Sep 17 00:00:00 2001 From: nikolai_voina <161150950+NikolayVoina@users.noreply.github.com> Date: Sun, 6 Sep 2026 16:12:35 +0400 Subject: [PATCH 2/3] docs: align conversion safety guidance with current cldeploy --- .../cloudlinux_installation/README.md | 16 +++++++++++----- docs/cloudlinuxos/command-line_tools/README.md | 7 ++++--- 2 files changed, 15 insertions(+), 8 deletions(-) diff --git a/docs/cloudlinuxos/cloudlinux_installation/README.md b/docs/cloudlinuxos/cloudlinux_installation/README.md index 301c2ade2..7223a7990 100644 --- a/docs/cloudlinuxos/cloudlinux_installation/README.md +++ b/docs/cloudlinuxos/cloudlinux_installation/README.md @@ -195,7 +195,9 @@ bash cldeploy --help The `--precheck` option checks conversion prerequisites and writes `/var/log/cldeploy-precheck.log`. :::warning Precheck is not a full conversion test -In `cldeploy` 1.132, `--precheck` is not guaranteed to leave the system unchanged. It can import a package signing key and can offer to remove an incompatible Plesk Cgroups Manager extension. Review prompts and do not use `--noninteractive` or automatically answer yes when assessing an existing server. Treat precheck as a potentially changing operation within the maintenance window, unless the release notes for your script explicitly guarantee otherwise. +In the public `cldeploy` 1.132 script, `--precheck` can change the system. It can import a package signing key, create or change permissions on `/var/lve`, write a readiness marker there, and automatically disable and remove an enabled Plesk Cgroups Manager extension. The Plesk removal does not require an interactive confirmation in precheck mode; omitting `--noninteractive` does not prevent it. + +Run this precheck only when those changes are acceptable within the planned maintenance window, or first assess its behavior on a disposable clone. A newer script version number alone does not establish that precheck is non-mutating; verify the release notes for the exact script you use. A successful precheck does not prove that registration, package transactions, control panel setup, or the next boot will succeed. Read the reported failures and mandatory changes; the exit code alone is not a readiness verdict. @@ -238,7 +240,9 @@ sh cldeploy -i --to-admin-edition ### Next steps Wait for the conversion to finish successfully and review its final instructions. If it reports an error or stops unexpectedly, follow [Troubleshooting](#troubleshooting) before rebooting or rerunning it. An installed `cloudlinux-release` package or a changed OS name alone does not prove that conversion completed. -After a successful conversion, reboot your system: +Review boot warnings even if the script exits successfully. If it reports missing kernel or initramfs files, an unexpected boot entry, or a boot configuration that needs attention, resolve that warning before rebooting. A zero exit code alone does not establish that the next boot is safe. + +After a successful conversion with no unresolved boot warnings, reboot your system: ``` reboot @@ -248,13 +252,14 @@ After rebooting, check the kernel as described below, sign in to the control pan Features such as PHP Selector, X-Ray, and AccelerateWP have their own installation, licensing, and control panel requirements. A completed OS conversion does not mean that every optional feature has been installed or is supported by the panel. Follow the setup guide for each feature you select: [PHP Selector](/cloudlinuxos/cloudlinux_os_components/#installation-and-update-4), [X-Ray](/cloudlinuxos/shared-pro/#x-ray), or [AccelerateWP](/cloudlinuxos/shared-pro/#getting-started). Verify each selected feature separately. -If you intentionally used `--conversion-only`, control panel components were not installed. Once the OS conversion has completed successfully, follow the [component installation options](/cloudlinuxos/command-line_tools/#cldeploy). `--components-only` installs panel components on a converted system; it does not complete a failed OS conversion or repair registration and package transactions. +If you intentionally used `--conversion-only`, the script skipped control panel component installation. Once the OS conversion has completed successfully, follow the [component installation options](/cloudlinuxos/command-line_tools/#cldeploy). `--components-only` installs panel components on a converted system; it does not complete a failed OS conversion or repair registration and package transactions. #### Checking the booted kernel :::tip Note -This information applies only to CloudLinux OS 8 and below. -CloudLinux OS 9 and above use the non-modified AlmaLinux kernel. +The `LVE` name check below applies to CloudLinux OS 8 and earlier installations that use the CloudLinux LVE kernel. CloudLinux OS 9 and later use an AlmaLinux kernel and do not require `LVE` in its name. + +Do not use the kernel name alone to judge a Solo conversion or a container environment; the expected kernel depends on the edition and virtualization environment. Where the hosting provider controls boot selection, verify the provider's boot settings as well as the guest configuration. ::: You can check the booted kernel with the following command: @@ -375,6 +380,7 @@ Use the logs that the conversion already creates: * `/var/log/cldeploy.log` — conversion output, including registration, package transactions, and panel setup. * `/var/log/cldeploy-precheck.log` — readiness checks, if precheck was run. +* `/var/log/cldeploy-debug.log` — system information recorded before conversion, if the run reached that step. * The package-manager logs for the same time period, such as `/var/log/dnf.log` and `/var/log/dnf.rpm.log` on DNF-based systems, or `/var/log/yum.log` on CentOS 7. Preserve the failed run's logs before a retry. Review them locally and remove activation keys, passwords, tokens, and private customer information from any copy you share. Do not paste full logs or license keys into a public issue. diff --git a/docs/cloudlinuxos/command-line_tools/README.md b/docs/cloudlinuxos/command-line_tools/README.md index 013777963..51c07bc59 100644 --- a/docs/cloudlinuxos/command-line_tools/README.md +++ b/docs/cloudlinuxos/command-line_tools/README.md @@ -2672,7 +2672,7 @@ Usage: | | | |--|--| -|`-h, --help`|Print this message| +|`--help`|Print the supported options| |`-k, --key <key>`|Update your system to CloudLinux OS with activation key| |`-i, --byip`|Update your system to CloudLinux OS and register by IP| |`-c, --uninstall`|Convert CloudLinux OS back to CentOS| @@ -2690,14 +2690,15 @@ Usage: |`--to-admin-edition `|Convert to CloudLinux Admin edition (only allowed with --skip-registration option)| |`--to-container-environment `|Convert to CloudLinux which supports working inside containers| |`--force-packages-installation `|Automatically resolve dependencies and remove conflicting packages| -|`--allow-lower-version `|Convert to lower minor version (Almalinux x.y to CL x.y-1) if current version (CL x.y) is not available| + +Minor-version step-down is selected automatically when applicable; it does not require `--allow-lower-version`, which is not accepted by the current script. See [Minor version step-down](/cloudlinuxos/cloudlinux_installation/#minor-version-step-down) for its compatibility limits. For first-time conversion, follow the [preparation and readiness guide](/cloudlinuxos/cloudlinux_installation/#before-you-start). For a failed or partial conversion, use the [recovery decision guide](/cloudlinuxos/cloudlinux_installation/#clean-conversion-or-recovery) before choosing options. `--components-only` is not a recovery mode for an incomplete OS conversion, and `--force-packages-installation` can remove conflicting packages. During a normal conversion, the script will perform the following actions: 1. Register server with CLN. -2. Install CloudLinux OS kernel, lve libraries, lve-utils, lve-stats and pam_lve packages. +2. Install the packages required for the detected OS version and selected edition. Kernel and LVE-related packages depend on that combination; not every edition installs or uses every component. 3. Attempt to detect control panel and do the following actions: * _For cPanel_: * install mod_hostinglimits; From 090e80e262e6063a5b51f31d488840fb15127ee1 Mon Sep 17 00:00:00 2001 From: nikolai_voina <161150950+NikolayVoina@users.noreply.github.com> Date: Sun, 6 Sep 2026 16:19:16 +0400 Subject: [PATCH 3/3] docs: clarify conversion edition and license selection --- docs/cloudlinuxos/cloudlinux_installation/README.md | 4 ++-- docs/cloudlinuxos/command-line_tools/README.md | 12 +++++++----- 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/cloudlinuxos/cloudlinux_installation/README.md b/docs/cloudlinuxos/cloudlinux_installation/README.md index 7223a7990..08b282d83 100644 --- a/docs/cloudlinuxos/cloudlinux_installation/README.md +++ b/docs/cloudlinuxos/cloudlinux_installation/README.md @@ -225,14 +225,14 @@ Your CloudLinux OS edition will be detected automatically based on the `ACTIVATI #### IP-based activation -If your reseller provides you with an IP-based license, run the following commands: +If your reseller provides you with an IP-based license, confirm that the server's public IP is licensed for the intended edition before conversion. An edition flag does not change or upgrade that license. To convert server into the CloudLinux OS edition: ``` sh cldeploy -i ``` -To convert server into the CloudLinux OS Admin edition: +To convert a server that meets the Admin edition's OS and panel requirements and has an Admin IP-based license: ``` sh cldeploy -i --to-admin-edition ``` diff --git a/docs/cloudlinuxos/command-line_tools/README.md b/docs/cloudlinuxos/command-line_tools/README.md index 51c07bc59..87d6fbaa1 100644 --- a/docs/cloudlinuxos/command-line_tools/README.md +++ b/docs/cloudlinuxos/command-line_tools/README.md @@ -2686,11 +2686,13 @@ Usage: |`--skip-registration`|Don't register on CLN if already have access to CL repository| |`--force-hybridize`|Option allows to convert CloudLinux OS 7 to CloudLinux OS 7 Hybrid which has a newer kernel (from v1.61)| |`--no-force-hybridize `|Don't hybridize machine from CloudLinux 7 to CloudLinux 7 Hybrid automatically, even though machine has a new hardware| -|`--to-solo-edition `|Convert to CloudLinux Solo edition (only allowed with --skip-registration option)| -|`--to-admin-edition `|Convert to CloudLinux Admin edition (only allowed with --skip-registration option)| +|`--to-solo-edition`|Select CloudLinux OS Solo for a source OS and panel supported by that edition. The license must match the intended edition.| +|`--to-admin-edition`|Select CloudLinux OS Admin for a source OS and panel supported by that edition. The license must match the intended edition.| |`--to-container-environment `|Convert to CloudLinux which supports working inside containers| |`--force-packages-installation `|Automatically resolve dependencies and remove conflicting packages| +Edition flags select the requested setup; they do not grant or change a license. For key-based activation, use a key for the intended edition, which the script detects from that key. For IP-based activation, confirm that the server's public IP has the matching license before selecting an edition. `--skip-registration` is a separate mode for systems that already have repository access, not a requirement for using an edition flag. + Minor-version step-down is selected automatically when applicable; it does not require `--allow-lower-version`, which is not accepted by the current script. See [Minor version step-down](/cloudlinuxos/cloudlinux_installation/#minor-version-step-down) for its compatibility limits. For first-time conversion, follow the [preparation and readiness guide](/cloudlinuxos/cloudlinux_installation/#before-you-start). For a failed or partial conversion, use the [recovery decision guide](/cloudlinuxos/cloudlinux_installation/#clean-conversion-or-recovery) before choosing options. `--components-only` is not a recovery mode for an incomplete OS conversion, and `--force-packages-installation` can remove conflicting packages. @@ -2723,9 +2725,9 @@ Examples:
``` -cldeploy --key xx-xxxxxx # convert RHEL/CentOS to CL by using activation key, install control panel components -cldeploy --key xx-xxxxxx --force-hybridize # convert RHEL/CentOS 7 to CL7h by using activation key, install control panel components (from v1.61) -cldeploy --byip --conversion-only # convert RHEL/CentOS to CL by ip, don't install control panel components +cldeploy --key xx-xxxxxx # convert a supported source OS using an activation key; install panel components +cldeploy --key xx-xxxxxx --force-hybridize # convert a supported CentOS 7 server to CL7 Hybrid; install panel components +cldeploy --byip --conversion-only # convert a supported source OS using its IP-based license; skip panel component installation cldeploy --components-only # install control panel components on already converted system cldeploy --hostinglimits # update httpd and install mod_hostinglimits ```