воскресенье, 12 января 2025 г.

Обновление PostgreSQL c 13 на 16 версию на Rocky Linux 9.4. Установка PostGIS

По умолчанию в Rocky Linux 9.4 в репозитариях присутствует пакет PostgreSQL 13.18.
Мне потребовалось установить расширение PostGIS, которое стабильно работает с 16 и более поздней версией. Поэтому для установки данного расширения необходимо провести update самой базы PostgreSQL с 13 на 16 версию.

Подключаемся к старой версии PostgreSQL (13) и проверяем установленные расширения:
# su - postgres -c "psql"
# \c <ИМЯ_БД>
# \dx

Расширение plpgsql обычно есть везде по умолчанию.
В новой версии должны быть как минимум те же самые расширения.

Устанавливаем репозитарий EPEL
# yum install -y epel-release
# dnf config-manager --enable crb

Добавляем репозитарий PostgreSQL
# dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm
Отключаем встроенный модуль postgresql в репозитариях по умолчанию.
# dnf -qy module disable postgresql
Проверка подключения репозитариев:
# yum repolist
Видим, что репозитарий с 16ой версией присутствует в списке доступных.
Вводим команду установки:
# dnf install postgresql16-server
Во время установки мы получим ошибки о том, что не получилось создать символьные ссылки на основные программы в папке /usr/bin/, так как целевые имена файлов уже используются. Все правильно. Так как в системе уже стоит PostgreSQL 13 версии. Создадим символьные ссылки позже.
failed to link /usr/bin/psql -> /etc/alternatives/pgsql-psql: /usr/bin/psql exists and it is not a symlink
failed to link /usr/bin/clusterdb -> /etc/alternatives/pgsql-clusterdb: /usr/bin/clusterdb exists and it is not a symlink
failed to link /usr/bin/createdb -> /etc/alternatives/pgsql-createdb: /usr/bin/createdb exists and it is not a symlink
failed to link /usr/bin/createuser -> /etc/alternatives/pgsql-createuser: /usr/bin/createuser exists and it is not a symlink
failed to link /usr/bin/dropdb -> /etc/alternatives/pgsql-dropdb: /usr/bin/dropdb exists and it is not a symlink
failed to link /usr/bin/dropuser -> /etc/alternatives/pgsql-dropuser: /usr/bin/dropuser exists and it is not a symlink
failed to link /usr/bin/pg_basebackup -> /etc/alternatives/pgsql-pg_basebackup: /usr/bin/pg_basebackup exists and it is not a symlink
failed to link /usr/bin/pg_dump -> /etc/alternatives/pgsql-pg_dump: /usr/bin/pg_dump exists and it is not a symlink
failed to link /usr/bin/pg_dumpall -> /etc/alternatives/pgsql-pg_dumpall: /usr/bin/pg_dumpall exists and it is not a symlink
failed to link /usr/bin/pg_restore -> /etc/alternatives/pgsql-pg_restore: /usr/bin/pg_restore exists and it is not a symlink
failed to link /usr/bin/reindexdb -> /etc/alternatives/pgsql-reindexdb: /usr/bin/reindexdb exists and it is not a symlink
failed to link /usr/bin/vacuumdb -> /etc/alternatives/pgsql-vacuumdb: /usr/bin/vacuumdb exists and it is not a symlink


Инициируем базу данных:
# /usr/pgsql-16/bin/postgresql-16-setup initdb

Переводим новую базу PostgreSQL-16 на работу с другим портом и делаем тестовый запуск.
# nano /var/lib/pgsql/16/data/postgresql.conf
Меняем директиву по умолчанию port = 5432 на port = 5433
То есть вписываем после закомментированной строчки 
#port = 5432                            # (change requires restart)
строку:
port = 5433
На данном этапе так же нужно сравнить специфичные настройки в файлах конфигурации: 
новой версии /var/lib/pgsql/16/data/postgresql.conf и старой версии /var/lib/pgsql/data/postgresql.conf,
новой версии /var/lib/pgsql/16/data/pg_hba.conf и старой версии /var/lib/pgsql/data/pg_hba.conf
Нужно что бы специфичные настройки в новой версии были такие же как в старой.
Стартуем новую версию PostgreSQL:
# systemctl start postgresql-16
Проверка работоспособности:
# systemctl status postgresql-16
# su - postgres -c "PGPORT=5433 psql"

