====== Установка и лицензирование ======
Модуль поставляется в виде двух 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 необходимо настроить следующие параметры:
  * host – Адрес в сети. Стандартное значение - 0.0.0.0 (текущий IP адрес компьютера в сети) или значение 127.0.0.1, тогда доступ будет только в рамках текущего компьютера
  * port – Порт (минимальный 1000, максимальный 65535)
  * token – автоматически генерируется при первом запуске сервера, необходим для подключения клиентов  

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

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

В файле конфигурации ProFinger_client_settings.yaml может потребоваться редактирование следующих полей: 
Группа значений client:
  * Необходимо настроить параметр port, в параметре нужно передать Порт, который был указан в ссылке из пункта настройки подключения веб-интерфейса (по стандарту значение 8000)
Группа значений server:
  * base_url – адрес до сервера (<host>:<port>) где host и port, значения из пункта настроек сервера
  * token – значение сгенерированное сервером, берется из конфигурации сервера
  * timeout – время ожидания ответа от сервера в секундах, по стандарту 10 секунд
Группа значений keeper:
  * host – значение настроенное вами при настройке HTTP-API (127.0.0.1 по стандарту)
  * port – значение порта, настроенное вами при настройке HTTP-API
  * user – название пользователя, созданного для обращения к HTTP-API
  * password – пароль пользователя, созданного для обращения к HTTP-API
Группа значений rk:
  * station – код Кассовой станции, на которой настраивается текущий клиент


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


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

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

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

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