Update Ubuntu docs for the Ubuntu 22 release

prilr · prilr · commit 264048771704 · 2024-12-27T12:08:22.000+01:00
diff --git a/docs/ubuntu/faq/README.md b/docs/ubuntu/faq/README.md
@@ -1,41 +1,43 @@
 # FAQ
 
-### What is the CloudLinux subsystem on Ubuntu?
+## What is the CloudLinux Subsystem on Ubuntu?
 
-CloudLinux subsystem on Ubuntu is a scope of deb-packages that allows using CloudLinux features on Ubuntu OS.
+CloudLinux Subsystem on Ubuntu is a scope of deb-packages that allows using CloudLinux features on Ubuntu OS.
 The main goal of this subsystem is to allow using the already existing CloudLinux functionality on another OS.
 
-### How to install the CloudLinux subsystem on Ubuntu?
+## How to install the CloudLinux subsystem on Ubuntu?
 
 See [Installation](/sub-system-ubuntu/installation/).
 
-### Is the CloudLinux subsystem on Ubuntu paid/unpaid?
+## Is the CloudLinux Subsystem on Ubuntu paid/unpaid?
 
-During the beta period it is free.
+The CloudLinux Subsystem on Ubuntu is paid.
+It follows the same licensing model as CloudLinux OS.
 
-### Can I get the ISO for the CloudLinux subsystem on Ubuntu?
+## Can I get the ISO for the CloudLinux subsystem on Ubuntu?
 
 As of now, only installation via `ubuntu2cloudlinux.py` is available.
+ISO images can be provided upon request.
 
-### What control panel can be used with the CloudLinux subsystem on Ubuntu?
+## What control panel can be used with the CloudLinux subsystem on Ubuntu?
 
 As of now, only cPanel is supported. Plesk and DirectAdmin are not supported.
 
