Описание процесса

Данный процесс предусматривает перевод сервера PostgreSQL с версии 11 до версии 15

Обращаем ваше внимание на то, что обновление сервера PostgreSQL должно осуществляться опытными ИТ-специалистами, обладающими базовыми навыками по администрированию Unix/Linux систем.

Данная инструкция применима только для сборок Ubuntu SetRetail10!

Дистрибутив

Подключение к серверу для управления командной строкой

SetConsole

1. В SetConsole войдите в раздел Сервер.

2. Введите данные сервера → нажмите Подключиться по SSH.

3. Откроется SSH-сеанс командной строки сервера.

PuTTy

1. Установите тип кодировки UTF8.

2. Введите IP-адрес сервера и нажмите кнопку Open.

3. Нажмите кнопку Да.

4. Введите логин и пароль. Обратите внимание, во время ввода пароля, этот процесс не отображается.

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

1. Перед загрузкой дистрибутивов и в целом для начала процесса установки убедитесь, что Вам действительно стоит переходить на версию PostgreSQL 11.

Проверьте, что у Вас установлен PostgreSQL версии 11

Наберите команду:

psql --version

Результатом вывода команды должна стать версия 11.XX.ХХ

2. Обязательно проверьте наличие свободного дискового пространства, оно должно быть достаточным, в зависимости от размеров вашей БД, так как в следующих шагах восстановление базы данных будет производиться в новую версию сервера СУБД PostgreSQL 11.

Проверьте, что размер вашего жесткого диска позволяет провести данную операцию командой:

df -h

Также проверьте размер папки с PostgreSQL командой:

du -hs /var/lib/pgsql/

3. Следуйте только шагам описанным в данной инструкции!

Загрузка дистрибутивов на сервер

1. Загрузите дистрибутив, используя WinSCP отдельно или через SetConsole → войдите в раздел Сервер.

2. Введите данные сервера → нажмите Подключиться по WinSCP.

3. Скопируйте файл дистрибутива в папку /hd:

Кликните по файлу на диске → нажмите клавишу F5 → нажмите OK.

Дождитесь загрузки дистрибутива на сервер.

4. Дистрибутив отобразится в папке сервера /hd.

Обновление PostgreSQL для ОС Linux Ubuntu

1. Выполните команду:

sudo chmod -R 777 /home/hd/upgrade_pg11_pg15.sh

2. Для запуска обновления выполните команду:

sudo sh ./upgrade_pg11_pg15.sh

3. Начнется процесс обновления сервера. 

4. Во время процесса обновления будут созданы резервные копии всех баз данных, установлена новая версия PostgreSQL 15.

Во время обновления могут появиться сообщения об ошибках, которые не влияют на результат.

5. По окончании процесса обновления появится сообщение о его завершении.

6. Выполните команду для проверки версии PostgreSQL.

psql --version

Должна отобразиться версия 15.5

7. Выполните команду для проверки статуса службы сервера СУБД PostgreSQL 15.

systemctl status postgresql

8. Выполните команду для проверки статуса службы сервера SetRetail.

systemctl status JBOSS_SVC

Если статус не отображается active (exited), тогда перезагрузите полностью сервер командой sudo reboot и заново проверьте статус службы.

Также проверьте статус службы SetAgent.

systemctl status setagent.service

9. Наберите команду для проверки статуса запуска приложения и проверьте, что отображается файл Set10.ear.deployed. 

ls -la /var/lib/jboss/standalone/deployments/

10. Наберите адрес сервера SetRetail и проверьте, что визуальная часть отображается в веб-браузере. 

Обновление завершено.

Лог-файлы обновления и резервные копии баз данных

Все копии баз данных и лог-файлы процесса обновления располагаются в папке /var/lib/postgresql/11/upgrade1115.

Для просмотра статуса обновления откройте для просмотра лог-файл status.log

Будут отображены статусы резервного копирования, восстановления и обновления.

Очистка места на диске после обновления

Удалите всю папку с пакетом обновления, включая файлы резервных копий, выполнив команду.

sudo rm -rf /var/lib/postgresql/11/