HOWTO: Обновление версии PostgreSQL - История изменений

Uscld2 в 06:07, 21 августа 2025

2025-08-21T06:07:32Z

← Предыдущая версия		Версия от 06:07, 21 августа 2025
Строка 76:		Строка 76:
	<pre>		<pre>
	# дважды один и тот же запрос		# дважды один и тот же запрос
	sudo -u postgres psql -d ~~postgres~~ -A -t -c "SELECT postgis_extensions_upgrade()"		sudo -u postgres psql -d userside -A -t -c "SELECT postgis_extensions_upgrade()"
	sudo -u postgres psql -d ~~postgres~~ -A -t -c "SELECT postgis_extensions_upgrade()"		sudo -u postgres psql -d userside -A -t -c "SELECT postgis_extensions_upgrade()"
	# удалить расширение raster, которое раньше было частью расширения postgis		# удалить расширение raster, которое раньше было частью расширения postgis
	sudo -u postgres psql -d ~~postgres~~ -A -t -c "DROP EXTENSION postgis_raster"		sudo -u postgres psql -d userside -A -t -c "DROP EXTENSION postgis_raster"
	</pre>		</pre>

Uscld2 в 06:01, 21 августа 2025

2025-08-21T06:01:41Z

Внесённые изменения

Uscld2 в 18:13, 20 августа 2025

2025-08-20T18:13:38Z

← Предыдущая версия		Версия от 18:13, 20 августа 2025
Строка 75:		Строка 75:
	sudo -u postgres psql -d postgres -A -t -c "SELECT postgis_extensions_upgrade()"		sudo -u postgres psql -d postgres -A -t -c "SELECT postgis_extensions_upgrade()"
	sudo -u postgres psql -d postgres -A -t -c "DROP EXTENSION postgis_raster"		sudo -u postgres psql -d postgres -A -t -c "DROP EXTENSION postgis_raster"
	<pre>		</pre>

	=== Установить новые версии пакетов ===		=== Установить новые версии пакетов ===

Uscld2 в 18:13, 20 августа 2025

2025-08-20T18:13:14Z

← Предыдущая версия		Версия от 18:13, 20 августа 2025
Строка 60:		Строка 60:
	</pre>		</pre>

	=== Обновление с PostGIS 2.5 на PostGIS 3.x		=== Обновление с PostGIS 2.5 на PostGIS 3.x ===
	Если предыдущий запрос <code>SELECT PostGIS_full_version()</code> отображает информацию подобно такой:		Если предыдущий запрос <code>SELECT PostGIS_full_version()</code> отображает информацию подобно такой:
	<pre>		<pre>

Uscld2 в 18:09, 20 августа 2025

2025-08-20T18:09:47Z

