Поддержка dist-upgrade

Начиная с Plesk 12.5, стало возможным обновлять операционную систему на сервере Plesk. В Plesk поддерживаются следующие варианты обновлений с помощью команды dist-upgrade:

• С Debian 6 на Debian 7
• С Debian 7 на Debian 8
• С Ubuntu 12.04 на Ubuntu 14.04

Предупреждение. Если ваш сервер Plesk работает на выпуске Linux, отличном от Debian 6 или 7 или Ubuntu 12.04, не пытайтесь обновить операционную систему. Такие варианты обновлений не поддерживаются компанией Odin, попытка обновления может уничтожить вашу установку Plesk.

Предупреждение. Внимательно прочитайте инструкции и соблюдайте их неукоснительно. Нарушение инструкций может привести к прекращению работы Plesk и его служб.

Чтобы выполнить обновление с помощью команды dist-upgrade, выполните следующие действия:

1. До начала обновления с помощью команды dist-upgrade, обязательно прочитайте о потенциальных проблемах, с которыми вы можете столкнуться:
   • Если вы выполняете обновление с Debian 6, читайте здесь: https://www.debian.org/releases/wheezy/amd64/release-notes/ch-upgrading.en.html#trouble.
   • Если вы выполняете обновление с Debian 7, читайте здесь: https://www.debian.org/releases/stable/i386/release-notes/ch-upgrading.en.html#trouble.
2. Запустите скрипт проверки продукта перед обновлением. Скрипт проверки продукта перед обновлением имеет название distupgrade.helper.<ОС.старая-ОС.новая>_pre.sh, он расположен в папке /usr/local/psa/bin.
3. Выполните команду dist-upgrade в соответствии с документацией к операционной системе:
   • Debian 6: Следуйте этим инструкциям: http://www.debian.org/releases/wheezy/i386/release-notes/ch-upgrading.html.
   • Debian 7: Следуйте этим инструкциям: https://www.debian.org/releases/jessie/i386/release-notes/ch-upgrading.en.html
   • Ubuntu 12.04: Используйте инструмент do-release-upgrade, как описано здесь: https://help.ubuntu.com/14.04/serverguide/installing-upgrading.html
4. Запустите скрипт проверки продукта после обновления. Скрипт проверки продукта после обновления имеет название distupgrade.helper.<ОС.старая-ОС.новая>_post.sh, он расположен в папке /usr/local/psa/bin.

После окончания работы скрипта проверки, Plesk должен работать стабильно. Подробную информацию об обновлении можно посмотреть в журнале обновления /var/log/plesk/install/plesk-distupgrade.log.

Восстановление после неудачного запуска команды dist-upgrade

Для восстановления после неудачного запуска команды dist-upgrade, выполните следующие действия:

Проверьте наличие системных пакетов в обновлении

1. Проверьте, чтобы и /etc/apt/sources.list, и хранилища в /etc/apt/sources.list.d/ были переключены на новый выпуск ОС (т. е. на "jessie" для Debian 8, "wheezy" для Debian 7 и "trusty" для Ubuntu 14).
2. Выполните команды apt-get update, apt-get upgrade и apt-get dist-upgrade. Если нет пакетов, нуждающихся в обновлении, значит все обновления уже установлены. В противном случае необходимо обновить пакеты. Подробности смотрите в разделе Обновление пакетов далее.

Проверка наличия пакетов Plesk в обновлении

1. Просмотрите список установленных пакетов. Выполните команду dpkg -l | less. У пакетов Plesk обычно имеются следующие префиксы и суффиксы: "plesk-", "psa" или "sw-". Убедитесь в том, что версия всех пакетов Plesk содержит название ОС, до которой вы обновляетесь (например, "debian8", если вы обновляетесь с Debian 7).
2. Если версия одного или нескольких пакетов Plesk содержит название ОС, с которой вы обновляетесь (например, "debian6" если вы обновляетесь с Debian 6), эти пакеты нужно обновить. Подробности смотрите в разделе Обновление пакетов далее.

Обновление пакетов

