BioStar 2 - My BioMini USB Scanner does not work - Troubleshooting BioMini

BioStar 2 - My BioMini USB Scanner does not work - Troubleshooting BioMini

Biomini is the USB fingerprint reader used for biometric enrollment. 

Supported devices in BioStar 2 are shown in the link below: 

[Both BioStar] Biomini and Biomini Plus support


Biomini agent / USB Agent needs to be installed in the client PC in order to recognize the device in BioStar 2. 

You can download the program from Setting > Usb Agent of BioStar 2 web client


Terminology 

Up to BioStar 2.3, the program was called Biomini Agent because only biomini was used with the program. 

However in BioStar 2.4 the program's name changed to USB Agent because it now supports DE-620 as well. 



Configuration


Note: Although you have a option to check 'run on Windows startup', the USB Agent will not run automatically (up to BioStar 2.5) because of a bug. 

You will have to run USB Agent manually in the Windows start menu when you restart your PC.

[This feature does not work up to BioStar 2.5] 


1. Install the latest driver

First check that the latest fingerprint driver is installed (version 2.2)

Direct download link: 

Sup_Fingerprint_Driver_v2.2.0.exe

http://gofile.me/471Oh/5xHcJBB5N


Note: unplug the Biomini when you are installing the driver.

The driver can also be found at the EasySecure website under software -> BioStar

t.




2. Check Device manager

Open device manager and check that Suprema Fingerprint Scanner is detected properly. 


3. Check USB Agent Certification

USB Agent is running. You can search it in the Windows start menu. 


Once the program is running right click on the USB Agent icon on the system tray and click Setup.


Click Enroll Certificates and click Yes when a Security Warning popup appears to enroll the certificate. 


Restart the service by clicking Stop and then Start 


4. Check the BioStar 2 Device menu

If  all settings are configured properly, the device should appear as a USB device on the Device menu. 


    


Troubleshooting


1. Check if the USB Agent port is being used by another service 

You currently (BioStar 2.5) cannot change the default port use of the USB Device Agent of 8081 and 8082 because of a UI bug. 

Check that port 8081 and 8082 is not being used by another service.  

Refer to the guide below: 

[General] Checking Port Usage in Windows

If another service is using port 8081 and 8082 then service will crash or 'Started' will be not shown when you click Start.
Remove the other service that is using the same ports. 


Or you can change the Biomini Agent port in BioStar 2.6 as desired and above as shown below: 

[BioStar 2] Changing Biomini / USB Agent Port


If you must change the USB Agent port in BioStar 2.5 or below refer to the guide below: 

[Known Issue] Biomini Agent / USB Agent Port Cannot be Changed


2. Change Access privileges
If you're getting the error below every time when scanning the fingerprint with Biomini, it is likely that USB Agent is being run with insufficient privileges.


In that case stop the process first in Task Manager.

In BioStar 2.3 or below the service will appear as Biomini-Agent.exe *32


In BioStar 2.4 and above the service will appear as usb-agent.exe *32


Search the Biomini Agent / USB Agent in Windows Start menu and select the Properties menu after a right click. 


Check Run this program and an administrator on the compatibility tab and click OK


Run Biomini Agent / USB Agent again. 




3. Check the API

If you are using a proxy server, you will have to add the localhost as an exception.


You can check if the localhost is working correctly by trying to access the URL below:


localhost:[webserver port]/api/device

The image above shows that the connection is possible and working.


If you get a error message like below even if BioStar 2 service is running, it means that localhost connection is blocked. 



4. Check the USB Agent logs

You can find the USB agent logs in the folder below: 

C:\Program Files (x86)\USB Device Agent\usb-agent\logs


Open the log files to see what errors are appearing. 

Provide the log file to the technical support team when requested. 


    • Related Articles

    • BioStar 2 - How to solve problems enrolling with BioMini

      BioMini is the USB fingerprint reader used for biometric enrollment.  BioMini agent / USB Agent needs to be installed in the client PC in order to recognize the device in BioStar 2.  You can download the program from Setting > USB Agent of BioStar 2 ...
    • EasySecure.cloud - How can I enroll a finger?

      After adding a new user in your EasySecure environment you will arrive in the following screen. To enroll a new finger you have to click the icon 'Finger Templates'.  The following window will become visible:  Please select the scanner you wish to ...
    • EasySecure.cloud - How do I update the BioMiniAgent?

      From 25-04-2020 the license to use your BioMini will expire. The BioMini is the USB scanner that you may use to add new fingers in the software.  This license has been automatically updated in recent days. In the unlikely event that this update was ...
    • BioStar 2 - Hoe verhelp ik problemen bij het inlezen met de BioMini

      In dit document willen we graag uitlegen hoe u problemen kunt verhelpen wanneer u een probleem opmerkt tijdens het inlezen met de BioMini bij inlezen in BioStar 2.   Voordat we beginnen gaan we er vanuit dat de driver ...
    • BioStar 2 - Vingers inlezen werkt niet.

      Kunt u ook maar 1 keer uw vinger inlezen en gaat de pop-up daarna weg, Dit issue komt doordat er een update van Chrome is doorgevoerd. Suprema heeft hiervoor een patch gemaakt. Dit kunt u uitvoeren door de volgende stappen te volgen. Download de usb ...