← Предыдущая версия		Версия от 18:09, 20 августа 2025
Строка 41:		Строка 41:

	=== Обновить текущую версии postgresql в пределах основной версии ===		=== Обновить текущую версии postgresql в пределах основной версии ===
	Проверить текущие версии. Обновить текущие ~~пакеты~~ PostgreSQL и PostGIS:		Проверить текущие версии системных пакетов PostgreSQL и PostGIS. Обновить текущие установленные версии PostgreSQL и PostGIS до посладних версий, а также, если текущая версия PostGIS ниже 3, установить дополнительно пакет PostGIS 3 для вашей версии PostgreSQL. Если у вас уже сейчас установлен PostGIS 3, то вам нужно только лишь его обновить до последней версии.
	<pre>		<pre>
	sudo -u postgres psql -d userside -A -t -c "SELECT VERSION()"		sudo -u postgres psql -d userside -A -t -c "SELECT VERSION()"
	sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"		sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"
	~~sudo -u postgres psql -d postgres -A -t -c "SELECT PostGIS_full_version()"~~

	sudo apt update		sudo apt update
	sudo apt install --only-upgrade -y postgresql-11 postgresql-11-postgis-2.5		sudo apt install --only-upgrade -y postgresql-11 postgresql-11-postgis-2.5
			# только если текущая версия postgis ниже 3
			sudo apt install -y postgresql-11-postgis-3
	</pre>		</pre>
	Вместо 11 и 2.5 укажите те версии, которе фактически установлены у вас.		Вместо 11 и 2.5 укажите те версии, которе фактически установлены у вас.

	=== Обновить расширение postgis до самой последней версии ===		=== Обновить расширение postgis до самой последней версии ===
	Обязательно также обновить расширение в ~~базе~~ данных! ~~Если предыдущие команды также показали~~ наличие расширения в базе данных ~~postgres~~, ~~то postgis нужно~~ обновить и для ~~нее~~.		Обязательно также обновить расширение postgis в самих базах данных! У вас может быть несколько баз данных, в которые установлено это расширение. Например, у вас на сервре есть еще тестовая база данных (копия основной для тестов). Проверьте все существующие базы данных сервера на наличие расширения PostGIS и обновите его в каждой базе данных. Вы можете просто попытаться обновить расширение во всех базах данных, там где его нет — будет просто ошибка обновления. Далее показано как обновить в базе данных userisde. Проделайте это для всех баз данных, в которые оно установлено.
	<pre>		<pre>
	~~sudo apt install -y postgresql-11-postgis-3~~

	~~sudo -u postgres psql -d postgres -A -t -c "ALTER EXTENSION postgis UPDATE"~~
	~~sudo -u postgres psql -d postgres -A -t -c "SELECT PostGIS_full_version()"~~

	sudo -u postgres psql -d userside -A -t -c "ALTER EXTENSION postgis UPDATE"		sudo -u postgres psql -d userside -A -t -c "ALTER EXTENSION postgis UPDATE"
	sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"		sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"
	</pre>		</pre>

	=== Установить ~~новую версию postgresql не удаляя старой~~ ===		=== Обновление с PostGIS 2.5 на PostGIS 3.x
			Если предыдущий запрос <code>SELECT PostGIS_full_version()</code> отображает информацию подобно такой:
			<pre>
			POSTGIS="3.3.4 3.3.4" [EXTENSION] . . .
			. . .
			[UNPACKAGED!] (raster procs from "2.5.5 r0" need upgrade)
			</pre>
			То следующая информация для вас.

			Между версиям PosGIS 2 и 3 существует некоторая разница, которая требует дополнительных действий при обновлении. Если вы после выполнения предыдущего запроса не увидели такой проблем, то следующие действия выполнять не нужно — переходите к следующему разделу.
			<pre>
			# дважды один и тот же запрос
			sudo -u postgres psql -d postgres -A -t -c "SELECT postgis_extensions_upgrade()"
			sudo -u postgres psql -d postgres -A -t -c "SELECT postgis_extensions_upgrade()"
			sudo -u postgres psql -d postgres -A -t -c "DROP EXTENSION postgis_raster"
			<pre>

			=== Установить новые версии пакетов ===
			А также удалить старый пакет postgis версии 2, если он был.
	<pre>		<pre>
	sudo apt install -y postgresql-17 postgresql-17-postgis-3		sudo apt install -y postgresql-17 postgresql-17-postgis-3
			sudo apt purge postgresql-11-postgis-2.5
	</pre>		</pre>

	=== Сделать запасную резервную копию базы данных и настроек ===		=== Сделать запасную резервную копию базы данных и настроек ===
	~~Число 11 в имени файлов —~~ это ~~номер версии PostgreSQL~~, ~~к которой относится эта резервная копия~~.		Инструмент миграции кластеров между версиями делает это абсолютно безопасно, однако дополнительная осторожность лишней не будет. Сделайте запасные временные резервные копии, которые в конце обновления можно будет удалить.
	<pre>		<pre>
	sudo -u postgres pg_dump --no-acl -Fp -Z 5 userside --file=/backup/~~userside_emergency_11~~.sql.gz		sudo -u postgres pg_dump --no-acl -Fp -Z 5 userside --file=/backup/userside_emergency.sql.gz
	sudo -u postgres pg_dump --no-acl -Fc userside --file=/backup/~~userside_emergency_11~~.dump		sudo -u postgres pg_dump --no-acl -Fc userside --file=/backup/userside_emergency.dump
	sudo tar czf /backup/~~postgres_config_emergency_11~~.tgz -C /etc/postgresql/11/main .		sudo tar czf /backup/postgres_config_emergency.tgz -C /etc/postgresql/11/main .
	</pre>		</pre>
	Каталог /backup должен существовать и должен быть доступен для записи всем пользователям.		Каталог /backup должен существовать и должен быть доступен для записи всем пользователям.
