Help:Installation - Revision history

Akuzmin: add object store location disclaimer

2026-06-18T11:43:50Z

add object store location disclaimer

← Older revision		Revision as of 14:43, 18 June 2026
Line 69:		Line 69:
	SVACER_ARGS="--pg postgres://<user>:<password>@127.0.0.1:5432/<database>"		SVACER_ARGS="--pg postgres://<user>:<password>@127.0.0.1:5432/<database>"

	В этой же строке можно указать прочие аргументы для запуска сервера Svacer.		В этой же строке можно поменять путь к object store и указать прочие аргументы для запуска сервера Svacer.

			SVACER_ARGS="... --store /mnt/hdd/svacer_object_store --port 8090"

	На Astra Linux необходимо в файле '''/etc/parsec/mswitch.conf''' установить параметр <code>zero_if_notfound: yes</code>, иначе при запуске Svacer будет ошибка подключения к БД вида		На Astra Linux необходимо в файле '''/etc/parsec/mswitch.conf''' установить параметр <code>zero_if_notfound: yes</code>, иначе при запуске Svacer будет ошибка подключения к БД вида
Line 101:		Line 103:
	alter user svace superuser;		alter user svace superuser;
	* Выйдите из консоли PostgreSQL		* Выйдите из консоли PostgreSQL
	* Запустите '''svacer-server.exe''' из консоли с указанием параметров подключения к БД. Если ~~при создании пользователя~~ и БД PostgreSQL ~~вы использовали для них имя~~ по умолчанию 'svace', как в примере выше, то указывать данные для подключения к БД при запуске сервера не обязательно		* Запустите '''svacer-server.exe''' из консоли с указанием параметров подключения к БД. Если пользователь и БД PostgreSQL были созданы с именем по умолчанию 'svace', как в примере выше, то указывать данные для подключения к БД при запуске сервера не обязательно
	svacer-server.exe run		svacer-server.exe run
	* Если ~~создавали пользователя~~ или БД с другими ~~именами~~, то при запуске сервера надо указать их явно		* Если пользователь или БД были созданы с другими названиями, то при запуске сервера надо указать их явно. Также, для большего контроля за расположением данных, при запуске в production рекомендуем явно указывать путь к object store, чтобы избежать его создания в директории по умолчанию <code>%LocalAppData%\svacer</code>.
	svacer-server.exe run --pg postgres://svacer_user:svacer_password@127.0.0.1:5432/svacer_database		svacer-server.exe run --pg postgres://svacer_user:svacer_password@127.0.0.1:5432/svacer_database --store D:\\svacer-object-store
	* После запуска сервера его веб-интерфейс будет доступен по адресу http://localhost:8080, логин / пароль — admin / admin		* После запуска сервера его веб-интерфейс будет доступен по адресу http://localhost:8080, логин / пароль — admin / admin

Akuzmin: remove html-based pdf generation docs

2026-06-16T12:41:25Z

remove html-based pdf generation docs

← Older revision		Revision as of 15:41, 16 June 2026
Line 38:		Line 38:
	sudo systemctl enable postgresql-17		sudo systemctl enable postgresql-17
	sudo systemctl start postgresql-17		sudo systemctl start postgresql-17

	~~==== Браузер для PDF-отчетов ====~~
	Для создания PDF-отчетов с использованием нового HTML-генератора установите браузер Google Chrome на машину, где запускается сервер Svacer. Рекомендуется устанавливать из официального репозитория, следуя [https://www.google.com/chrome/?platform=linux инструкции с сайта google].

	{{Note\|type=info\|text=Рекомендуемые системные требования при генерации PDF-отчетов для больших проектов с использованием HTML-генератора: Intel Core i9, 64 GB RAM, SSD, видеокарта Nvidia}}

	При запуске Svacer проверит доступность браузера для генерации PDF. Если он не установлен или генерация не работает, будет использован нативный генератор: менее продвинутый, но для него не нужен браузер. Можно явно включить использование нативного генератора, передав опцию <code>--pdf-generator=native</code> при запуске сервера Svacer.

	При невозможности установить Google Chrome, например если нет пакета для вашего дистрибутива Linux, можно установить Chromium. Его пакет в репозиториях, в зависимости от вышей ОС, может называться <code>chromium-browser</code> или <code>chromium</code>. В некоторых случаях генерация с Chromium может не работать. Например, если Svacer установлен из deb-пакета, а Сhromium из snap (на Ubuntu он устанавливается именно так даже при использовании apt) и сервер Svacer запускается от отдельного системного пользователя, от которого Chromium не может запуститься. В этом случае установите Google Chrome, с ним генерация работает.

	==== Svacer ====		==== Svacer ====

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: @@
+|
 |}