Миграция из одного плагина ключей в другой.

Миграция из плагина ключей в компонент ключей.

Миграция из компонента ключей в плагин ключей.

Для указания исходного плагина ключей и целевого плагина или компонента ключей укажите следующие параметры:

Параметры --keyring-migration-source и --keyring-migration-destination указывают серверу, что он должен работать в режиме миграции ключей. Для операций миграции ключей оба параметра обязательны. Каждый плагин или компонент указывается с использованием имени его библиотечного файла, включая любые платформозависимые расширения, такие как .so или .dll. Источник и назначение должны отличаться, и сервер миграции должен поддерживать их оба.

Для оффлайн-миграции дополнительных параметров миграции ключей не требуется.

Для онлайн-миграции в настоящий момент некоторый работающий сервер использует исходное или целевое хранилище ключей. Для запуска сервера миграции необходимо указать дополнительные параметры миграции ключей, указывающие, как подключиться к работающему серверу. Это необходимо, чтобы сервер миграции мог подключиться к работающему серверу и сказать ему приостановить использование ключей во время операции миграции.

Использование любого из следующих параметров означает онлайн-миграцию:

Возможно, потребуются другие параметры сервера; также могут потребоваться и другие параметры, не относящиеся к keyring. Один из способов указать эти параметры — использовать --defaults-file для указания файла параметров, содержащего необходимые параметры.

Сервер миграции ожидает, что значения параметров имени пути будут полными путями. Относительные имена путей могут быть разрешены не так, как ожидается.

Пользователь, запускающий сервер в режиме миграции ключей, не должен быть системным пользователем root операционной системы, если не указан параметр --user с именем пользователя, отличным от root, для запуска сервера от имени этого пользователя.

Пользователь, от имени которого выполняется сервер в режиме миграции ключей, должен иметь разрешения на чтение и запись любых локальных файлов keyring, таких как файл данных для плагина на основе файла.

Если вы запускаете сервер миграции от имени системной учетной записи, отличной от той, которая обычно используется для запуска MySQL, он может создать каталоги или файлы keyring, недоступные серверу во время обычной работы. Предположим, что mysqld обычно запускается от имени системного пользователя mysql, но вы запускаете сервер миграции, вошедший под учетной записью isabel. Все новые каталоги и файлы, созданные сервером миграции, будут принадлежать пользователю isabel. Последующий запуск завершается ошибкой, когда сервер, запущенный от имени системного пользователя mysql, пытается получить доступ к объектам файловой системы, принадлежащим пользователю isabel.

Чтобы избежать этой проблемы, запустите сервер миграции от имени системного пользователя root и укажите параметр --user=user_name, где user_name — системная учетная запись, обычно используемая для запуска MySQL. В качестве альтернативы после миграции проверьте объекты файловой системы, относящиеся к keyring, и измените их владение и разрешения, если необходимо, с помощью команд chown, chmod или аналогичных команд, чтобы объекты были доступны работающему серверу.

Если работающий сервер использовал исходный хранилище ключей до миграции и должен продолжать его использовать после миграции, его не нужно перезапускать после миграции.

Если работающий сервер использовал целевое хранилище ключей до миграции и должен продолжать его использовать после миграции, его следует перезапустить после миграции для загрузки всех перенесенных ключей в целевое хранилище ключей.

Если работающий сервер использовал исходное хранилище ключей до миграции, но должен использовать целевое хранилище ключей после миграции, его необходимо перенастроить для использования целевого хранилища ключей и перезапустить. В этом случае следует учитывать, что хотя работающий сервер приостанавливается от изменения исходного хранилища ключей во время самой миграции, он не приостанавливается в период между миграцией и последующим перезапуском. Необходимо позаботиться о том, чтобы сервер не изменял исходное хранилище ключей в течение этого интервала, потому что любые такие изменения не будут отражены в целевом хранилище ключей.

Для указания исходного и целевого компонентов хранилища ключей и их расположения, укажите следующие параметры:

Все три параметра обязательны. Каждое имя компонента хранилища ключей — это имя файла библиотеки компонента, указанное без каких-либо платформозависимых расширений, таких как .so или .dll. Например, для использования компонента, для которого файлом библиотеки является component_keyring_file.so, укажите параметр как --source-keyring=component_keyring_file. Исходный и целевой компоненты должны быть разными, и mysql_migrate_keyring должен их оба поддерживать.

Для автономной миграции дополнительных параметров не требуется.

Для онлайн-миграции некоторые работающие серверы в настоящее время используют исходный или целевой хранилище ключей. В этом случае укажите параметр --online-migration, чтобы указать онлайн-миграцию. Кроме того, укажите параметры подключения, указывающие, как подключиться к работающему серверу, чтобы mysql_migrate_keyring мог подключиться к нему и приостановить использование хранилища ключей во время операции миграции.

Параметр --online-migration обычно используется совместно с параметрами подключения, такими как:

Пользователь, вызывающий mysql_migrate_keyring, не должен быть пользователем операционной системы root.

Пользователь, вызывающий mysql_migrate_keyring, должен иметь права чтения и записи во все локальные файлы хранилища ключей, такие как файл данных для плагина на основе файла.

Если вы вызываете mysql_migrate_keyring от имени системной учетной записи, отличной от той, которая обычно используется для запуска MySQL, он может создать каталоги или файлы хранилища ключей, недоступные для сервера во время обычной работы. Предположим, что mysqld обычно запускается от имени пользователя операционной системы mysql, но вы вызываете mysql_migrate_keyring, будучи авторизованным как isabel. Любые новые каталоги или файлы, созданные mysql_migrate_keyring, будут принадлежать пользователю isabel. Последующий запуск завершается ошибкой, когда сервер, запущенный как пользователь операционной системы mysql, пытается получить доступ к объектам файловой системы, принадлежащим isabel.

Чтобы избежать этой проблемы, вызовите mysql_migrate_keyring как пользователя операционной системы mysql. В качестве альтернативы, после миграции проверьте объекты файловой системы, связанные с хранилищем ключей, и измените их владение и разрешения при необходимости, используя команды chown, chmod или аналогичные команды, чтобы объекты были доступны для работающего сервера.

Если работающий сервер использовал исходный хранилище ключей до миграции и должен продолжать его использовать после миграции, его не нужно перезапускать после миграции.

Если работающий сервер использовал целевое хранилище ключей до миграции и должен продолжать его использовать после миграции, его следует перезапустить после миграции для загрузки всех перенесенных ключей в целевое хранилище ключей.

Если работающий сервер использовал исходное хранилище ключей до миграции, но должен использовать целевое хранилище ключей после миграции, его необходимо переконфигурировать для использования целевого хранилища ключей и перезапустить. В этом случае следует учитывать, что, хотя работающий сервер приостановлен от изменения исходного хранилища ключей во время самой миграции, он не приостановлен в период между миграцией и последующим перезапуском. Следует позаботиться о том, чтобы сервер не изменял исходное хранилище ключей в этот период, так как любые такие изменения не будут отражены в целевом хранилище ключей.