Строка 89:		Строка 104:
	17 main 5433 online postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17.log		17 main 5433 online postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17.log
	</pre>		</pre>
	Кластер 17/main был создан автоматически сценарием установки postgresql. Его нужно остановить и удалить.		Кластер 17/main был создан автоматически сценарием установки postgresql и использует новый порт 5433. Его нужно остановить и удалить — он не нужен, т.к. будет выполняться процедура миграции кластера, которая создаст новый кластер автоматически.
	<pre>		<pre>
	sudo pg_dropcluster 17 main --stop		sudo pg_dropcluster 17 main --stop
Строка 104:		Строка 119:
	sudo pg_upgradecluster 11 main		sudo pg_upgradecluster 11 main
	</pre>		</pre>
	После завершения операции обновления вы увидите новое состояние кластеров (старая версия должна находиться в режиме '''down'''):		После завершения операции обновления вы увидите новое состояние кластеров (старая версия должна находиться в режиме '''down''' и порт 5432 теперь используется новым кластером):
	<pre>		<pre>
	Ver Cluster Port Status Owner Data directory Log file		Ver Cluster Port Status Owner Data directory Log file
Строка 121:		Строка 136:
	sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"		sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"
	</pre>		</pre>
	Вы должны увидеть 17ю версию postgresql и 3.3.4 версию postgis~~. Может быть к тому времени, как вы будете читать эти строки, версия postgis будет более новой~~.		Вы должны увидеть 17ю версию postgresql и 3.x.x версию postgis.

	Теперь запустите службу FPM и зайдите в USERSIDE через браузер.		Теперь запустите службу FPM и зайдите в USERSIDE через браузер.
Строка 138:		Строка 153:
	<pre>		<pre>
	sudo pg_dropcluster 11 main --stop		sudo pg_dropcluster 11 main --stop
	sudo apt purge -y postgresql-11 ~~postgresql-11-postgis-2.5~~ postgresql-11-postgis-3		sudo apt purge -y postgresql-11 postgresql-11-postgis-3
	sudo apt autoremove -y		sudo apt autoremove -y
	sudo rm /backup/~~userside_emergency_11~~* /backup/~~postgres_config_emergency_11~~.tgz		sudo rm /backup/userside_emergency* /backup/postgres_config_emergency.tgz
	sudo rm -rf /var/lib/postgresql/11/main		sudo rm -rf /var/lib/postgresql/11/main
	</pre>		</pre>

Uscld2 в 12:11, 20 августа 2025

2025-08-20T12:11:56Z

