Как обновить панель управления ispmanager — подробный гайд

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

Рассмотрели два способа, как обновить панель — автоматически и вручную в консоли. А еще рассказали, как исправить возможные ошибки.

1. Подготовка к обновлению ispmanager
2. Автоматическое обновление ispmanager
3. Ручное обновление ispmanager
4. Исправляем ошибки при обновлении ispmanager

Подготовка к обновлению ispmanager

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

Рассказываем подробнее, что проверить перед обновлением:

Операционную систему. Панель ispmanager поддерживает ОС:

• AlmaLinux 8, 9
• Debian 11
• Ubuntu 20.04, Ubuntu 22.04
• VzLinux 8
• Rocky Linux 8
• CloudLinux OS SHARED

Проверить, какая ОС установлена на сервере, можно с помощью команды:

hostnamectl

Сторонние репозитории — нужно выключить сторонние репозитории на сервере, потому что они мешают корректному обновлению панели и установке ПО.

Файлы репозиториев на разных ОС:

• AlmaLinux:

/etc/yum.repos.d/ — общий каталог для всех файлов репозиториев

• Debian/Ubuntu:

/etc/apt/sources.list — файл с основными системными репозиториями.

/etc/apt/sources.list.d/ — каталог с прочими файлами репозиториев, включая репозитории ispmanager.

Проверить репозитории панели на разных ОС можно с помощью команд:

Проверяем, что в репозиториях ispmanager указан верный адрес:

https://download.ispmanager.com/

Как выглядят содержимое репозиториев с тестового стенда Ubuntu 20.04 версии Stable:

 
	 
		###deb http://download.ispmanager.com/repo/ubuntu __VERSION__-focal main
		deb http://download.ispmanager.com/repo/ubuntu stable6-focal main
		###deb http://download.ispmanager.com/repo/ubuntu __VERSION__-focal main
		deb http://download.ispmanager.com/repo/ubuntu 6-stable6-focal main
	
	

Ветку обновлений и версию панели. При обновлении возникнет ошибка, если ветка обновлений в файле repo.version и версия панели не совпадают. Например, если в файле repo.version указана версия stable, а панель версии beta, то обновление не установится.

Пример содержимого файла repo.version:

 
		 
		[root@lite ~]# cat /usr/local/mgr5/etc/repo.version
		stable
		
		

Автоматическое обновление ispmanager

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

Обновление запускается с помощью планировщика Cron — он выполняет задание один раз в день. Если в репозиториях появятся новые пакеты — Cron запустит задачу и начнется установка обновлений.

Важно. Автоматическое обновление может помешать другим процессам на сервере — например, если выполняется бэкап.

Beta-релиз выпускаем каждые 2 недели, stable — раз в месяц. Проверить дату выпуска последнего релиза и список изменений можно на сайте ispmanager →

Как включить автоматическое обновление панели ispmanager:

1. Переходим в раздел «Настройки» под пользователем root → «Настройки системы».

2. Выбираем в выпадающем списке подходящий вариант:

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

3. Нажимаем «Сохранить».

4. Проверяем, что обновление установлено. Узнать версию панели можно с помощью команды:

/usr/local/mgr5/bin/core ispmgr -i

Ручное обновление ispmanager

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

Как запустить ручное обновление:

1. Подключаемся к серверу по SSH под пользователем root.

2. Вводим в терминале команду:

/usr/local/mgr5/sbin/pkgupgrade.sh coremanager

3. Ждем, когда обновление установится — в консоли появится уведомление с информацией о том, сколько пакетов обновилось.

4. Проверяем версию панели с помощью команды:

/usr/local/mgr5/bin/core ispmgr -i

Исправляем ошибки при обновлении ispmanager

Узнали в техподдержке ispmanager, какие самые частые ошибки возникают при обновлении. Рассказываем, почему они появляются и как их исправить.

Проверить, почему панель не обновилась или возникла ошибка, можно в логе:

/usr/local/mgr5/var/pkg.log

No packages marked for update

Ошибка возникает из-за устаревших репозиториев, либо после смены версии с beta на stable.

Решение:

1. Обратиться в техническую поддержку за репозиториями с тестового стенда и установить их.

2. После смены репозиториев на корректные, запустить ручное обновление с помощью команды:

/usr/local/mgr5/sbin/pkgupgrade.sh coremanager

The repository 'http://download.ispmanager.com/repo/ubuntu 6-5.392-bionic Release' does not have a Release file

Причина ошибки — устаревшая ОС. Нужно мигрировать на поддерживаемую панелью ОС — подробнее рассказали выше, в разделе «Подготовка к обновлению».

Как мигрировать на другую ОС — рассказали в документации →

Transaction check error: file /etc/my.cnf from install of MariaDB-common-10.2.44-1.el7.centos.x86_64 conflicts with file from package mysql-community-server-8.0.28-1.el7.x86_64 Error Summary

Такая ошибка появляется, когда включен сторонний репозиторий и возникла ошибка доступа к СУБД. В нашем примере MySQL установлена из стороннего репозитория.

Как решить — выключаем сторонний репозиторий и восстанавливаем доступ к нативной версии СУБД. Затем запускаем обновление повторно.

Curl error (28): Timeout was reached for http://repo.almalinux.org/vault/8.10/PowerTools/Source/repodata/repomd.xml [Connection timed out after 30001 milliseconds]

Возможная причина — проблема с сетевыми настройками на сервере и репозиториями ОС. Рекомендуем проверить настройки брандмауэра, которые блокируют доступ к репозиториям.