====== Установка и лицензирование ======	 
Скачать актуальную версию можно по [[https://disk.yandex.ru/d/L6TKrGbZ2eA2jQ|ссылке]].
Модуль поставляется в виде двух zip архивов и установщика драйвера. Для установки распакуйте оба архива с в любую пустую папку. 	 
	 
Файл Driver.exe необходим для нормальной работы оборудования. Его необходимо запустить с правами администратора и произведите процесс установки.	 
	 
В папке profinger_client располагается клиентская часть, которая должна располагаться на устройстве, к которому подключен сканер отпечатка пальцев. В папке profinger_server располагается серверная часть, которая отвечает за хранение отпечатков пальцев.	 
	 
Для запуска модуля потребуется запустить файлы:	 
  * profinger_client/ProFinger_client.exe	 
  * profinger_server/ProFinger_server.exe с ключом /Desktop	 
	 
В процессе запуска возможно появление сообщения от брандмауэра или антивируса с запросом на сетевой доступ для нового приложения - необходимо «Разрешить» доступ. После запуска в папках появятся конфигурационные файлы, в них потребуется внести изменения.	 
	 
===== Настройка сервера =====	 
	 
В архиве с серверной частью располагаются файлы:	 
  * desktop.bat – для запуска в виде приложения (аналог запуска с ключем /desktop)	 
  * install.bat – для установки в качестве службы	 
  * uninstall.bat – для удаления службы	 
  * merge.bat – для миграции старой версии базы данных	 
  * license.bat – для лицензирования	 
	 
**В архиве с клиентской частью располагается только один файл для запуска - ProFinger_client.exe. Клиент может работать только в оконном режиме, поэтому при перезапуске компьютера потребуется повторный запуск клиента.**	 
	 
==== Перенос базы отпечатков из старой версии ПО ====	 
Выполняется в случае, если на объекте ранее была установлена и работала старая версия ( [[external:old:10_biometrics|Авторизация на кассе по отпечатку пальца (устаревшее)]]	 
Для миграции со старой версии на новую, потребуется скопировать файл **dbase_fpsrv.db** из папки со старой версией, в папку с новой, после чего запустить файл **merge.bat**	 
Для корректной синхронизации старых отпечатков, они должны быть добавлены в базу перед запуском клиента! В противном случае, если уже выполнена запуск клиента, то его работу нужно завершить, затем необходимо удалить **storage.db** в папке клиента, затем выполнить миграцию с помощью файла **merge.bat** и запустить клиент повторно.	 
	 
==== Лицензирование ====	 
Получить лицензию, написав письмо на [[info@carbis.ru]].	 
Запустить license.bat	 
Пролицензировать модуль [[https://wiki.carbis.ru/lic/lic#лицензирование_по_на_объекте|по инструкции]]	 
Закрыть окно.	 
{{ :external:2024-08-21_11-07-21_2_.png |}}	 
	 
==== Настройка ====	 
В файле конфигурации ProFinger_server_settings.yaml. В группе значений server необходимо настроить следующие параметры:	 

  * Группа значений log:
    * level: - Уровень логирования (int). По умолчанию 3.
    * retention_days: - Срок хранения .log файлов (int). По умолчанию 3.
  * Группа значений server:
    * host – Адрес в сети. Стандартное значение - 0.0.0.0 (текущий IP адрес компьютера в сети) или значение 127.0.0.1, тогда доступ будет только в рамках текущего компьютера	 
    * port – Порт (минимальный 1000, максимальный 65535)	 
    * token – автоматически генерируется при первом запуске сервера, необходим для подключения клиентов  

===== Настройка клиента =====

Клиент не требует дополнительного лицензирования, достаточно действующей лицензии сервера.

Файл конфигурации ProFinger_client_settings.yaml появляется после первого запуска клиента, после внесения изменений в файл потребуется перезапуск. В файле конфигурации ProFinger_client_settings.yaml может потребоваться редактирование следующих полей: 

  * Группа значений log:
    * level: - Уровень логирования (int). По умолчанию 3.
    * retention_days: - Срок хранения .log файлов (int). По умолчанию 7.
  * Группа значений client:
    * port:  - В параметре нужно передать Порт, который был настроен из пункта [[external:biometrics:05_config:01_nastroika_rkeeper|Подключение веб-интерфейса для регистрации отпечатков пальцев]] (по стандарту значение 8000)
  * Группа значений server:
    * base_url – адрес до сервера (<host>:<port>) где host и port, значениt берется из конфигурации сервера, в файле ProFinger_server_settings.yaml.
    * token – значение сгенерированное сервером, берется из конфигурации сервера, в файле ProFinger_server_settings.yaml.
    * timeout – время ожидания ответа от сервера в секундах, по стандарту 10 секунд.
  * Группа значений rk:
    * station – код Кассовой станции, на которой настраивается текущий клиент
  * Группа значений keeper:
    * manager_host – значение настроенное вами при настройке HTTP-API (127.0.0.1 по стандарту). До версии клиента v2.1.4.5 поле называется host.
    * manager_port – значение порта, настроенное вами при настройке HTTP-API. Порт указан в r_keeper во вкладке Сервис-> Станции и устройства -> Mid -> вкладка Свойства -> HTTP Server -> поле HTTP Data Port.  До версии клиента v2.1.4.5 поле называется port. 
    * cash_host - хост на котором работает интерфейс кассы (127.0.0.1 по стандарту). Поле доступно от версии клиента v2.1.4.5.
    * cash_port - порт на котором работает интерфейс кассы. Порт настраивается в r_keeper во вкладке Сервис-> Станции и устройства -> Cash -> вкладка Свойства -> HTTP Server -> поле HTTP Data Port. (По умолчанию значение может быть не настроено. Поле принимает значения от 1000 до 65535). Поле доступно от версии клиента v2.1.4.5.
    * user – название пользователя, созданного для обращения к HTTP-API
    * password – пароль пользователя, созданного для обращения к HTTP-API

Примеры того, откуда взять порты для сервера и интерфейса кассы:
<hidden>
Пример, где настраивается порт кассового сервера:
{{ :external:biometrics:05_config:2024-11-15_12-41-55.png |}}
Пример, где настраивается порт интерфейса кассы:
{{ :external:biometrics:05_config:2024-11-15_12-46-41.png |}}

</hidden>
**При изменении настроек и/или перезапуске клиента, сканер необходимо переподключить к компьютеру.**


===== Утилита для тестирования сканеров =====
Тестовая утилита, не обязательна к установке. Утилита предназначена для проверки различных моделей сканеров на совместимость с модулем регистрации в системе r_keeper по отпечатку пальца.

Скачать: [[https://disk.yandex.ru/d/sswguJL6CNBMBw|Утилита тестирования]]\\

Использование:
  - Распаковать содержимое архива
  - Установить драйвер Driver.exe
  - Подключить считыватель
  - Запустить "Carbis FP TEST.exe"
    - Утилита найдет и подключится к сканеру (отобразится серийный номер)
    - Считываем отпечатки и наблюдаем результат на экране

{{ :external:carbisfptest.jpg?600 |}}