← Предыдущая версия		Версия от 12:11, 20 августа 2025
Строка 1:		Строка 1:
	[[HOWTO:_PostgreSQL_version_upgrade\|en]] \| [[HOWTO:_Обновление_версии_PostgreSQL\|ru]]		[[HOWTO:_PostgreSQL_version_upgrade\|en]] \| [[HOWTO:_Обновление_версии_PostgreSQL\|ru]]

	В данном разделе описана процедура обновления PostgreSQL ''между основными версиями'' (например, с версии 11 на версию 16).		В данном разделе описана процедура обновления PostgreSQL ''между основными версиями'' (например, с версии 11 на версию 17).

	Обновление внутри версии (например, с версии 16.1 на версию 16.2) ''происходит автоматически и не требует дополнительных действий''.		Обновление внутри версии (например, с версии 17.1 на версию 17.2) ''происходит автоматически и не требует дополнительных действий''.

	'''Рекомендуем ознакомиться с официальными инструкциями по обновлению''' на сайте [https://www.postgresql.org/docs/current/upgrading.html postgresql.org].		'''Рекомендуем ознакомиться с официальными инструкциями по обновлению''' на сайте [https://www.postgresql.org/docs/current/upgrading.html postgresql.org].
Строка 11:		Строка 11:
	Кластером баз данных ([https://www.postgresql.org/docs/current/glossary.html Database cluster]) в PostgreSQL называется экземпляр сервера вместе со всеми обслуживаемыми БД, а не распределенную систему, как может показаться.		Кластером баз данных ([https://www.postgresql.org/docs/current/glossary.html Database cluster]) в PostgreSQL называется экземпляр сервера вместе со всеми обслуживаемыми БД, а не распределенную систему, как может показаться.

	В следующем примере будет показано обновление кластера БД с версии 11 на версию 16 используя инструменты из пакета '''postgresql-common'''.		В следующем примере будет показано обновление кластера БД с версии 11 на версию 17 используя инструменты из пакета '''postgresql-common'''.

	== Порядок обновления ==		== Порядок обновления ==
Строка 17:		Строка 17:
	# Обновить текущую версии postgresql в пределах основной версии (например, с 11.5 до 11.22).		# Обновить текущую версии postgresql в пределах основной версии (например, с 11.5 до 11.22).
	# Обновить расширение postgis до самой последней версии (например, с 2.5 до 3.3.4). Также обязательно обновить расширение и в самой базе данных.		# Обновить расширение postgis до самой последней версии (например, с 2.5 до 3.3.4). Также обязательно обновить расширение и в самой базе данных.
	# Установить новую версию postgresql не удаляя старой (например 16.1)		# Установить новую версию postgresql не удаляя старой (например 17.1)
	# Сделать запасную резервную копию базы данных и настроек		# Сделать запасную резервную копию базы данных и настроек
	# Удалить кластер БД, созданный автоматически сценарием при установке новой версии		# Удалить кластер БД, созданный автоматически сценарием при установке новой версии
Строка 45:		Строка 45:
	sudo -u postgres psql -d userside -A -t -c "SELECT VERSION()"		sudo -u postgres psql -d userside -A -t -c "SELECT VERSION()"
	sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"		sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"
			sudo -u postgres psql -d postgres -A -t -c "SELECT PostGIS_full_version()"

	sudo apt update		sudo apt update
Строка 52:		Строка 53:

	=== Обновить расширение postgis до самой последней версии ===		=== Обновить расширение postgis до самой последней версии ===
	Обязательно также обновить расширение в базе данных!		Обязательно также обновить расширение в базе данных! Если предыдущие команды также показали наличие расширения в базе данных postgres, то postgis нужно обновить и для нее.
	<pre>		<pre>
	sudo apt install -y postgresql-11-postgis-3		sudo apt install -y postgresql-11-postgis-3

			sudo -u postgres psql -d postgres -A -t -c "ALTER EXTENSION postgis UPDATE"
			sudo -u postgres psql -d postgres -A -t -c "SELECT PostGIS_full_version()"

	sudo -u postgres psql -d userside -A -t -c "ALTER EXTENSION postgis UPDATE"		sudo -u postgres psql -d userside -A -t -c "ALTER EXTENSION postgis UPDATE"
Строка 62:		Строка 66:
	=== Установить новую версию postgresql не удаляя старой ===		=== Установить новую версию postgresql не удаляя старой ===
	<pre>		<pre>
	sudo apt install -y postgresql-16 postgresql-16-postgis-3		sudo apt install -y postgresql-17 postgresql-17-postgis-3
	</pre>		</pre>

Строка 83:		Строка 87:
	Ver Cluster Port Status Owner Data directory Log file		Ver Cluster Port Status Owner Data directory Log file
	11 main 5432 online postgres /var/lib/postgresql/11/main /var/log/postgresql/postgresql-11.log		11 main 5432 online postgres /var/lib/postgresql/11/main /var/log/postgresql/postgresql-11.log
	16 main 5433 online postgres /var/lib/postgresql/16/main /var/log/postgresql/postgresql-16.log		17 main 5433 online postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17.log
	</pre>		</pre>
	Кластер 16/main был создан автоматически сценарием установки postgresql. Его нужно остановить и удалить.		Кластер 17/main был создан автоматически сценарием установки postgresql. Его нужно остановить и удалить.
	<pre>		<pre>
	sudo pg_dropcluster 16 main --stop		sudo pg_dropcluster 17 main --stop
	</pre>		</pre>
	Повторное выполнение команды <code>pg_lsclusters</code> должно показать, что у вас остался один кластер '''11/main'''.		Повторное выполнение команды <code>pg_lsclusters</code> должно показать, что у вас остался один кластер '''11/main'''.
Строка 104:		Строка 108:
	Ver Cluster Port Status Owner Data directory Log file		Ver Cluster Port Status Owner Data directory Log file
	11 main 5433 down postgres /var/lib/postgresql/11/main /var/log/postgresql/postgresql-11.log		11 main 5433 down postgres /var/lib/postgresql/11/main /var/log/postgresql/postgresql-11.log
	16 main 5432 online postgres /var/lib/postgresql/16/main /var/log/postgresql/postgresql-16.log		17 main 5432 online postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17.log
	</pre>		</pre>
	Запустите службу postgres		Запустите службу postgres
Строка 117:		Строка 121:
	sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"		sudo -u postgres psql -d userside -A -t -c "SELECT PostGIS_full_version()"
	</pre>		</pre>
	Вы должны увидеть ~~16ю~~ версию postgresql и 3.3.4 версию postgis. Может быть к тому времени, как вы будете читать эти строки, версия postgis будет более новой.		Вы должны увидеть 17ю версию postgresql и 3.3.4 версию postgis. Может быть к тому времени, как вы будете читать эти строки, версия postgis будет более новой.

	Теперь запустите службу FPM и зайдите в USERSIDE через браузер.		Теперь запустите службу FPM и зайдите в USERSIDE через браузер.

Uscld2: /* Проверить работу USERSIDE */

2025-04-13T17:47:10Z

Проверить работу USERSIDE

← Предыдущая версия		Версия от 17:47, 13 апреля 2025
Строка 121:		Строка 121:
	Теперь запустите службу FPM и зайдите в USERSIDE через браузер.		Теперь запустите службу FPM и зайдите в USERSIDE через браузер.
	<pre>		<pre>
	sudo systemctl start php8.1-fpm		sudo systemctl start php8.3-fpm
	</pre>		</pre>
	Так как другие службы остановлены, вы, вероятно, увидите ошибки связанные с ними, но при этом интерфейс USERSIDE должен открыться без ошибок подключения к базе данных.		Так как другие службы остановлены, вы, вероятно, увидите ошибки связанные с ними, но при этом интерфейс USERSIDE должен открыться без ошибок подключения к базе данных.

Uscld2: /* Остановить USERSIDE */

2025-04-13T17:46:52Z

Остановить USERSIDE

← Предыдущая версия		Версия от 17:46, 13 апреля 2025
Строка 34:		Строка 34:
	<pre>		<pre>
	sudo supervisorctl stop all		sudo supervisorctl stop all
	sudo systemctl stop php8.1-fpm		sudo systemctl stop php8.3-fpm
	</pre>		</pre>
	Версия php указана для примера. Используйте ту, что испльзуется у вас.		Версия php указана для примера. Используйте ту, что испльзуется у вас.

Uscld2: /* Пошаговая инструкция */

2024-12-25T19:01:02Z

Пошаговая инструкция

← Предыдущая версия		Версия от 19:01, 25 декабря 2024
Строка 98:		Строка 98:
	Запустите процесс обновления кластера БД '''11/main''' используя утилиту <code>pg_upgradecluster</code> из пакета postgresql-common. Это действие может занять много времени и дискового пространства.		Запустите процесс обновления кластера БД '''11/main''' используя утилиту <code>pg_upgradecluster</code> из пакета postgresql-common. Это действие может занять много времени и дискового пространства.
	<pre>		<pre>
	sudo pg_upgradecluster ~~-m upgrade~~ 11 main		sudo pg_upgradecluster 11 main
	</pre>		</pre>
	После завершения операции обновления вы увидите новое состояние кластеров (старая версия должна находиться в режиме '''down'''):		После завершения операции обновления вы увидите новое состояние кластеров (старая версия должна находиться в режиме '''down'''):

Uscld2: /* Выполнить обновление кластера БД старой версии до кластера новой версии */

2024-01-24T06:57:20Z

Выполнить обновление кластера БД старой версии до кластера новой версии

← Предыдущая версия		Версия от 06:57, 24 января 2024
Строка 100:		Строка 100:
	sudo pg_upgradecluster -m upgrade 11 main		sudo pg_upgradecluster -m upgrade 11 main
	</pre>		</pre>
	~~В конце выполнения команды~~ вы увидите новое состояние кластеров (старая версия должна находиться в режиме '''down'''):		После завершения операции обновления вы увидите новое состояние кластеров (старая версия должна находиться в режиме '''down'''):
	<pre>		<pre>
	Ver Cluster Port Status Owner Data directory Log file		Ver Cluster Port Status Owner Data directory Log file