1. Включите хранилища Plesk.
   1. Выполните команду plesk-installer --skip-cleanup (добавьте другие опции при необходимости).
   2. Выберите установленную в настоящий момент версию Plesk, например, 12.5.30.
   3. Дождитесь загрузки списка компонентов, затем отмените установку.
   4. Будет создан файл /etc/apt/sources.list.d/50sw_autoinstaller.list.
2. Измените хранилища apt (/etc/apt/sources.list и /etc/apt/sources.list.d/*.list), заменив кодовое название ОС новым (а именно: "precise" замените на "trusty", "squeeze" - на "wheezy", а "wheezy" - на "jessie").
3. Обновите пакеты.
   1. Выполните команду apt-get update.
   2. Выполните команду apt-get upgrade.
   3. Выполните команду apt-get dist-upgrade.
   4. Если установка пакетов не удалась, выполните команду apt-get install -f, чтобы перенастроить пакеты, которые не удалось установить, исправьте ошибки и повторите попытку.

Обновление компонентов Plesk

1. После обновления пакетов еще раз запустите установщик Plesk и установите обновление для установленных компонентов.

Восстановление Plesk

1. Выполните команду plesk repair installation.
2. Выполните команду plesk repair all -n, чтобы проверить наличие ошибок в конфигурации Plesk.
3. При обнаружении каких-либо проблем можно попытаться устранить их автоматически с помощью команды plesk repair (используя соответствующий аспект, например, plesk repair mail или plesk repair web). Если устранить проблемы таким образом не удастся, попробуйте сделать это вручную или обратиться в службу технической поддержки.

Потенциальные проблемы

• Сообщение об ошибке "API module structure...is garbled" при конфигурации Apache свидетельствует о том, что Apache был обновлен, но один или более модулей обновлены не были. Для решения этой проблемы отключите затронутые модули.
• Сообщение об ошибке "No matches for the wildcard '*.conf'" при конфигурации Apache свидетельствует о том, что Apache был обновлен, но один или более его конфигурационных файлов, расположенных в папках /etc/apache2/conf.d и /etc/apache2/plesk.conf.d все еще содержат директиву Include со старым синтаксисом. Для решения этой проблемы замените Include на IncludeOptional.
• Сообщение об ошибке "Could not open configuration file ..." при запуске Apache может свидетельствовать о том, что указанный файл является символьной ссылкой, указывающей на несуществующий файл. Для решения этой проблемы удалите символьную ссылку.
• Сообщение об ошибке "Invalid command 'LockFile'" при запуске Apache свидетельствует о том, что Apache был обновлен, но конфигурационный файл /etc/apache2/apache2.conf содержит неподдерживаемую директиву LockFile. Для решения этой проблемы замените строку

LockFile ${APACHE_LOCK_DIR}/accept.lock

строкой

Mutex file:${APACHE_LOCK_DIR} default

.

• Сообщение об ошибке "SSLSessionCache ... session cache not supported" при запуске Apache может свидетельствовать об отсутствии файла socache_shmcb.load. Для решения этой проблемы выполните следующую команду

cp /etc/apache2/mods-available/socache_shmcb.load /etc/apache2/mods-enabled/

Нужно также открыть для редактирования файл /etc/apache2/mods-enabled/ssl.conf и заменить строку

SSLMutex file:${APACHE_RUN_DIR}/ssl_mutex

строкой

Mutex file:${APACHE_LOCK_DIR} ssl-cache

во избежание другой ошибки.

• Сообщение об ошибке "Invalid command 'Order'" при запуске Apache свидетельствует о том, что Apache был обновлен, но один или более его конфигурационных файлов, расположенных в папках /etc/apache2/conf.d и /etc/apache2/plesk.conf.d по-прежнему содержат неподдерживаемую директиву Order. Для решения этой проблемы замените строки

Order allow, deny
Allow from all

строкой

Require all granted

.

• Сообщение об ошибке "Config file dir.conf not properly enabled" может свидетельствовать о том, что файл /etc/apache2/mods-enabled/dir.conf является действительным файлом, а не символьной ссылкой. Для решения этой проблемы удалите файл и создайте символьную ссылку, указывающую на /etc/apache2/mods-available/dir.conf.
• Сообщение об ошибке "Failed to get D-Bus connection" может свидетельствовать о неполном переключении с init на systemd. Для решения этой проблемы перезагрузите сервер.