Upgrading from plugins to components¶
The following plugins have changed:
| Plugin | 8.0 information | 8.4 changes | Notes |
|---|---|---|---|
keyring_vault |
Only available as a plugin | component_keyring_vault |
A manual upgrade path is required. For example, the plugin configuration file, specified by the keyring_vault_config system variable, must be transformed to a JSON format for the component_keyring_vault.cnf. |
audit_log |
Only available as a plugin | removed | Recommended that you use the component_audit_log_filter. |
audit_log_filter |
Only available as a plugin | component_audit_log_filter |
Migrate the plugin to the component in 8.0 before the upgrade to 8.4. |
data_masking |
Available as a plugin and component | component_masking_functions |
Migrate the plugin to the component in 8.0 before the upgrade to 8.4 |
binlog_utils_udf user defined functions |
Only available as plugin. Users must install the plugin and then run CREATE FUNCTION ... SONAME... |
component_binlog_utils_udf |
Run INSTALL COMPONENT and all functions are registered automatically. |
percona-udf user defined functions |
Must create individual functions with CREATE FUNCTION ... SONAME .... |
component_percona_udf |
Run INSTALL COMPONENT and all functions are registered automatically. Can still use CREATE FUNCTION ... SONAME ... if needed. |
We recommend if you use a plugin and the feature also available a component, switch to the component in 8.0 series before upgrading to 8.4.
Transition from a plugin to a component¶
The operation to transition from a plugin to a component can be complicated. You should plan for downtime while you plan and test each step in the procedure.
Before you start, review the differences between the plugin and the component. A plugin configuration has plugin-specific system variables and uses the --early-plugin-load option. A component has a configuration file and loads using a manifest.
-
Setup the component’s configuration file.
-
Use the manifest to load the component.
-
Confirm that the component works. Run queries or other operations and test the component in your environment.
-
After confirmation, remove the plugin.
Some plugins may require more configuration and setup during the transition to a component. For those plugins, you may have the following scenario:
-
Test the plugin in 8.0.
-
Stop the service
-
Upgrade the packages to 8.4
-
Review and edit configurations, as needed
-
Start 8.4
-
Test the component in 8.4
Get expert help¶
If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.