-### How can I get support for my CloudLinux subsystem on Ubuntu servers?
+## How can I get support for my CloudLinux subsystem on Ubuntu servers?
 
 Feel free to contact Support via [Support Portal](https://www.cloudlinux.com/support-portal/).
 
-### Can I use Docker with the CloudLinux subsystem on Ubuntu?
+## Can I use Docker with the CloudLinux subsystem on Ubuntu?
 
 You cannot use Docker with the CloudLinux subsystem on Ubuntu in the current version.
 
-### Is control panel integration functionality available in the current release?
+## Is control panel integration functionality available in the current release?
 
 Yes, it is available.
 
-### How to set up a PHP-fpm handler for the domain?
+## How to set up a PHP-fpm handler for the domain?
 
-Since the PHP-fpm handler is required to use AccelerateWP, you may need to configure it manually.
+Since the PHP-fpm handler is required to use Accelerate WP, you may need to configure it manually.
 
 These are configuration steps:
 
diff --git a/docs/ubuntu/features/README.md b/docs/ubuntu/features/README.md
@@ -27,28 +27,23 @@ The documentation is available [here](/cloudlinuxos/limits/#reseller-limits).
 
 ## MySQL Governor
 
-MySQL Governor is software to monitor and restrict MySQL usage in a shared hosting environment. The monitoring is done
-via resource usage statistics per each MySQL thread.
+MySQL Governor is a software package that monitors and restricts MySQL usage in a shared hosting environment. The monitoring is done via resource usage statistics per each MySQL thread.
 
 MySQL Governor can also kill off slow SELECT queries.
 
-MySQL Governor has multiple modes of operations, depending on the configuration. It can work in monitor-only mode, or it
-can use different throttling scenarios.
+MySQL Governor has multiple modes of operations, depending on the configuration. It can work in monitor-only mode, or it can use different throttling scenarios.
 
-MySQL Governor allows restricting customers who use too many resources. It supports following limits:
+MySQL Governor allows restricting customers that use too many resources. It supports following limits:
 
 |       |       |                                                                                                        |
 |-------|-------|--------------------------------------------------------------------------------------------------------|
 | CPU   | %     | CPU speed relative to one core. 150% would mean one and a half cores                                   |
 | READ  | bytes | bytes read. Cached reads are not counted, only those that were actually read from disk will be counted |
 | WRITE | bytes | bytes written. Cached writes are not counted, only once data is written to disk, it is counted         |
 
-You can set different limits for different periods: current, short, med, long. By default those periods are defined as 1
-second, 5 seconds, 1 minute and 5 minutes. They can be re-defined using
-the [configuration file](/cloudlinuxos/cloudlinux_os_components/#configuration-and-operation). The idea is
-to use larger acceptable values for shorter periods. Like you could allow a customer to use two cores (200%) for one
-second, but only 1 core (on average) for 1 minute, and only 70% within 5 minutes. That would make sure that customer can
-burst for short periods of time.
+You can set different limits for different periods: current, short, med, long. By default those periods are defined as 1 second, 5 seconds, 1 minute and 5 minutes. They can be re-defined using the [configuration file](/cloudlinuxos/cloudlinux_os_components/#configuration-and-operation).
+The idea is to use larger acceptable values for shorter periods. Like you could allow a customer to use two cores (200%) for one second, but only 1 core (on average) for 1 minute, and only 70% within 5 minutes.
+That would make sure that customer can burst for short periods of time.
 
 When a customer is restricted, the customer will be placed into special LVE with ID 3. All restricted customers will be
 placed into that LVE, and you can control the amount of resources available to restricted customers. Restricted
@@ -60,10 +55,9 @@ connections to the server.
 :::warning Attention!
 MySQL Governor on Ubuntu supports the following only:
 
-* cl-MySQL80 on non-panel system
+* cl-MySQL80 on non-panel systems
 * cl-MySQL80 on cPanel
-* cl-MariaDB103 on non-panel system
-  :::
+:::
 
 1. Install MySQL Governor
 
diff --git a/docs/ubuntu/installation/README.md b/docs/ubuntu/installation/README.md
@@ -1,28 +1,48 @@
 # Installation
 
-:::tip 
-For the current release, installation from the ISO images is not available. 
+:::tip
+For the current release, installation from the ISO images is not available.
 :::
 
-To install the CloudLinux subsystem, run the following command:
+To install the CloudLinux Subsystem on an Ubuntu machine:
 
-```
+1. Make sure you have Python 3 installed on your system. If not, install it using the following command:
+
+```shell
 apt install python3
+```
+
+2. Download the `ubuntu2cloudlinux.py` script:
+
+```shell
 wget https://repo.cloudlinux.com/cloudlinux-ubuntu/sources/cln/ubuntu2cloudlinux.py
-python3 ubuntu2cloudlinux.py
-reboot
 ```
 
-No registration required! You can start working right after the installation.
+3. Run the script. Provide a key if your license is key-based:
+
+```shell
+python3 ubuntu2cloudlinux.py --key=your_key
+```
+
+If you have an IP-based license, pass the `--byip` option instead:
+
+```shell
+python3 ubuntu2cloudlinux.py --byip
+```
+
+The script will install the CloudLinux Subsystem on your Ubuntu machine. After the installation is complete, reboot your system.
 
 ## Ubuntu2Cloudlinux explained
 
-The `ubuntu2cloudlinux.py` script gives an opportunity to install CloudLinux Subsystem For Ubuntu. It is a simplier script compared to the CLdeploy script for CentOS and AlmaLinux. For example, it doesn't replace the Linux kernel, only adds a dynamic module to it. Here is a list of actions done by the `ubuntu2cloudlinux`:
+The `ubuntu2cloudlinux.py` script installs the CloudLinux Subsystem For Ubuntu.
+It is a simplier script compared to the CLdeploy script for CentOS and AlmaLinux. For example, it doesn't replace the Linux kernel, only adds a dynamic module to it.
+Here is a list of actions that the `ubuntu2cloudlinux` script performs:
 
-* It checks that you are running the latest available version of the `ubuntu2cloudlinux.py script`, and updates itself if necessary.
+* Checks that you are running the latest available version of the `ubuntu2cloudlinux.py script`, and updates itself if necessary.
 * Upgrades all installed packages to the latest versions (unless the `--skip-full-update` option is passed).
-* Adds CloudLinux repositories for Ubuntu and a corresponding gpg key to your system.
+* Registers your system with the CloudLinux Network (CLN) using the provided key or IP address.
+* Adds CloudLinux repositories for Ubuntu and a corresponding GPG key to your system.
 * Installs a minimum set of CloudLinux OS components: lve, kernel module kmodlve-dkms, lve-utils, lve-stats, alt-python.
 * Installs CloudLinux Manager (currently works with cPanel on Ubuntu).
 * Installs the mod_hostinglimits Apache module.
-* Asks you to manually reboot the system to load a new kernel module.
+* Asks you to manually reboot the system to load the new kernel module.
diff --git a/docs/ubuntu/introduction/README.md b/docs/ubuntu/introduction/README.md
@@ -5,14 +5,17 @@
 * [Ubuntu](https://ubuntu.com/) is a registered trademark of Canonical Ltd.
 :::
 
-CloudLinux subsystem on Ubuntu is a scope of deb-packages which allows using CloudLinux features on Ubuntu OS. It is a Stable version of a free extension designed exclusively for Ubuntu® 20.04 LTS users. 
+CloudLinux subsystem on Ubuntu is a scope of deb-packages which allows using CloudLinux features on Ubuntu OS. It is a Stable version of a free extension designed exclusively for Ubuntu® 22.04 LTS users.
 
 ## Supported version of Ubuntu
 
-We support Ubuntu 20.04 LTS.
+We support Ubuntu 22.04 LTS.
 
 ## CloudLinux OS editions comparison
 
+CloudLinux Subsystem for Ubuntu supports the same editions as CloudLinux OS, with some exceptions.
+
+In the table below, a feature marked with "No" for the CloudLinux Subsystem for Ubuntu means that no edition of CloudLinux Subsystem for Ubuntu supports this feature.
 
 |**Features**|**CloudLinux OS Solo**|**CloudLinux OS Admin**|**CloudLinux OS Legacy (Shared)**|**CloudLinux OS Shared Pro**|**<font color="#2c98f0">CloudLinux Subsystem For Ubuntu</font>**|
 |:-:|:-:|:-:|:-:|:-:|:-:|
@@ -38,7 +41,7 @@ We support Ubuntu 20.04 LTS.
 
 \** Limits are disabled by default.
 
-\*** Python/Node.js/Ruby Selectors are available only for cPanel, DirectAdmin servers, and servers with custom panel with own integration.
+\*** Python/Node.js/Ruby Selectors are available only for cPanel, DirectAdmin, and servers with custom panels with own integration.
 
 ## Supported control panels
 
diff --git a/docs/ubuntu/troubleshooting/README.md b/docs/ubuntu/troubleshooting/README.md
@@ -5,41 +5,13 @@
 To troubleshoot and resolve issues, you can use the following log files:
 
 ```
-/var/log/ubuntu2cloudlinux.log - conversion log 
-/var/log/lve-stats.log - lve-stats 
-/var/log/dmesg - kernel module 
+/var/log/ubuntu2cloudlinux.log - conversion log
+/var/log/lve-stats.log - lve-stats
+/var/log/dmesg - kernel module
 ```
 
-## Knows Issues
+## Known issues
 
-1. Please take into account that if one of the [`alt-python37*` packages](/sub-system-ubuntu/troubleshooting/#list-of-alt-python37-packages) is updated, you should execute the following command to ensure the proper functionality of the LVE-stats daemon:
-
-```
-/sbin/service lvestats try-restart
-```
-
-#### List of alt-python37* packages:
-
-* alt-python37
-* alt-python37-raven
-* alt-python37-simplejson
-* alt-python37-sqlalchemy
-* alt-python37-alembic
-* alt-python37-libs
-* alt-python37-markupsafe
-* alt-python37-setuptools
-* alt-python37-contextlib
-* alt-python37-mako
-* alt-python27-cllib
-* alt-python37-prettytable
-* alt-python37-logilab-common
-* alt-python37-jinja2
-* alt-python37-psycopg2
-* alt-sqlite
-
-Behavior like this will be fixed in the upcoming versions.
-
-2. LVE statistics work only with SQLite, other databases (e.g. MySQL, postgreSQL) will be available in the following releases.
-3. `alt-php*-zts` packages are not available yet.
-4. The `tmpreaper package` is used instead of `tmpwatch`.
-5. PNG format for LVE Charts does not work correctly on CloudLinux subsystem on Ubuntu (lvechart utility may produce broken images).
+1. `alt-php*-zts` packages are not available at the moment.
+2. The `tmpreaper package` is used instead of `tmpwatch`.
+3. PNG format for LVE Charts does not work correctly on CloudLinux subsystem on Ubuntu (lvechart utility may produce broken images).
diff --git a/docs/ubuntu/uninstalling/README.md b/docs/ubuntu/uninstalling/README.md
@@ -1,25 +1,28 @@
 # Uninstalling
 
-### Deleting the CloudLinux Subsystem For Ubuntu
+## Deleting the CloudLinux Subsystem For Ubuntu
 
 You can uninstall CloudLinux Subsystem For Ubuntu by running the following commands:
 
-```
+```shell
+# Install Python 3 if you don't have it
 apt install python3
 ```
-```
+
+```shell
 wget https://repo.cloudlinux.com/cloudlinux-ubuntu/sources/cln/ubuntu2cloudlinux.py
 ```
-```
+
+```shell
 python3 ubuntu2cloudlinux.py --uninstall
 ```
-```
+
+```shell
 reboot
 ```
 
+The script will:
 
-In that case the script will:
-
-* Remove the CloudLinux OS components which are installed on your system, choosing from the following list: lve, kmodlve-dkms, lve-utils, lve-stats, lvemanager, cagefs, alt-python, alt-php, db-governor.
+* Remove the CloudLinux OS components which are installed on your system, going over the following list: lve, kmodlve-dkms, lve-utils, lve-stats, lvemanager, cagefs, alt-python, alt-php, db-governor.
 * Remove configs for CloudLinux repositories for Ubuntu.
 * Ask you to check for remaining packages from CloudLinux and manually reboot your system.
