Child pages
  • How to Update a Percona Installation
Skip to end of metadata
Go to start of metadata

Overview

Warning:

This document describes an unsupported workaround that we do not guarantee will work in the future.

  • After a system administrator performs these steps on a server, it is the system administrator's responsibility to manage and maintain the server's database software.
  • We recommend that only experienced system administrators attempt to perform these steps.
  • We are not responsible for any data loss that this procedure may cause.

If you use the /scripts/rpmup script to upgrade Percona to the latest version with a scheduled cPanel update, the system may remove the libmysqlclient client library and replace it with Percona's libperconaserverclient client library. This action breaks PHP and causes EasyApache to fail.

The system will return an error message that resembles the following example:

 

# php -v
php: error while loading shared libraries: libmysqlclient.so.18: cannot open shared object file: No such file or directory configure: error: Cannot find libmysqlclient under /usr.
Note that the MySQL client library is not bundled anymore!

!! './configure [snip] failed with exit code '256' !!

 

To troubleshoot this error, create a symlink and then rebuild PHP. To do this, perform the following steps:

  1. Re-create the symlinks. Run the following commands as the root user via the command line:

    ln -s /usr/lib64/libperconaserverclient.so.18 /usr/lib64/libperconaserverclient.so
    ln -s /usr/lib64/libperconaserverclient.so /usr/lib64/libmysqlclient.so
  2. Run EasyApache in WHM's EasyApache (Apache Update) interface (WHM >> Home >> Software >> EasyApache (Apache Update)) to recompile the PHP binaries.

    Note:

    To access EasyApache from the command line interface, run the /scripts/easyapache script.

Additional information

Percona announced the following change to their binary names:

"In order to comply with Linux distribution packaging standards Percona's version of libmysqlclient has been renamed to libperconaserver. The old name was conflicting with the upstream libmysqlclient. Except for packaging, libmysqlclient and libperconaserverclient of the same version do not have any differences. Users wishing to continue using libmysqlclient will have to install the corresponding package of their distribution, such as mysql-lib for CentOS and libmysqlclient18 for Ubuntu/Debian. Users wishing to build software against libperconaserverclient should install libperconaserverclient-dev package. An old version of Percona-built libmysqlclient will be available for download."


For more information, visit the Percona Website.

Additional documentation