Останавливаем новую базу:
# systemctl stop postgresql-16

Старая база postgresql-13 располагается тут /var/lib/pgsql/data, исполняемые файлы тут /usr/bin.
Новая база postgresql-16 держит файлы тут /var/lib/pgsql/16/data, исполняемые файлы тут /usr/pgsql-16/bin
Используя знания мест расположения, выполняем проверку возможности переноса данных из страрой базы в новую:
# su - postgres -c " \
/usr/pgsql-16/bin/pg_upgrade \
--old-datadir=/var/lib/pgsql/data \
--new-datadir=/var/lib/pgsql/16/data \
--old-bindir=/usr/bin \
--new-bindir=/usr/pgsql-16/bin \
--old-options '-c config_file=/var/lib/pgsql/data/postgresql.conf' \
--new-options '-c config_file=/var/lib/pgsql/16/data/postgresql.conf' \
--check \
"

Вывод должен быть таким:
Performing Consistency Checks on Old Live Server
------------------------------------------------
Checking cluster versions                                     ok
Checking database user is the install user                    ok
Checking database connection settings                         ok
Checking for prepared transactions                            ok
Checking for system-defined composite types in user tables    ok
Checking for reg* data types in user tables                   ok
Checking for contrib/isn with bigint-passing mismatch         ok
Checking for incompatible "aclitem" data type in user tables  ok
Checking for user-defined encoding conversions                ok
Checking for user-defined postfix operators                   ok
Checking for incompatible polymorphic functions               ok
Checking for presence of required libraries                   ok
Checking database user is the install user                    ok
Checking for prepared transactions                            ok
Checking for new cluster tablespace directories               ok
*Clusters are compatible*


Останавливам текущий экземпляер базы PostgreSQL-13 и выполняем перенос данных в новую базу:
# systemctl stop postgresql
# su - postgres -c " \
/usr/pgsql-16/bin/pg_upgrade \
--old-datadir=/var/lib/pgsql/data \
--new-datadir=/var/lib/pgsql/16/data \
--old-bindir=/usr/bin \
--new-bindir=/usr/pgsql-16/bin \
--old-options '-c config_file=/var/lib/pgsql/data/postgresql.conf' \
--new-options '-c config_file=/var/lib/pgsql/16/data/postgresql.conf' "

Произойдет копирование базы данных из старой версии в новую:
Performing Consistency Checks
-----------------------------
Checking cluster versions                                     ok
Checking database user is the install user                    ok
Checking database connection settings                         ok
Checking for prepared transactions                            ok
Checking for system-defined composite types in user tables    ok
Checking for reg* data types in user tables                   ok
Checking for contrib/isn with bigint-passing mismatch         ok
Checking for incompatible "aclitem" data type in user tables  ok
Checking for user-defined encoding conversions                ok
Checking for user-defined postfix operators                   ok
Checking for incompatible polymorphic functions               ok
Creating dump of global objects                               ok
Creating dump of database schemas                      ok
Checking for presence of required libraries                   ok
Checking database user is the install user                    ok
Checking for prepared transactions                            ok
Checking for new cluster tablespace directories               ok
If pg_upgrade fails after this point, you must re-initdb the
new cluster before continuing.
Performing Upgrade
------------------
Setting locale and encoding for new cluster                   ok
Analyzing all rows in the new cluster                         ok
Freezing all rows in the new cluster                          ok
Deleting files from new pg_xact                               ok
Copying old pg_xact to new server                             ok
Setting oldest XID for new cluster                            ok
Setting next transaction ID and epoch for new cluster         ok
Deleting files from new pg_multixact/offsets                  ok
Copying old pg_multixact/offsets to new server                ok
Deleting files from new pg_multixact/members                  ok
Copying old pg_multixact/members to new server                ok
Setting next multixact ID and offset for new cluster          ok
Resetting WAL archives                                        ok
Setting frozenxid and minmxid counters in new cluster         ok
Restoring global objects in the new cluster                   ok
Restoring database schemas in the new cluster   ok
Copying user relation files                                   ok
Setting next OID for new cluster                              ok
Sync data directory to disk                                   ok
Creating script to delete old cluster                         ok
Checking for extension updates                                ok
Upgrade Complete
----------------
Optimizer statistics are not transferred by pg_upgrade.
Once you start the new server, consider running:
    /usr/pgsql-16/bin/vacuumdb --all --analyze-in-stages
