Help:Installation - Revision history

Akuzmin: /* 12-x-x */ add volumes info

2026-01-19T14:09:18Z

12-x-x: add volumes info

← Older revision		Revision as of 17:09, 19 January 2026
Line 129:		Line 129:
	* Рекомендуем обновить PostgreSQL до версии 15 или выше. С более старыми версиями корректная работа Svacer не гарантируется		* Рекомендуем обновить PostgreSQL до версии 15 или выше. С более старыми версиями корректная работа Svacer не гарантируется
	* Если вы использовали аутентификацию с помощью LDAP в версиях Svacer 5-1-X и у вас не работает механизм тегирования или уведомлений (подписки), см [[LDAP_configuration#Некоторые_замечания_для_пользователей,_которые_использовали_LDAP_в_версиях_Svacer_5-1-X\|решение проблем с отсутствием статуса пользователя в БД]]		* Если вы использовали аутентификацию с помощью LDAP в версиях Svacer 5-1-X и у вас не работает механизм тегирования или уведомлений (подписки), см [[LDAP_configuration#Некоторые_замечания_для_пользователей,_которые_использовали_LDAP_в_версиях_Svacer_5-1-X\|решение проблем с отсутствием статуса пользователя в БД]]
			* В релизе 12 мы добавили имя проекта в [https://svacer.ispras.ru/extra/docker-compose.yml docker-compose.yml]. Оно влияет на названия docker volumes для БД и object store: если раньше имена формировались на основе названия директории, откуда запускался стек, теперь они привязаны к имени проекта и по умолчанию будут <code>svacer_svacer-postgres</code> и <code>svacer_svacer-object-store</code>. Чтобы после обновления docker-compose.yml файла старые вольюмы перенеслись, надо явно указать их имена в секции volumes:
			volumes:
			svacer-postgres:
			name: old-dir-name_svacer-postgres
			external: true
			svacer-object-store:
			name: old-dir-name_svacer-object-store
			external: true

	==== 11-x-x ====		==== 11-x-x ====

Akuzmin: /* Установка и запуск на Windows */ add Windows limitations note and link

2025-12-25T10:27:04Z

Установка и запуск на Windows: add Windows limitations note and link

← Older revision		Revision as of 13:27, 25 December 2025
Line 96:		Line 96:

	=== Установка и запуск на Windows ===		=== Установка и запуск на Windows ===
	~~PostgreSQL нужен только для~~ сервера ~~Svacer, для клиента не требуется.~~		{{Note\|text=При запуске на Windows [[Help:Introduction#Системные_требования\|поддерживается не вся функциональность сервера]]}}
	* Скачайте установщик PostgreSQL для Windows: https://www.postgresql.org/download/windows		* Скачайте установщик PostgreSQL для Windows: https://www.postgresql.org/download/windows
	* Установите PostgreSQL, выбрав, как минимум, компоненты "PostgreSQL Server" и "Command Line Tools"		* Установите PostgreSQL, выбрав, как минимум, компоненты "PostgreSQL Server" и "Command Line Tools"
	* Задайте ~~и запомните~~ пароль на шаге выбора пароля для суперпользователя		* Задайте пароль на шаге выбора пароля для суперпользователя
	* Остальные параметры при установке можно оставить по умолчанию		* Остальные параметры при установке можно оставить по умолчанию
	* После установки PostgreSQL откройте консоль, перейдите в директорию, куда установили PostgreSQL, запустите его клиент с указанием пользователя "postgres" и авторизуйтесь с паролем, заданным во время установки		* После установки PostgreSQL откройте консоль, перейдите в директорию, куда установили PostgreSQL, запустите его клиент с указанием пользователя "postgres" и авторизуйтесь с паролем, заданным во время установки

Akuzmin: fix link

2025-11-28T09:22:19Z

fix link

← Older revision		Revision as of 12:22, 28 November 2025
Line 14:		Line 14:
	Для сборки своего докер-образа Svacer можете использовать [[Dockerfile]] в качестве референса.		Для сборки своего докер-образа Svacer можете использовать [[Dockerfile]] в качестве референса.

	Для указания других параметров сервера можете [[Help:~~Installation~~#Дополнительные параметры при запуске в docker~~-контейнере~~\|переопределить команду запуска]] в docker-compose файле.		Для указания других параметров сервера можете [[Help:Configuration#Дополнительные параметры при запуске в docker\|переопределить команду запуска]] в docker-compose файле.

	=== deb/rpm ===		=== deb/rpm ===

Akuzmin: split into install and config pages

2025-11-28T09:11:28Z

split into install and config pages

Show changes

Akuzmin: minor fixes

2025-11-27T14:28:09Z

minor fixes

← Older revision		Revision as of 17:28, 27 November 2025
Line 127:		Line 127:
	=== Upgrade notes ===		=== Upgrade notes ===
	==== 12-x-x ====		==== 12-x-x ====
	Рекомендуем обновить PostgreSQL до версии 15 или выше. С более старыми версиями корректная работа Svacer не гарантируется.		* Рекомендуем обновить PostgreSQL до версии 15 или выше. С более старыми версиями корректная работа Svacer не гарантируется
			* Если вы использовали аутентификацию с помощью LDAP в версиях Svacer 5-1-X и у вас не работает механизм тегирования или уведомлений (подписки), см [[LDAP_configuration#Некоторые_замечания_для_пользователей,_которые_использовали_LDAP_в_версиях_Svacer_5-1-X\|решение проблем с отсутствием статуса пользователя в БД]]
	Если вы использовали аутентификацию с помощью LDAP в версиях Svacer 5-1-X и у вас не работает механизм тегирования или уведомлений (подписки), см [[~~LDAP configuration~~#~~Некоторые замечания для пользователей, которые использовали LDAP~~, ~~начиная с версии Svacer 5~~-1-~~0 до 5-2-0~~\|~~Решение~~ проблем с ~~отстутствием~~ статуса пользователя в БД]]

	==== 11-x-x ====		==== 11-x-x ====
Line 718:		Line 717:
	Используемая при этом учетная запись должна быть с правами на <code>Server administration</code>		Используемая при этом учетная запись должна быть с правами на <code>Server administration</code>

	При импорте результатов на сервер индексация идет в фоновой ~~задачи. Появление~~ новых данных в результатах поиска может занять некоторое время.		При импорте результатов на сервер индексация идет в фоновой задаче, поэтому появление новых данных в результатах поиска может занять некоторое время.

	== Указание public-url ==		== Указание public-url ==
Line 727:		Line 726:

	=== Переменные окружения ===		=== Переменные окружения ===
	~~Пользователь может~~ использовать следующие переменные окружения для изменения внутренних параметров сервера:		Можно использовать следующие переменные окружения для изменения внутренних параметров сервера:
	{\| class="wikitable"		{\| class="wikitable"
	\|+		\|+
Line 734:		Line 733:
	!Описание		!Описание
	\|-		\|-
	\|~~<code>~~SVACER_TIMEOUT_IMPORT_RESULTS~~</code>~~		\|SVACER_TIMEOUT_IMPORT_RESULTS
	\|15 минут		\|15 минут
	\|Таймаут ожидания процесса начала импорта на сервере. При превышении, запрос на импорт будет отклонен с ошибкой. Формат Go Duration string: 1h2m3s. Переменная затрагивает только ожидание начала, но не ограничивает сам процесс импорта.		\|Таймаут ожидания процесса начала импорта на сервере. При превышении запрос на импорт будет отклонен с ошибкой. Формат — Go Duration string: 1h2m3s. Переменная затрагивает только ожидание начала, но не ограничивает сам процесс импорта
	\|-		\|-
	\|~~<code>~~SVACER_NUM_PARALLEL_IMPORTS~~</code>~~		\|SVACER_NUM_PARALLEL_IMPORTS
	\|(~~<code>~~максимальное число коннектов к БД) / 2~~</code>~~		\|(максимальное число коннектов к БД) / 2
	\|Число одновременных параллельных импортов. Остальные ждут в очереди. На ожидание влияет переменная ~~<code>~~SVACER_TIMEOUT_IMPORT_RESULTS~~</code>~~		\|Число одновременных параллельных импортов. Остальные ждут в очереди. На ожидание влияет переменная SVACER_TIMEOUT_IMPORT_RESULTS
	\|-		\|-
	\|~~<code>~~SVACER_TAIL_LOG_SIZE~~</code>~~		\|SVACER_TAIL_LOG_SIZE
	\|1Мб		\|1Мб
	\|Число. Размер ~~буффера~~ для показа лога сервера в ~~WEB~~. Показывается последние SVACER_TAIL_LOG_SIZE байт из лога.		\|Число. Размер буфера для показа лога сервера в WebUI. Показывается последние SVACER_TAIL_LOG_SIZE байт из лога.
	\|-		\|-
	\|~~<code>~~SVACER_LOG_FORMAT~~</code>~~		\|SVACER_LOG_FORMAT
	\|<пусто>		\|<пусто>
	\|При указании ~~формата~~ json ~~вывод~~ формат лога заменяется на JSON. Предназначено для интеграции с агрегаторами логов. ~~Так же~~ можно указать через флаг при старте		\|При указании 'json' формат вывода лога заменяется на JSON. Предназначено для интеграции с агрегаторами логов. Также можно указать через флаг при старте: <code>svacer-server --log-format=json</code>
	<code>svacer-server --log-format=json</code>
	\|-		\|-
	\|~~<code>~~SVACER_INV_GEN_JOBS~~</code>~~		\|SVACER_INV_GEN_JOBS
	\|0.7 * runtime.GOMAXPROCS		\|0.7 * runtime.GOMAXPROCS
	\|Максимальное число параллельных ~~job-ов~~ для генерации инвариантов при миграции старой базы или импорте результатов.		\|Максимальное число параллельных заданий для генерации инвариантов при миграции старой базы или импорте результатов. При ограниченных ресурсах сервера используйте значение 1 или 2. Нельзя установить значение больше, чем GOMAXPROCS
	При ограниченных ресурсах сервера ~~устанавливать в~~ значение 1 или 2. ~~Пользователь не может увеличить~~ больше, чем GOMAXPROCS
	\|-
	\|
	\|
	\|
	\|}		\|}

	=== Пересчет инвариантов ===		=== Пересчет инвариантов ===
	При миграции со старых версий иногда могут быть проблемы с переносом разметки. Для принудительного пересчета инвариантов ~~пользователь может запустить~~ сервер с опцией <code>--force-invariant-refresh</code>.		При миграции со старых версий иногда могут быть проблемы с переносом разметки. Для принудительного пересчета инвариантов запустите сервер с опцией <code>--force-invariant-refresh</code>.

	=== Объектное хранилище ===		=== Объектное хранилище ===
	При больших размерах объектного хранилища (object store) ~~пользователь может~~ запустить сервер с параметром <code>--compact-object-store</code> - это приведет к поиску недостижимых объектов в ~~объектном~~ хранилище и ~~сокращении~~ размера базы. Операция может занять продолжительное время.		При больших размерах объектного хранилища (object store) можно запустить сервер с параметром <code>--compact-object-store</code> — это приведет к поиску недостижимых объектов в хранилище и сокращению размера базы. Операция может занять продолжительное время.

	'''ЭКСПЕРИМЕНТАЛЬНО''': Для быстрого получения копии текущего объектного хранилища пользователь может использовать CLI команду		'''ЭКСПЕРИМЕНТАЛЬНО''': Для быстрого получения копии текущего объектного хранилища пользователь может использовать CLI команду

	svacer server backup --host <nowiki>http://localhost:8080</nowiki> --user admin --password <admin pwd> --checkpoint <path>		svacer server backup --host <nowiki>http://localhost:8080</nowiki> --user admin --password <admin pwd> --checkpoint <path>
	Данная команда создаст по пути ''<path>'' на '''хосте, где работает сервер''', копию object store. При создании копии по возможности используются hard ~~link-и~~, для ускорения процесса. Процесс работает в ~~background-е и~~ можно запускать для работающего сервера.
			Данная команда создаст по пути <path> на '''хосте, где работает сервер''', копию object store. При создании копии по возможности используются hard links, для ускорения процесса. Процесс работает в фоновом режиме, можно запускать его для работающего сервера.

Chernykov sv: /* Upgrade notes */

2025-11-27T11:22:11Z

Upgrade notes

← Older revision		Revision as of 14:22, 27 November 2025
Line 129:		Line 129:
	Рекомендуем обновить PostgreSQL до версии 15 или выше. С более старыми версиями корректная работа Svacer не гарантируется.		Рекомендуем обновить PostgreSQL до версии 15 или выше. С более старыми версиями корректная работа Svacer не гарантируется.

	Если вы использовали аутентификацию с помощью LDAP в версиях Svacer с 5-1-~~0 по 5-2-0~~ и у вас не работает механизм тегирования или уведомлений (подписки), см [[LDAP configuration#Некоторые замечания для пользователей, которые использовали LDAP, начиная с версии Svacer 5-1-0 до 5-2-0\|Решение проблем с отстутствием статуса пользователя в БД]]		Если вы использовали аутентификацию с помощью LDAP в версиях Svacer 5-1-X и у вас не работает механизм тегирования или уведомлений (подписки), см [[LDAP configuration#Некоторые замечания для пользователей, которые использовали LDAP, начиная с версии Svacer 5-1-0 до 5-2-0\|Решение проблем с отстутствием статуса пользователя в БД]]

	==== 11-x-x ====		==== 11-x-x ====

Chernykov sv: /* 12-x-x */

2025-11-27T10:43:15Z

12-x-x

← Older revision		Revision as of 13:43, 27 November 2025
Line 128:		Line 128:
	==== 12-x-x ====		==== 12-x-x ====
	Рекомендуем обновить PostgreSQL до версии 15 или выше. С более старыми версиями корректная работа Svacer не гарантируется.		Рекомендуем обновить PostgreSQL до версии 15 или выше. С более старыми версиями корректная работа Svacer не гарантируется.

			Если вы использовали аутентификацию с помощью LDAP в версиях Svacer с 5-1-0 по 5-2-0 и у вас не работает механизм тегирования или уведомлений (подписки), см [[LDAP configuration#Некоторые замечания для пользователей, которые использовали LDAP, начиная с версии Svacer 5-1-0 до 5-2-0\|Решение проблем с отстутствием статуса пользователя в БД]]

	==== 11-x-x ====		==== 11-x-x ====

Ruseer: /* Расширенные параметры настройки сервера */

2025-11-27T09:25:11Z

Расширенные параметры настройки сервера

@@ Line 723: / Line 723: @@
 == Расширенные параметры настройки сервера ==
 Пользователь может использовать следующие переменные окружения для изменения внутренних параметров сервера:
 {| class="wikitable"
@@ Line 756: / Line 758: @@
+|
 |}

Ruseer: /* Полнотекстовый поиск */

2025-11-26T11:04:38Z

Полнотекстовый поиск

← Older revision		Revision as of 14:04, 26 November 2025
Line 715:		Line 715:

	Используемая при этом учетная запись должна быть с правами на <code>Server administration</code>		Используемая при этом учетная запись должна быть с правами на <code>Server administration</code>

			При импорте результатов на сервер индексация идет в фоновой задачи. Появление новых данных в результатах поиска может занять некоторое время.

	== Указание public-url ==		== Указание public-url ==

Ruseer: /* Расширенные параметры настройки сервера */

2025-11-26T10:32:24Z

Расширенные параметры настройки сервера

← Older revision		Revision as of 13:32, 26 November 2025
Line 736:		Line 736:
	\|Число одновременных параллельных импортов. Остальные ждут в очереди. На ожидание влияет переменная <code>SVACER_TIMEOUT_IMPORT_RESULTS</code>		\|Число одновременных параллельных импортов. Остальные ждут в очереди. На ожидание влияет переменная <code>SVACER_TIMEOUT_IMPORT_RESULTS</code>
	\|-		\|-
	\|SVACER_TAIL_LOG_SIZE		\|<code>SVACER_TAIL_LOG_SIZE</code>
	\|1Мб		\|1Мб
	\|Число. Размер буффера для показа лога сервера в WEB. Показывается последние SVACER_TAIL_LOG_SIZE байт из лога.		\|Число. Размер буффера для показа лога сервера в WEB. Показывается последние SVACER_TAIL_LOG_SIZE байт из лога.
	\|-		\|-
	\|SVACER_LOG_FORMAT		\|<code>SVACER_LOG_FORMAT</code>
	\|<пусто>		\|<пусто>
	\|При указании формата json вывод формат лога заменяется на JSON. Предназначено для интеграции с агрегаторами логов. Так же можно указать через флаг при старте		\|При указании формата json вывод формат лога заменяется на JSON. Предназначено для интеграции с агрегаторами логов. Так же можно указать через флаг при старте
	<code>svacer-server --log-format=json</code>		<code>svacer-server --log-format=json</code>
	\|-		\|-
	\|SVACER_INV_GEN_JOBS		\|<code>SVACER_INV_GEN_JOBS</code>
	\|0.7 * runtime.GOMAXPROCS		\|0.7 * runtime.GOMAXPROCS
	\|Максимальное число параллельных job-ов для генерации инвариантов при миграции старой базы или импорте результатов.		\|Максимальное число параллельных job-ов для генерации инвариантов при миграции старой базы или импорте результатов.