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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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