Running this script will delete the old cluster's data files:
    ./delete_old_cluster.sh


Стартуем новый сервер, подключаемся к нему и проверяем есть ли в нем данные:
# systemctl start postgresql-16
# su - postgres -c "PGPORT=5433 psql"
# \c <ИМЯ_БД>
# \dt 
# какие-нибудь команды SELECT

Если все в порядке, то меняем порт 5433 на 5432 у нового сервера
# nano /var/lib/pgsql/16/data/postgresql.conf
port = 5432
# systemctl restart postgresql-16
# systemctl enable postgresql-16
# systemctl disable postgresql
# systemctl status postgresql-16


Оптимизируем новую базу:
# su - postgres -c "/usr/pgsql-16/bin/vacuumdb --all --analyze-in-stages"
Удаляем данные старого кластера PostgreSQL-13:
# su - postgres -c "/var/lib/pgsql/delete_old_cluster.sh"
Удалить старый Postgresql (13 версии)
# yum remove postgresql postgresql-server
Создаем ссылки на исполняемые файлы Postgres
# ln -s /usr/pgsql-16/bin/psql /usr/bin/psql
# ln -s /usr/pgsql-16/bin/clusterdb /usr/bin/clusterdb
# ln -s /usr/pgsql-16/bin/createdb /usr/bin/createdb
# ln -s /usr/pgsql-16/bin/createuser /usr/bin/createuser
# ln -s /usr/pgsql-16/bin/dropdb /usr/bin/dropdb
# ln -s /usr/pgsql-16/bin/dropuser /usr/bin/dropuser
# ln -s /usr/pgsql-16/bin/pg_basebackup /usr/bin/pg_basebackup
# ln -s /usr/pgsql-16/bin/pg_dump /usr/bin/pg_dump
# ln -s /usr/pgsql-16/bin/pg_dumpall /usr/bin/pg_dumpall
# ln -s /usr/pgsql-16/bin/pg_restore /usr/bin/pg_restore
# ln -s /usr/pgsql-16/bin/reindexdb /usr/bin/reindexdb
# ln -s /usr/pgsql-16/bin/vacuumdb /usr/bin/vacuumdb


Теперь можно установить postgis выбрав правильные версии postgresql
# dnf install postgis34_16
# su - postgres -c "psql"
# \c <ИМЯ_БД>
# CREATE EXTENSION postgis;
CREATE EXTENSION

Проверка установленного расширения:
# SELECT * FROM pg_available_extensions WHERE name = 'postgis';
# \dx

Если при вводе команды "CREATE EXTENSION postgis;возникают вот такие ошибки
ERROR:  could not access file "$libdir/postgis-3": No such file or directory
или
ERROR:  could not open extension control file "/usr/share/pgsql/extension/postgis.control": No such file or directory

скорее всего в системе стоит несколько версий PostgreSQL, и не используемую нужно удалить.

На этом все.