7.6.7.1 安装克隆插件
本节描述了如何安装和配置克隆插件。对于远程克隆操作,克隆插件必须在捐赠服务器实例和接收服务器实例上安装。
关于安装或卸载插件的总体信息,请参见第7.6.1节,“安装和卸载插件”。
要使插件可供服务器使用,插件库文件必须位于 MySQL 插件目录(由plugin_dir
系统变量指定的目录)。如果必要,请在服务器启动时设置plugin_dir
的值,以告知服务器插件目录位置。
插件库文件的基本名称是mysql_clone.so
。文件名后缀因平台而异(例如,Unix 和 Unix 类似系统为.so
,Windows 为.dll
)。
要在服务器启动时加载插件,请使用--plugin-load-add
选项指定包含该插件的库文件。使用这个插件加载方法,必须每次服务器启动时给出该选项。例如,在您的my.cnf
文件中添加这些行,根据平台调整插件库文件名后缀(插件库文件名后缀取决于平台,常见的后缀为 Unix 和 Unix 类似系统的.so
,Windows 的.dll
)。
[mysqld]
plugin-load-add=mysql_clone.so
修改my.cnf
后,重启服务器以使新设置生效。
在从前版本MySQL升级到当前版本时,不能使用--plugin-load-add
选项来加载克隆插件。在这种情况下,尝试重启服务器时,会出现错误[ERROR] [MY-013238] [Server] Error installing plugin 'clone': Cannot install during upgrade。为了避免这个问题,在升级服务器前先启动服务器。
或者,可以在运行时使用以下语句,根据平台调整.so
后缀:
INSTALL PLUGIN clone SONAME 'mysql_clone.so';
INSTALL PLUGIN
加载插件,并将其注册到mysql.plugins
系统表中,以便在后续正常服务器启动时不需要--plugin-load-add
。
验证插件安装,查看信息架构PLUGINS
表或使用SHOW PLUGINS
语句(见第7.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
强制服务器启动失败,如果插件初始化不成功。
关于插件激活状态的更多信息,请见控制插件激活状态。