Help:Migration - Revision history

Akuzmin: change previous releases link

2024-09-16T14:46:47Z

change previous releases link

← Older revision		Revision as of 17:46, 16 September 2024
Line 8:		Line 8:
	# Импорт данных в новый.		# Импорт данных в новый.

	Для экспорта информации со старого Svace сервера используется утилита '''svace-migration.jar'''. Начиная с релиза 8.0.0 она не входит в дистрибутив Svacer, но можете взять из [~~[Svacer#Предыдущие_релизы\|~~предыдущих релизов]].		Для экспорта информации со старого Svace сервера используется утилита '''svace-migration.jar'''. Начиная с релиза 8.0.0 она не входит в дистрибутив Svacer, но вы можете взять ее из [https://svacer.ispras.ru/releases предыдущих релизов].

	java -jar svace-migration.jar <user> <password> <path to svace> <path to server dir> <path to output dir>		java -jar svace-migration.jar <user> <password> <path to svace> <path to server dir> <path to output dir>

Akuzmin at 12:09, 19 June 2024

2024-06-19T12:09:28Z

← Older revision		Revision as of 15:09, 19 June 2024
Line 39:		Line 39:
	* сопутствующую информацию в директории старого сервера.		* сопутствующую информацию в директории старого сервера.

	~~ВНИМАНИЕ:~~ Для работы утилиты требуется Java 17+, при запуске возможно потребуется добавить опции JVM:		Для работы утилиты требуется Java 17+, при запуске возможно потребуется добавить опции JVM:
	--add-opens java.base/java.lang.reflect=ALL-UNNAMED		--add-opens java.base/java.lang.reflect=ALL-UNNAMED
	--add-opens java.base/java.lang=ALL-UNNAMED		--add-opens java.base/java.lang=ALL-UNNAMED

Akuzmin: add deprecation warning

2024-06-18T15:18:15Z

add deprecation warning

← Older revision		Revision as of 18:18, 18 June 2024
Line 1:		Line 1:
	[[Category:Help]]		[[Category:Help]]

			{{Note\|type=error\|text=Это устаревшая функциональность, она не поддерживается и стабильная работа не гарантируется}}

	=== Миграция со старого сервера ===		=== Миграция со старого сервера ===
	В данном подразделе описана миграция со старого сервера, поставляющегося в комплекте со Svace. Это не относится к переходу между версиями Svacer. Миграция данных со старого сервера на Svacer состоит из двух этапов:		В данном подразделе описана миграция со старого сервера, поставляющегося в комплекте со Svace. Это не относится к переходу между версиями Svacer. Миграция данных со старого сервера на Svacer состоит из двух этапов:

Akuzmin: remove svacer versions upgrade part

2023-11-24T10:10:28Z

remove svacer versions upgrade part

← Older revision		Revision as of 13:10, 24 November 2023
Line 1:		Line 1:
	[[Category:Help]]		[[Category:Help]]
	~~== Миграция ==~~
	=== Миграция со старого сервера ===		=== Миграция со старого сервера ===
	В данном подразделе описана миграция со старого сервера, поставляющегося в комплекте со Svace. Это не относится к ~~миграции~~ между версиями Svacer. Миграция данных со старого сервера на Svacer состоит из двух этапов:		В данном подразделе описана миграция со старого сервера, поставляющегося в комплекте со Svace. Это не относится к переходу между версиями Svacer. Миграция данных со старого сервера на Svacer состоит из двух этапов:
	# Экспорт информации со старого сервера.		# Экспорт информации со старого сервера.
	# Импорт данных в новый.		# Импорт данных в новый.
Line 73:		Line 72:

	svacer upload --user <user> --password <pwd> --host <host> --port <rest port> --grpc <grpc port> <path to store>		svacer upload --user <user> --password <pwd> --host <host> --port <rest port> --grpc <grpc port> <path to store>

	~~=== Миграция между версиями Svacer ===~~
	Миграция БД PostgreSQL и object store между версиями Svacer происходит автоматически при обновлении на новую версию. Рекомендуется делать резервные копии перед обновлением (см. раздел [[Help:Backup#Создание и восстановление резервной копии\|Создание и восстановление резервной копии]]).

	~~Ниже описаны существенные изменения при переходе на определенную версию с более старой~~
	* 4.0.1 и выше — миграция object store (badger) на новую версию. Может занимать существенное время при большом количестве проектов в Svacer. После перехода на версию 4.0.1 и выше object store становится несовместим с более ранними версиями
	* 5.0.0 и выше — перенос DXR разметки из PostgreSQL в object store. Версии 5.0.0 и выше не совместимы с более ранними версиями.

Akuzmin: svace-migration.jar is not included starting from 8.0.0

2023-11-21T14:05:22Z

svace-migration.jar is not included starting from 8.0.0

← Older revision		Revision as of 17:05, 21 November 2023
Line 6:		Line 6:
	# Импорт данных в новый.		# Импорт данных в новый.

	Для экспорта информации со старого Svace сервера используется утилита '''svace-migration.jar'''		Для экспорта информации со старого Svace сервера используется утилита '''svace-migration.jar'''. Начиная с релиза 8.0.0 она не входит в дистрибутив Svacer, но можете взять из [[Svacer#Предыдущие_релизы\|предыдущих релизов]].

	java -jar svace-migration.jar <user> <password> <path to svace> <path to server dir> <path to output dir>		java -jar svace-migration.jar <user> <password> <path to svace> <path to server dir> <path to output dir>

Akuzmin: move backup part to a separate page

2023-08-22T12:53:00Z

move backup part to a separate page

Show changes

Akuzmin: minor fixes

2023-08-07T11:59:37Z

minor fixes

← Older revision		Revision as of 14:59, 7 August 2023
Line 111:		Line 111:

	==== Создание резервной копии svacer object store через command line API ====		==== Создание резервной копии svacer object store через command line API ====
			Этот способ хорошо подходит в случае, если object store достаточно большой (десятки гигабайт или больше) и не желательно останавливать сервер Svacer.
	Резервную копию object store можно создать, использовав следующую команду (доступна только пользователю с ролью admin)		Резервную копию object store можно создать, использовав следующую команду (доступна только пользователю с ролью admin)

	svacer server backup --user admin --password <password> --file <filename>.kvbak		svacer server backup --user admin --password <password> --file <filename>.kvbak

	В результате object store будет сохранен в файл '''<filename>.kvbak'''. Этот способ хорошо подходит в случае, если object store достаточно большой (десятки гигабайт или больше) и не желательно останавливать сервер Svacer.		В результате object store будет сохранен в файл '''<filename>.kvbak'''

	Для восстановления из резервной копии требуется при запуске сервера указать этот файл в опции '''--load-from-backup'''.		Для восстановления из резервной копии требуется при запуске сервера указать этот файл в опции '''--load-from-backup'''.

Akuzmin: some clarifications regarding object store backup

2023-08-07T11:58:08Z

some clarifications regarding object store backup

Akuzmin: /* Создание резервной копии svacer object store через command line API */ fix --

2023-07-06T16:34:28Z

Создание резервной копии svacer object store через command line API: fix --

← Older revision		Revision as of 19:34, 6 July 2023
Line 119:		Line 119:
	Для восстановления из резервной копии требуется при запуске сервера указать этот файл в опции '''--load-from-backup'''.		Для восстановления из резервной копии требуется при запуске сервера указать этот файл в опции '''--load-from-backup'''.

	svacer server --pg <postgres_url> ~~—store~~ /home/svacer/new-store --load-from-backup <filename>.kvbak		svacer server --pg <postgres_url> --store /home/svacer/new-store --load-from-backup <filename>.kvbak

	Восстановление возможно только в пустой object store. То есть в данном примере директория '''/home/svacer/new-store''' должна быть пустой.		Восстановление возможно только в пустой object store. То есть в данном примере директория '''/home/svacer/new-store''' должна быть пустой.

Akuzmin at 11:04, 12 January 2023

2023-01-12T11:04:24Z

← Older revision		Revision as of 14:04, 12 January 2023
Line 205:		Line 205:
	[[File:BranchMenu.png\|none\|left\|alt=BranchMenu windows]]		[[File:BranchMenu.png\|none\|left\|alt=BranchMenu windows]]

	Задача по экспорту снимка может занимать значительное время (зависит от размера снимка) и выполняется асинхронным образом. Извещение о завершении задачи по экспорту появится в виде всплывающей зеленой панели ~~а так же будет доступно в панели нотификаций:~~		Задача по экспорту снимка может занимать значительное время (зависит от размера снимка) и выполняется асинхронным образом. Извещение о завершении задачи по экспорту появится в виде всплывающей зеленой панели

	[[File:Notifications.png\|none\|left\|alt=Notifications window]]		[[File:Notifications.png\|none\|left\|alt=Notifications window]]

			А так же будет доступно в панели нотификаций

	[[File:NotificationsClearAll.png\|none\|left\|alt=NotificationsClearAll window]]		[[File:NotificationsClearAll.png\|none\|left\|alt=NotificationsClearAll window]]

← Older revision		Revision as of 14:58, 7 August 2023
Line 115:		Line 115:
	svacer server backup --user admin --password <password> --file <filename>.kvbak		svacer server backup --user admin --password <password> --file <filename>.kvbak

	В результате object store будет сохранен в файл '''<filename>.kvbak'''		В результате object store будет сохранен в файл '''<filename>.kvbak'''. Этот способ хорошо подходит в случае, если object store достаточно большой (десятки гигабайт или больше) и не желательно останавливать сервер Svacer.

	Для восстановления из резервной копии требуется при запуске сервера указать этот файл в опции '''--load-from-backup'''.		Для восстановления из резервной копии требуется при запуске сервера указать этот файл в опции '''--load-from-backup'''.
Line 124:		Line 124:

	==== Создание резервной копии svacer object store в сервере PostgreSQL ====		==== Создание резервной копии svacer object store в сервере PostgreSQL ====
	Резервную копию object store можно сохранить в сервере PostgreSQL, который используется сервером Svacer. Данный механизм использует функциональность large object store из PostgreSQL. ~~Функциональность по бэкапу~~ object store в ~~PostgreSQL является '''рекомендуемой стратегией''' по бэкапу object store~~.		Резервную копию object store можно сохранить в сервере PostgreSQL, который используется сервером Svacer. Данный механизм использует функциональность large object store из PostgreSQL. Этот способ хорошо подходит в случае, если object store не очень большой, в пределах нескольких гигабайт.

	Следующие команды подразумевают, что сервер развернут с портами по умолчанию на localhost. При необходимости, порты и адрес сервера могут быть указаны как дополнительные опции.		Следующие команды подразумевают, что сервер развернут с портами по умолчанию на localhost. При необходимости, порты и адрес сервера могут быть указаны как дополнительные опции.
Line 159:		Line 159:

	где <lower> и <upper> нижняя и верхняя граница ID бэкапов.		где <lower> и <upper> нижняя и верхняя граница ID бэкапов.

	Настоятельно рекомендуется настроить задачу на хосте, где работает Svacer на периодический запуск бэкапа object store в PostgreSQL.

	==== Создание резервной копии svacer object store вручную ====		==== Создание резервной копии svacer object store вручную ====
	Создать резервную копию object store ~~также~~ возможно вручную. Для этого достаточно скопировать директорию, в которой object store находится. Перед ~~тем как это делать~~ желательно остановить сервер Svacer ~~в целях~~ обеспечения целостности данных.		Создать резервную копию object store возможно вручную. Для этого достаточно скопировать директорию, в которой object store находится. Перед этим желательно остановить сервер Svacer для обеспечения целостности данных. Этот способ хорошо подходит в случае, если object store достаточно большой (десятки гигабайт или больше) и возможно останавливать сервер Svacer. Для инкрементального бэкапа в данном случае можно использовать '''rsync'''.

	Если директория, где хранить '''object store''' не была явно указана при запуске сервера, по умолчанию он будет создан в следующей директории:		Если директория, где хранить '''object store''' не была явно указана при запуске сервера, по умолчанию он будет создан в следующей директории: