¶ Требования
Обязательно наличие библиотеки dotnet 8.0. Его нужно скачать с сайта Microsoft
¶ Описание
Служба содержит логику для доступа посетителей через турникеты. Имеет вэб-интерфейс с журналом проходов и тестом проходов по адресу http://localhost:порт/web . Есть свагер по адресу http://localhost:порт/swagger
¶ Установка и настройка службы
¶ Создание Базы данных
Для работы требуется создать отдельную базу данных, где будет храниться информация по проходам. Для этого нужно:
- скачать программу Bars.DatabaseInstaller актуальной версии (121+) на сервер
- запустить файл Bars.DatabaseInstaller.Gui.Desktop.exe
- выбрать модуль "Барс. Служба доступа"
- В выборе операции кликнуть на "Установка последней версии" и заполнить параметры
- дождаться создания базы
Если по какой-то причине нет доступа к инсталятору БД, то всё можно сделать в ручном режиме:
- Распаковать архив со службой Bars.Access куда-нибудь на сервер (Например, "D:\BarsAccess")
- Заполнить файл db.conf в корневой директории службы.
{
"ConnectionString": "Server=server; User ID=sa; Password=pwd; Encrypt=False",
"Plugin": "BarsAccessServerDbMaintenance",
"DbType": "MSSQL",
"DbName": "bars_access_events"
}
файл в формате json, поэтому нужно быть внимательным с запятыми и форматом строки подключения (Server=сервер\\экземпляр)
Если директории для файла БД не существует, необходимо предварительно её создать.
- Далее либо через командную строку, либо создав ярлык и запустить с ключами:
[db] install -c db.conf -path "D:\Путь, где будет БД" - Проследить, что база создалась. Если файл заполнен неверно, то в консоль выведится ошибка.
¶ Установка службы
- На сервер, где работают остальные службы Барса скачать и распаковать службу Bars.Access.Service_vX.X.X_build.XXXX_win-x64
- Запустить службу 1 раз, чтобы создалась папка configs
- Заполнить файл "appsettings.Production.json"
Обязательные поля для заполнения:
"Urls": "http://*:порт", - адрес:порт службы Аксеса
//База барса 2:
"BarsDbConnectionString": "Server=сервер;Database=база;Trusted_Connection=false;uid=логин;pwd=пароль;Encrypt=False",
//База для событий проходных, которую создали в предыдущих шагах:
"BarsAccessDbConnectionString": "Server=база;Database=bars_access_events;Trusted_Connection=false;uid=логин;pwd=пароль;Encrypt=False",
...
"CorsAllow": null,
"PassOptions": {
"ConfirmationTimeout": 10.0, // ожидание подтверждения прохода
},
// Следующие опции остаются неизменными:
"PassLifecycle": {
"CheckPassIntervals": [
"00:00:10",
"00:00:20",
"00:00:25",
"00:00:30",
"00:00:45",
"00:00:45",
"00:01:00",
"00:01:00",
"00:02:00",
"00:03:00",
"00:05:00",
"00:05:00",
"00:10:00",
"00:15:00",
"00:15:00",
"01:00:00",
"02:00:00",
"04:00:00",
"06:00:00",
"10:00:00",
"1.00:00:00"
],
"ExpirationTime": "7.00:00:00"
},
"UseTaxMappings": false,
"IndexPath": ".\\web",
"PublicPath": ".\\web\\public",
"EntryPointSettings": {
"PingDelay": 60,
"ServiceGuid": "d573f039-ae79-4469-a67b-6b5a357bd760",
"EntryPointAddress": "api/v0/",
"ThisServiceAddress": "",
"Settings": null
},
"AllowedHosts": null
- Сохранить, затем запустить файл Bars.Access.exe ещё раз, проверить что нет ошибок и служба функционирует.
- Добавить используемые порты в исключения брандмауэра и антивируса, чтобы исключить внезапные проблемы
- Сделать тестовые проходы, убедиться, что всё функционирует
- Установить и запустить приложение в качестве службы Windows, прописав в консоль команду:
sc.exe create Bars.Access start= auto binpath= {Path}
Важно, между binpath= и {Path} должен быть пробел