Перейти к основному содержимому

Откат

Данный раздел рассматривает процесс отката установки новой версии СУБД Pangolin и восстановления предыдущей установленной версии.

Сведения

Процесс отката/восстановления встроен в процесс автоматизированного обновления. Отдельный запуск скрипта отката не предусмотрен.

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

Содержание​

Описание​

Внимание!

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

Для определения необходимости восстановления СУБД к исходному состоянию, необходимо изучить лог.

  1. Определите причину падения. Поиск падения осуществляется по ключевым словам в логе, таким как: ['failed!', 'failed: true', 'fatal:'].

  2. Локализуйте место падения по названию задачи: TASK [print msg ERROR (update_errors)].

    Пример сообщения о падении

    ansible_facts:
    update_errors:
        aggregate: true
        components:
            finally: false
            pangolin_auth_reencrypt: false
            pangolin_backup_tools: false
            pangolin_certs_rotate: false
            pangolin_checks: false
            pangolin_configuration: false
            pangolin_dbms: false
            pangolin_diagnostic_tool: false
            pangolin_manager: false
            pangolin_pooler: true
            pangolin_security_utilities: false
            pangolin_tuner: false
        hosts:
            arbiter: false
            master: true
            replica: false
        types:
            pangolin_auth_reencrypt:
                main: false
            pangolin_backup_tools:
                main: false
            pangolin_certs_rotate:
                main: false
            pangolin_configuration:
                main: false
            pangolin_dbms:
                major_main_migrate_master_db: false
                major_main_migrate_replica_db: false
                major_main_start_after_migrate_db: false
                major_post: false
                major_pre: false
                minor_after_first_db_started: false
                minor_before_bin_updated: false
                minor_before_first_db_started: false
                minor_before_first_switchover: false
                minor_before_inplace_upgrade: false
                minor_before_second_switchover: false
            pangolin_diagnostic_tool:
                main: false
            pangolin_manager:
                main: false
            pangolin_security_utilities:
                main: false
            pangolin_tuner:
                main: false

    где:

    • components - информация о том, на каком этапе упало обновление;
    • hosts - информация о том, на каком из хостов возникла ошибка;
    • types - информация о типе ошибки.

    Если ошибка произошла при работе механизма обновления, то ключ aggregate должен иметь значение true. В секции components только один ключ должен иметь значение true - это и будет означать место падения. types может быть не определен.

  3. Более детальное объяснение можно найти по названию задачи: TASK [print msg ERROR about fail component]. Пример развернутого сообщения об ошибке

         msg: PANGOLIN_INSTALLER.FAIL__E05008:Обнаружена ошибка при настройке компонента pangolin-pooler.__PANGOLIN_INSTALLER.FAIL

Возможные варианты ошибок падения при обновлении:

«FAIL__E03099:В процессе обновления системных каталогов возникли ошибки. Процесс дальнейшего обновления остановлен. Автоматическое восстановление невозможно. Необходимо произвести анализ состояния стенда вручную и восстановить его к исходному состоянию или дообновить.FAIL;
«FAIL__E05002:В процессе обновления возникла ошибка. Восстановление СУБД для данного типа ошибки недоступно. Ознакомьтесь с логами.FAIL»;
«FAIL__E03098:В процессе обновления системных каталогов возникли ошибки. Процесс дальнейшего обновления остановлен. Будет запущено автоматическое восстановление.FAIL»;
«FAIL__E03100:В процессе синхронизации узлов кластера возникли ошибки. Процесс дальнейшего обновления остановлен. Автоматическое восстановление невозможно. Необходимо произвести анализ состояния стенда вручную и восстановить его к исходному состоянию или дообновить.FAIL»;
«FAIL__E03103:В процессе запуска лидирующего узла возникли ошибки. Не удалось получить корректный статус роли. Процесс дальнейшего обновления остановлен. Автоматическое восстановление невозможно. Необходимо произвести анализ состояния стенда вручную и восстановить его к исходному состоянию или дообновить.FAIL»;
«FAIL__E03103:В процессе запуска лидирующего узла возникли ошибки. Не удалось получить корректный статус роли. Процесс дальнейшего обновления остановлен. Автоматическое восстановление невозможно. Необходимо произвести анализ состояния стенда вручную и восстановить его к исходному состоянию или дообновить.FAIL»;
«FAIL__E05006:Не удалось выполнить восстановление версии из локальной резервной копии.FAIL»;
«FAIL__E05007:В процессе сбора необходимой для старта обновления СУБД информации произошла ошибка. СУБД находится в исходном состоянии, восстановление не требуется.FAIL»;
«FAIL__E05010:Обнаружена ошибка в процессе подготовки перед обновлением СУБД Pangolin.FAIL»
«FAIL__E05012:Обновление невозможно продолжить, так как не удается остановить, работающую утилиту перекодирования паролей pangolin-auth-reencrypt.FAIL».

  • Восстанавливать СУБД нужно, если последней строкой записи является:

    • «В процессе обновления возникла ошибка»;
    • «Восстановление СУБД Pangolin в автоматическом режиме недоступно для этого типа ошибки»;
    • «Автоматическое восстановление СУБД отключено»;
    • «Восстановление СУБД Pangolin запущено»;

  • Восстанавливать СУБД не нужно, если последней строкой записи является:

    • «Обновление СУБД Pangolin успешно завершено»;
    • «Восстановление СУБД Pangolin успешно завершено».

Откат вручную к исходной версии и состоянию кластера​

Восстановление после неудачного обновления с переносом данных​

Восстановление после неудачного обновления с переносом данных.

Восстановление после неудачного обновления исполняемых файлов​

Восстановление после неудачного обновления исполняемых файлов.