Merge pull request #207 from annkots/master

TCR-525 CL Documentation reshuffle iteration2

Author: annkots

docs/.vuepress/config-client/documents.ts

@@ -2,18 +2,13 @@ export default [
     {
         title: "Introduction to Cloudlinux OS",
         description: "Introduction to CloudLinux OS editions and their description.",
-        link: "/introduction/",
+        link: "/introduction/cloudlinux-os-editions/",
     },
     {
         title: "CloudLinux OS",
-        description: "Optimizes shared hosting environments by enhancing stability, security, and performance through user isolation and efficient resource management. Featuring tools like LVE resource limits, CageFS, and multiple language selectors, it empowers hosting providers to offer superior services. The CloudLinux OS Shared Pro edition further extends functionality with even more valuable features.",
+        description: "Optimizes shared hosting environments by enhancing stability, security, and performance through user isolation and efficient resource management. Featuring tools like LVE resource limits, CageFS, and multiple language selectors, it empowers hosting providers to offer superior services.",
         link: "/cloudlinuxos/cloudlinux_installation/",
     },
-    {
-        title: "Apache2Nginx (BETA)",
-        description: "Apache2Nginx sets up Nginx hosting with .htaccess support.",
-        link: "/cloudlinuxos/apache2nginx/",
-    },
     {
         title: "AccelerateWP",
         description: "AccelerateWP carries a suite of optimization features that can be enabled and automatically configured for the end user's site.",
@@ -24,16 +19,6 @@ export default [
         description: "CLN is a CloudLinux Network designed to easily manage your licenses of CloudLinux products and services by means of a user-friendly interface.",
         link: "/cln/introduction/",
     },
-    {
-        title: "CloudLinux Solo",
-        description: "CloudLinux OS Solo is designed for VPS or dedicated servers with a single hosting account for any number of websites.",
-        link: "/solo/introduction/",
-    },
-    {
-        title: "CloudLinux OS Admin",
-        description: "CloudLinux OS Admin is designed for shared hosting providers and allows flawless migration of big shared hosting customers to individual VPS with the same CloudLinux features as on shared hosting.",
-        link: "/admin/description/",
-    },
     {
         title: "CloudLinux Subsystem For Ubuntu",
         description: "CloudLinux subsystem on Ubuntu is a scope of deb-packages that allows using CloudLinux features on Ubuntu OS.",

docs/.vuepress/config-client/sidebar.ts

@@ -12,31 +12,9 @@ export default {
         {
             collapsable: false,
             children: [
-                "/introduction/"
-            ]
-        },
-    ],
-    '/admin/': [
-        {
-            collapsable: false,
-            children: [
-            "/admin/description/",
-            "/admin/installation/",
-            "/admin/components/",
-            "/admin/faq/"
-            ]
-        },
-    ],
-    '/solo/': [
-        {
-            collapsable: false,
-            children: [
-            "/solo/introduction/",
-            "/solo/installation/",
-            "/solo/activation/",
-            "/solo/administration/",
-            "/solo/manager/",
-            "/solo/faq/"
+                "/introduction/cloudlinux-os-editions/",
+                "/introduction/solo/",
+                "/introduction/admin/"
             ]
         },
     ],

docs/.vuepress/routes.json

@@ -54,5 +54,13 @@
     "/shared-pro/": "/cloudlinuxos/shared-pro/",
     "/cloudlinuxos-pro/introduction/":"/cloudlinuxos/shared-pro/#introduction",
     "/shared-pro/accelerate-wp": "/cloudlinuxos/shared-pro/#acceleratewp",
-    "/cloudlinuxos/shared-pro/accelerate-wp/": "/cloudlinuxos/shared-pro/#acceleratewp"
+    "/cloudlinuxos/shared-pro/accelerate-wp/": "/cloudlinuxos/shared-pro/#acceleratewp",
+    "/solo/introduction/":"/introduction/solo/",
+    "/solo/activation/":"/introduction/solo/#license-activation",
+    "/solo/faq/":"/introduction/solo/#faq",
+    "/admin/description/":"/introduction/admin/",
+    "/admin/installation/":"/introduction/admin/#licensing",
+    "/admin/components/":"/introduction/admin/#components",
+    "/admin/faq/":"/introduction/admin/#faq"
+
 }

docs/admin/.DS_Store

@@ -36,7 +36,9 @@ There are some incompatible devices with **CL6**:
 With RHEL8 (**CloudLinux OS 8/CloudLinux OS 7 Hybrid**), some devices are no longer supported.
 You can check the entire list here: [Hardware enablement considerations in adopting RHEL 8](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/considerations_in_adopting_rhel_8/hardware-enablement_considerations-in-adopting-rhel-8#removed-hardware-support_hardware-enablement)
 
-## Software Compatibility
+## Software Compatibility 
+
+CloudLinux OS is designed to maintain full binary compatibility with CentOS and Red Hat Enterprise Linux (RHEL). This means that any software, applications, or scripts that run on CentOS or RHEL can run on CloudLinux OS without modification. The operating system ensures broad compatibility with the vast ecosystem of Linux software, providing a seamless and stable environment for hosting providers and users transitioning from other enterprise Linux distributions. This compatibility extends to package management, system libraries, and core functionalities, making CloudLinux OS a reliable drop-in replacement that supports the same software stack as its counterparts.
 
 ### ZFS
 
@@ -48,14 +50,15 @@ CloudLinux 8+ provides limited support for ZFS, to the same degree as other RHEL
 1.  Because ZFS is known to have some lag in adapting to kernel changes, we consider it the customer's responsibility to test the upgradeability of the environment to the most recent kernels and ZFS versions before upgrading the entire fleet.
 1.  Most CloudLinux features, like CageFS, should work fine with ZFS-backed mount points, and if not, we will try our best to provide fixes according to severity and demand
 
-CloudLinux features known to not work with ZFS:
+:::tip CloudLinux features known to not work with ZFS:
 
-1.  LVE IO Limits (as well as generic cgroups limits) don't work because the ZFS data path bypasses some of the kernel's internals. See related upstream tickets [1](https://github.com/canonical/lxd/issues/7627#issuecomment-671107839), [2](https://github.com/openzfs/zfs/issues/4275#issuecomment-1137332006), [3](https://github.com/openzfs/zfs/issues/1952#issuecomment-148471131). There is also an [ongoing attempt](https://github.com/openzfs/zfs/pull/16205) to implement per-dataset IO limits on the ZFS side.
+LVE IO Limits (as well as generic cgroups limits) don't work because the ZFS data path bypasses some of the kernel's internals. See related upstream tickets [1](https://github.com/canonical/lxd/issues/7627#issuecomment-671107839), [2](https://github.com/openzfs/zfs/issues/4275#issuecomment-1137332006), [3](https://github.com/openzfs/zfs/issues/1952#issuecomment-148471131). There is also an [ongoing attempt](https://github.com/openzfs/zfs/pull/16205) to implement per-dataset IO limits on the ZFS side. 
+:::
 
 
 ## Getting License
 
-You will need a valid activation key - trial or paid - to be able to use your CloudLinux OS Solo server.
+You will need a valid activation key - trial or paid - to be able to use your CloudLinux OS server.
 
 ### Getting Trial License
 
@@ -78,7 +81,6 @@ To get the activation key:
 
 You will get a key that looks like: `12314-d34463a182fede4f4d7e140f1841bcf2`.
 
-
 ## Converting existing servers
 
 Sometimes it is required to convert already existing servers with **`CentOS`** or **`AlmaLinux`** and make them **`CloudLinux OS`**.
@@ -97,13 +99,11 @@ Currently supported OS for conversion:
 * AlmaLinux OS 8, AlmaLinux OS 9
 * RockyLinux (installation only, no uninstall option)
 
-
 :::warning Unsupported OS for conversion:
 * CentOS 8
 * CentOS Stream
 :::
 
-
 Supported control panels:
 * cPanel ([Documentation](https://docs.cpanel.net/installation-guide/system-requirements-cloudlinux/))
 * Plesk
@@ -112,6 +112,9 @@ Supported control panels:
 * InterWorx ([Documentation](https://appendix.interworx.com/current/nodeworx/plugins/install-use-cloudlinux-plugin-interworx.html))
 * Webuzo ([Documentation](https://webuzo.com/docs/installing-webuzo/install-cloudlinux-os/))
 
+:::warning Warning:
+CloudLinux 9 does not support Plesk. 
+:::
 
 :::warning Other control panels:
 Control panels not mentioned in the list of supported panels have native integration or integration done by the developer of the panel.

docs/admin/components/README.md

@@ -0,0 +1,59 @@
+# CloudLinux OS Admin Introduction
+
+## Description
+
+CloudLinux OS Admin is designed for shared hosting providers who want to flawlessly migrate their 
+big shared hosting customer to individual VPS with same CloudLinux features as on Shared hosting. 
+At the same time you will be able to separate such a user's websites if necessary and isolate them 
+with CageFS for efficient and extra security.
+Also it may be suitable for a little server with less than 5 customers on it.
+
+Most of the features of CloudLinux OS Legacy (Shared) are available in this edition, with a small differences:
+
+- lve limits are set to unlimited by default (can be changed in CloudLinux Manager at any time)
+- MySQL Governor is not available in this edition
+- the license itself does not allow more than 5 users to be hosted on server.
+
+:::tip Note
+The CloudLinux OS Admin plan does not include the MySQL Governor
+:::
+
+## Components
+
+CloudLinux OS Admin is very close to the regular CloudLinux Legacy (Shared) edition, which means that 
+99% of components described in this documentations are available for CloudLinux OS Admin.
+
+The exclusions are:
+
+ - [MySQL Governor](/cloudlinuxos/control_panel_integration/#mysql-governor) is not available
+ - [X-Ray](/cloudlinuxos/shared-pro/#x-ray) is available like with CloudLinux Shared Pro
+ - [Accelerate WP](/cloudlinuxos/shared-pro/#acceleratewp) is available like with CloudLinux Shared Pro
+
+The rest of the components are similar to CloudLinux OS Legacy (Shared).  
+
+## Licensing 
+
+### Installation process
+
+CloudLinux OS Admin installation process is the same as for other editions – use the [installation guide](/cloudlinuxos/cloudlinux_installation) for detailed instructions. The only difference is to purchase a CloudLinux OS Admin license from [cln.cloudlinux.com](https://cln.cloudlinux.com).
+
+:::tip Note
+The CloudLinux OS Admin can be installed and compatible only with AlmaLinux OS 8+.
+:::
+
+### Switch license
+
+You can convert your existing CloudLinux OS Solo installation to CloudLinux OS Admin.
+
+1. Obtain new key from [CLN](https://cln.cloudlinux.com)
+2. Run `rhnreg_ks --force --activationkey=<new_key>`
+
+You can pass `--migrate-silently` argument to skip confirmation.
+
+## FAQ
+
+**Q**: *Is it possible to convert my existing CloudLinux OS Legacy (Shared) server into CloudLinux OS Admin?*<br>
+**A**: Yes, for CloudLinux 8 and higher it is possible to convert CloudLinux OS Legacy (Shared) to any other edition like CloudLinux OS Admin, Solo, Shared Pro. For CloudLinux 7 it is only possible to convert it into Shared Pro.
+
+**Q**: *Is Centralized Monitoring supported on CloudLinux OS Admin?*<br>
+**A**: No, Centralized Monitoring only works with CloudLinux OS Shared Pro license.