5.6.7.1安装克隆插件

本节介绍如何安装和配置克隆插件。对于远程克隆操作，必须在施主和受主MySQL服务器实例上安装克隆插件。

有关安装或卸载插件的一般信息，请参见第5.6.1节“安装和卸载插件”。

要由服务器使用，插件库文件必须位于MySQL插件目录（由plugin_dir系统变量命名的目录）中。如有必要，请plugin_dir在服务器启动时设置值， 以告知服务器插件目录位置。

插件库文件的基本名称为 mysql_clone.so。文件名后缀因平台.so而异（例如，对于Unix和类似Unix的系统，.dll对于Windows）。

要在服务器启动时加载插件，请使用--plugin-load-add选项来命名包含该插件 的库文件。使用这种插件加载方法，每次服务器启动时都必须给出该选项。例如，将这些行放在my.cnf 文件中，并.so根据需要调整平台的后缀：

[mysqld]
plugin-load-add=mysql_clone.so

修改之后my.cnf，重新启动服务器以使新设置生效。

注意

--plugin-load-add在从先前的MySQL版本升级期间重新启动服务器时，无法使用 该选项加载克隆插件。例如，将二进制文件或软件包从MySQL 5.7升级到MySQL 8.0后，尝试重新启动服务器 plugin-load-add=mysql_clone.so 会导致以下错误：[ERROR] [MY-013238] [Server]安装插件’clone’时出错：升级期间无法安装。解决方法是在尝试使用启动服务器之前先升级服务器 plugin-load-add=mysql_clone.so。

另外，要在运行时加载插件，请使用以下语句，并.so根据需要调整平台的后缀：

INSTALL PLUGIN clone SONAME 'mysql_clone.so';

INSTALL PLUGIN加载插件，并将其注册到mysql.plugins 系统表中，以使插件在每次后续的正常服务器启动时都加载，而无需 --plugin-load-add。

要验证插件安装，请检查 INFORMATION_SCHEMA.PLUGINS表或使用以下SHOW PLUGINS语句（请参见第5.6.2节“获取服务器插件信息”）。例如：

mysql> SELECT PLUGIN_NAME, PLUGIN_STATUS
       FROM INFORMATION_SCHEMA.PLUGINS
       WHERE PLUGIN_NAME = 'clone';
+------------------------+---------------+
| PLUGIN_NAME            | PLUGIN_STATUS |
+------------------------+---------------+
| clone                  | ACTIVE        |
+------------------------+---------------+

如果插件未能初始化，请检查服务器错误日志中是否存在克隆或与插件相关的诊断消息。

如果插件先前已注册 INSTALL PLUGIN或已加载 --plugin-load-add，则可以--clone在服务器启动时使用该选项来控制插件激活状态。例如，要在启动时加载插件并防止在运行时将其删除，请使用以下选项：

[mysqld]
plugin-load-add=mysql_clone.so
clone=FORCE_PLUS_PERMANENT

如果要阻止服务器在没有克隆插件的情况下运行，请使用--clone值为 FORCE或 FORCE_PLUS_PERMANENT强制服务器启动失败（如果插件未成功初始化）。

有关插件激活状态的更多信息，请参见 控制插件激活状态。