CloudLinux Isolation Report ​
The Isolation Report says whether this CloudLinux server keeps its hosting accounts apart: every account inside its own LVE, with its resource limits, and inside its own CageFS, unable to see other accounts' files. Where it does not, the report lists what is left and takes the steps the panel can take itself. Available since panel 1.9.0.
Overview ​
URL: /admin/settings/cloudlinux/isolation-report
Open it from Settings > CloudLinux > Isolation Report, below LVE Manager. The entry appears once the CloudLinux module is installed. On a server that does not run CloudLinux, the page says Not a CloudLinux server, and when the server cannot be asked, it says Report unavailable.
Refresh checks the server again. Below the verdict, the page shows the CloudLinux release and edition and when the report was made.
The verdict ​
At the top, the report says either:
- Account isolation is guaranteed
- Account isolation is not guaranteed, with the number of problems found. Work through the steps, then refresh the report.
Steps to full isolation ​
Each problem or warning the panel can say something about becomes a numbered step under Steps to full isolation, problems first. Where the panel can take the step itself, the step has a button, and Run this step now? asks for confirmation first:
- Enable CageFS for them - puts every hosting account that is outside CageFS into it. When an account cannot be changed, the message names it and the panel log holds the reason.
- Install mod_hostinglimits - so the entry process limit also covers CGI scripts on Apache. Since panel 1.9.3, the same click installs the package and loads the module into Apache, and the message says mod_hostinglimits is loaded into Apache. once Apache lists it. When the module cannot be installed or loaded, the message says so and the panel log has the reason. A click shortly after an earlier package install starts nothing and says when you can click again.
- Retry the CageFS set-up - runs the CageFS set-up of the conversion again when it did not finish; see CageFS set-up. It asks its own confirmation, which names any login users it would also put into CageFS.
- Switch to PHP Selector extensions - makes CloudLinux alt-php load the extensions each account chooses in the PHP Selector, instead of the server-wide set.
- Restore default PHP extensions - puts the PHP Selector's default extensions back for the accounts in CageFS that lack them. Since panel 1.9.4; see Default PHP extensions.
A step without a button says what to do instead, for example rebooting into the CloudLinux kernel or renewing the CloudLinux license.
Moving websites to alt-php ​
On a CloudLinux server, websites and hosting plans belong on CloudLinux alt-php. The Move websites to alt-php card counts the ones that are not on it yet and moves them in three steps. Nothing changes on a website until you start the move.
This card is where websites move to alt-php on CloudLinux. The PHP Migration tab of Web Server switches websites between REMI PHP and LSPHP, which CloudLinux websites do not run on, so since panel 1.9.2 the Web Server tabs leave it out on a CloudLinux server.
- Webserver - prepares the web server for alt-php. On Apache, Load mod_lsapi prepares it, and on OpenLiteSpeed, Apply to OpenLiteSpeed does. Both restart the web server after a confirmation. LiteSpeed Enterprise needs no step.
- alt-php versions - a table lists each PHP version in use (Now on), how many Websites and Plans use it, and the alt-php version it Moves to, normally the same release. Choose another version where CloudLinux has none of the same release (No alt-php of this release) or where you want the websites on a newer one. A version that is not installed has an Install button, a version that is installed but not connected yet has a Connect button, and the badge reads Ready once the version can take the websites.
- Move the websites - Move to alt-php, available once the web server step is done, asks for confirmation, then moves every website and hosting plan whose alt-php version is ready. Each website keeps its settings, and the web server reloads.
Since panel 1.9.4, the card also warns before the move when websites would lose PHP extensions they load now: "Websites on version load extensions that alt-php version does not give them: extensions. They run without these after the move." OPcache is a common case. The warning stands next to the version in the table and again in the confirmation of Move to alt-php, and its next step says what to do before the move: add the extensions to the alt-php version's default extensions in LVE Manager, PHP Selector, switch them on in the settings of the alt-php version, or install them on the server when that alt-php version does not ship them. When the lists cannot be compared, the card says so instead of reporting that nothing is lost; refresh the report to try again.
The move runs in the background and the card shows its progress. When it has finished, the card says how many websites and plans moved and how many failed, and lists each website that did not move with the reason. Move the remaining websites runs it again for what is left. Websites on a version whose alt-php is not ready yet stay where they are.
What the report checks ​
Each check is marked OK, Info, Warning, or Problem. A check that names accounts, websites, or processes can be expanded to list them.
| Section | What it shows |
|---|---|
| CloudLinux platform | The state of CloudLinux on this server, its kernel, and its license. |
| Account isolation (CageFS) | The state of CageFS and its mode, the hosting accounts in it, a CageFS set-up that did not finish, and other users in CageFS. |
| Website PHP | How websites run PHP: on Apache, whether Apache has loaded mod_lsapi; and the websites and hosting plans that are not on alt-php yet. |
| CGI scripts | How CGI scripts run. |
| PHP Selector | The state of the PHP Selector. |
| Monitoring | Whether Watchdog is running. |
| Live processes | Account processes running outside their LVE or CageFS when the report was made. |
Account isolation (CageFS) ​
Since panel 1.9.3, a CloudLinux conversion leaves CageFS in Enable All mode, so every hosting account, including one created later, runs inside CageFS. The users the panel runs its own services as, and the administrators' login users, stay outside CageFS and keep sudo. See CageFS for every account.
- Accounts in CageFS lists the hosting accounts outside CageFS, with Enable CageFS for them.
- Other users in CageFS (a warning) lists the users inside CageFS that are not hosting accounts. A system user inside CageFS can stop the service it runs, such as mail delivery, so check each one and take a user that runs a service out of CageFS. This warning does not change the verdict.
Default PHP extensions ​
Since panel 1.9.4, a hosting account that the panel puts into CageFS gets the default alt-php extensions of every installed alt-php version, as the PHP Selector sets them, and keeps the extensions it selected itself. Before, an account that existed before the CloudLinux conversion could come out of it with only a few extensions selected, so its websites failed, for example without mysqli.
The PHP Selector section checks the accounts already in CageFS:
- Default PHP extensions (a warning) counts the hosting accounts in CageFS that lack a default extension, and lists each account with the alt-php version and the extensions it lacks. Restore default PHP extensions names the accounts in its confirmation and warns that an extension an account switched off on purpose is switched on again. Extensions an account added itself are kept. The message says for how many accounts the defaults were restored. One click handles a limited number of accounts; when some are left, the message says how many, and you click the button again for them. Accounts that could not be repaired are named, and the panel log has the reason. When every account has the defaults, the check passes with "Every hosting account in CageFS has the default extensions of each alt-php version."
- Default PHP extensions not installed (a warning) lists the default extensions the PHP Selector selects that an alt-php version does not ship, so no account has them. Install those extensions of that alt-php version on the server, then refresh the report.
- PHP extensions not checked (a warning) names the accounts whose extensions could not be checked, with Restore default PHP extensions, or the alt-php versions that have no default extensions in the PHP Selector. Set the defaults of those versions in LVE Manager, PHP Selector, then refresh the report.
Only hosting accounts are checked; other users in CageFS are left out.
CageFS set-up ​
The conversion sets up CageFS as its last step. Since panel 1.9.3, when that set-up did not finish, the CageFS set-up check says so with the reason, and the set-up is not retried on its own. Retry the CageFS set-up runs it again in the background; refresh the report a few minutes later. While it runs, the check says so and the button is off.
Warning: The retry switches CageFS to Enable All. Every hosting account goes into CageFS, including one you left out on purpose, so take those out again afterwards with the account's Account isolation (CageFS) switch. When the set-up stopped because of login users that are not hosting accounts and that the panel could not tell apart from an administrator's user, the check names them. A retry puts them into CageFS too, and they lose access to the rest of the server, including
sudoandsu. Add a user that must keep that access to thewheelgroup first.
When the check gives a correlation ID, quote it when you contact support.
Health ​
While websites still run PHP outside LVE and CageFS, the Health page raises a critical issue that counts them and links to this report.
The administrator API ​
Since panel 1.9.4, GET /api/admin/cloudlinux/isolation-report returns this report, generated afresh on every call as Refresh does. verdict is guaranteed, not_guaranteed, or not_cloudlinux. Each remaining step names the page action that fixes it; those actions are not on the API.
Related pages ​
- CloudLinux - the conversion and what it brings to the panel.
- LVE Manager - CloudLinux's own interface.
- PHP Versions - the PHP versions installed on the server.