Skip to content

AWP-325: Update doc with AWP support for Plesk. #227

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Feb 9, 2023
Merged

AWP-325: Update doc with AWP support for Plesk. #227

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ea0a8a5
AWP-325: Update doc with AWP support for Plesk.
Jan 27, 2023
b6995f4
small fixes
Jan 27, 2023
30340c3
fix comments
Feb 7, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 23 additions & 29 deletions docs/cloudlinux-os-plus/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -412,8 +412,7 @@ If you'd like to try Smart Advice and AccelerateWP you should participate in the

#### Requirements

* CloudLinux OS Shared Pro
* cPanel Control Panel
* CloudLinux OS Shared Pro or CloudLinux OS Solo
* alt-php-xray > 0.5-1 version
* lve-utils > 6.3.2-1 version
* lvemanager > 7.6.1-1 version
Expand Down Expand Up @@ -1455,13 +1454,13 @@ This feature is free of charge only during the beta testing period. Afterwards i

* the websites must be served with Apache web server;
* the websites must use one of the following PHP handlers:
* [php-fpm](https://blog.cpanel.com/how-to-use-php-fpm-with-cpanel/)
* php-fpm
* [lsapi](/cloudlinux_os_components/#apache-mod-lsapi-pro)

### Limitations
There are the following requirements to use AccelerateWP:
* the server must have CloudLinux Shared PRO license;
* the server must be powered with cPanel.
* the server must be powered with cPanel or Plesk.


### Administrator interface
Expand All @@ -1474,7 +1473,7 @@ To provide best experience,
![](/images/AWPAdmin.png)

By toggling the `Enable AccelerateWP for all users` an administrator provides end-users with AccelerateWP feature.
Once the feature suite is enabled by administrator, end-users will see an AccelerateWP tab in their cPanel interface and be able to activate the optimization feature.
Once the feature suite is enabled by administrator, end-users will see an AccelerateWP tab in their control panel interface and be able to activate the optimization feature.

#### Suites usage statistics
Once at least one feature suite is enabled, the AccelerateWP usage statistics is shown.
Expand Down Expand Up @@ -1566,7 +1565,7 @@ If you would like to stop using AccelerateWP, toggle the `Enable AccelerateWP fo
![](/images/AWPDisable.png)

This operation will:
* disable AccelerateWP tab in users' cPanel interface
* disable AccelerateWP tab in users' control panel interface
* disable all AccelerateWP optimization suites
* deactivate all optimization features for all users

Expand All @@ -1583,21 +1582,14 @@ In case if AccelerateWP Premium is active, the auxiliary monitoring daemon `clwp
### FAQ

#### With which panel can I use AccelerateWP?
Currently AccelerateWP is compatible with cPanel only.
Currently AccelerateWP is compatible with cPanel and Plesk.

If you are interested in supporting Plesk or DirectAdmin control panels, please record your demand on our feature portal respectively:
* [AccelerateWP for Plesk](https://features.cloudlinux.com/c/13-acceleratewp-for-plesk?utm_medium=social&utm_source=portal_share)
* [AccelerateWP for DirectAdmin](https://features.cloudlinux.com/c/15-acceleratewp-for-directadmin?utm_medium=social&utm_source=portal_share)

#### Does WP Accelerate tool support the DirectAdmin control panel? Do you plan to integrate it with Plesk?
Currently AccelerateWP is compatible with cPanel only.
If you are interested in supporting DirectAdmin control panel, please record your demand on our feature portal:

If you are interested in supporting Plesk or DirectAdmin control panels, please record your demand on our feature portal respectively:
* [AccelerateWP for Plesk](https://features.cloudlinux.com/c/13-acceleratewp-for-plesk?utm_medium=social&utm_source=portal_share)
* [AccelerateWP for DirectAdmin](https://features.cloudlinux.com/c/15-acceleratewp-for-directadmin?utm_medium=social&utm_source=portal_share)

#### Is it possible to use AccelerateWP on a non-control panel server?
No, AccelerateWP is compatible with cPanel only.
No, AccelerateWP is compatible with cPanel and Plesk.

#### Do you plan to enable support of Nginx server?
This is a part of our very long term plans, thus not expected in the nearest future.
Expand All @@ -1624,7 +1616,7 @@ Check daemon status using `service clwpos_monitoring status` and its main log: `
In order to make use of AccelerateWP Premium Object Caching feature, the loaded Redis extension is required for the end-user's website.
End-users will not be able to activate the Object Caching feature until Redis extension configuration is incomplete.

Corresponding incompatibility warning will be displayed in cPanel User interface:
Corresponding incompatibility warning will be displayed in control panel's User interface:

![](/images/AWPNoRedis.png)

Expand All @@ -1634,7 +1626,7 @@ The Redis extensions are configured for all installed and supported PHP versions

or you can trigger the utility manually:
```
/usr/sbin/enable_redis_for_ea_php
/usr/sbin/enable_redis_for_panel_php
```

All errors will be displayed in standard output and logged into `/var/log/clwpos/main.log`.
Expand All @@ -1656,7 +1648,7 @@ All errors will be displayed in standard output and logged into `/var/log/clwpos
rpm -q ea-php74-php-redis
yum install ea-php74-php-redis
```
8. Check Redis `ini` file is present by running the following command:
2. Check Redis `ini` file is present by running the following command:
```
ls /opt/cpanel/ea-phpXY/root/etc/php.d/ | grep 50-redis
```
Expand All @@ -1665,7 +1657,7 @@ All errors will be displayed in standard output and logged into `/var/log/clwpos
ls /opt/cpanel/ea-php74/root/etc/php.d/ | grep 50-redis
```
Try reinstalling the package if `ini` file is missing.
13. Make sure Redis module is loaded under specific user by running the following command:
3. Make sure Redis module is loaded under specific user by running the following command:
```
su -c "php -m | grep redis" <username>
```
Expand All @@ -1682,24 +1674,26 @@ All errors will be displayed in standard output and logged into `/var/log/clwpos
ls /opt/alt/php74/usr/lib64/php/modules | grep redis.so
redis.so
```
6. If the Redis module is missing:
7. install the `alt-phpXY-pecl-ext` package manually
8. run the Redis configuration script `/usr/share/cloudlinux/wpos/enable_redis_for_alt_php.py`
2. If the Redis module is missing:

a. Install the `alt-phpXY-pecl-ext` package manually
b. Run the Redis configuration script `/usr/share/cloudlinux/wpos/enable_redis_for_alt_php.py`

All errors will be displayed in standard output and logged into `/var/log/clwpos/main.log`.
10. If the Redis module is present for a particular php version, but the incompatibility issue persists, re-check the following:
11. make sure the Redis module is loaded under user:
All errors will be displayed in standard output and logged into `/var/log/clwpos/main.log`.
3. If the Redis module is present for a particular php version, but the incompatibility issue persists, re-check the following:

a. Make sure the Redis module is loaded under user:
```
su -c "php -m | grep redis" <username>
```
13. check the required extensions are enabled in `php.ini`:
b. Check the required extensions are enabled in `php.ini`:
```
cat /opt/alt/phpXY/etc/php.ini | grep redis.so
cat /opt/alt/phpXY/etc/php.ini | grep json.so
cat /opt/alt/phpXY/etc/php.ini | grep igbinary.so
```

Enable missing extensions manually.
c. Enable missing extensions manually.


#### End-users of AccelerateWP encounter PHP-related issues during feature activation
Expand All @@ -1709,7 +1703,7 @@ End-users may encounter PHP-related errors while activating the AccelerateWP fea

The general examples of possible reasons are:
* broken PHP binaries
* missed PHP files
* missing PHP files
* etc.

To check that this issue is caused by PHP itself, call any PHP command, for example:
Expand Down