Doc No.

BiomAPI/341/001 Installation Manual

BiomAPI
Installation Manual

CONFIDENTIAL Precision Biometric India Pvt Ltd 1 of 26

Doc No. BiomAPI/341/001 Installation Manual

Document Information
Attribute Value
Document Name BiomAPI v3.11.5 Installation Manual CSD200
Document # BMS/16/BiomAPI/341/001
Date Created 14th March 2017
Author Balasubramaniyan
Version 1.0

Version Changes
Version Modification
Modified by Changes done
# Date
1.0 th
14 Mar 2017 Balasubramaniyan

CONFIDENTIAL Precision Biometric India Pvt Ltd 2 of 26

Doc No. BiomAPI/341/001 Installation Manual

Table of Contents

TABLE OF CONTENTS 3
COPYRIGHT INFORMATION 4
I. PROCEDURE: 5
1) SOFTWARE REQUIREMENTS 5
2) .NET FRAMEWORK INSTALLATION 5
3) PACKAGE INSTALLATION 9
4) TEST THE SCANNER 17
ANNEXURE A - FREQUENTLY ASKED QUESTIONS (FAQ): 18
ANNEXURE B -SUPPORT CONTACT DETAILS 26

CONFIDENTIAL Precision Biometric India Pvt Ltd 3 of 26

Doc No. BiomAPI/341/001 Installation Manual

Copyright Information

This Software is the proprietary product of Precision Biometric and is protected by the
copyright laws and international provisions. You may not use, copy, modify, or transfer the
software or documentation, or any copy, except as expressly provided in this agreement.

CONFIDENTIAL Precision Biometric India Pvt Ltd 4 of 26

Doc No. BiomAPI/341/001 Installation Manual

I. Procedure:

The following contents will describe the Procedure to install and test the BiomAPI package:
1. Software Requirements
2. .Net Framework Installation
3. Package Installation
4. Test the Scanner

1) Software Requirements

The following tables will describe the minimum hardware and software requirement for
BiomAPI application:

SL Particular Specifications
NO
1 Operating System Windows 7 and above
2 RAM 1 GB and above
3 Hard disk 200 MB free space
4 USB Port at least one USB port should be enabled
5 .Net Framework 4.5
6 Browser Internet explorer, Chrome, Firefox & Opera mini

2) .Net Framework Installation

This section will describes the installation of .Net:

1. Login into the system as administrator.
2. Right click on NDP451-KB2858728-x86-x64-AllOS-ENU.exe and select run as
administrator.
3. .Net framework setup will extract as shown below:

CONFIDENTIAL Precision Biometric India Pvt Ltd 5 of 26

Doc No. BiomAPI/341/001 Installation Manual

4. If the required .net framework version is not installed, the following screen will
appear otherwise go to next step
a) Click on I have read and accept check box and then click on Install

CONFIDENTIAL Precision Biometric India Pvt Ltd 6 of 26

Doc No. BiomAPI/341/001 Installation Manual

b) Click on Close button

c) Click on Restart Now to restart the system

CONFIDENTIAL Precision Biometric India Pvt Ltd 7 of 26

Doc No. BiomAPI/341/001 Installation Manual

5. If .net framework is already installed, the following screen will appear. Click on
Cancel button to cancel the installation.

Click on Yes

CONFIDENTIAL Precision Biometric India Pvt Ltd 8 of 26

Doc No. BiomAPI/341/001 Installation Manual

6. If any compatible higher version is installed, the following screen will appear.
Click on Close button to continue communication service installation.

3) Package Installation

This section will describe you, how to install the BiomAPI Package in your PC
1. Login into the system as administrator.
2. Download the BiomAPI Package to the local system and unzip it.

CONFIDENTIAL Precision Biometric India Pvt Ltd 9 of 26

Doc No. BiomAPI/341/001 Installation Manual

3. Right click the BiomAPI.exe and select Run as Administrator.

4. Please close all running browsers & unplug the fingerprint scanner from the system
and press OK button to proceed the installation otherwise click Cancel button to
cancel the installation.

5. If the BiomAPI is already installed in the local system, the following screen will
appear otherwise proceed to the next step
a. Click OK and proceed for uninstalling the Package.

b. Open the run prompt ( + R), type appwiz.cpl and press enter. The
following Programs and features window will open

c. Click the BiomAPI to uninstall the application.

d. Click on ok to continue the uninstallation

CONFIDENTIAL Precision Biometric India Pvt Ltd 10 of 26

Doc No. BiomAPI/341/001 Installation Manual

e. Click the close button to close the uninstallation wizard.

f. Click on yes to restart the system (Restart the system is mandatory).

CONFIDENTIAL Precision Biometric India Pvt Ltd 11 of 26

Doc No. BiomAPI/341/001 Installation Manual

6. Login into the system as administrator

7. Right click the BiomAPI.exe and select Run as Administrator.

8. Please close all running browsers & unplug the fingerprint scanner from the system
and press OK button to proceed the installation otherwise click Cancel button to
cancel the installation.

9. Click on I Agree

CONFIDENTIAL Precision Biometric India Pvt Ltd 12 of 26

Doc No. BiomAPI/341/001 Installation Manual

10. Click on Install> to continue the installation otherwise click Cancel to cancel the
installation.

11. If any of the following screen appears, Click on Abort, then uninstall the BiomAPI
(check the point 5 for more details), if it is installed and restart the system to start
the installation from step 1.

CONFIDENTIAL Precision Biometric India Pvt Ltd 13 of 26

Doc No. BiomAPI/341/001 Installation Manual

CONFIDENTIAL Precision Biometric India Pvt Ltd 14 of 26

Doc No. BiomAPI/341/001 Installation Manual

12. If the following screen appears, click on Allow access

13. Click on Next to start the device driver installation.

CONFIDENTIAL Precision Biometric India Pvt Ltd 15 of 26

Doc No. BiomAPI/341/001 Installation Manual

14. Click on Finish to complete the driver installation

15. Click Close button to complete the installation

CONFIDENTIAL Precision Biometric India Pvt Ltd 16 of 26

Doc No. BiomAPI/341/001 Installation Manual

16. Save all the data and press Yes to reboot the system now otherwise No to ignore the
reboot.

Note:
It is highly recommended to reboot the system after successful installation of BiomAPI.

4) Test the Scanner

The following procedure will describe to check whether the scanner is working correctly:
a. Connect the fingerprint scanner to the system
b. Move to the Installation folder. (Default installation folder will be C:\Program
Files\Precision Biometric\BiomAPI in x86 based system and C:\Program Files
(x86)\Precision Biometric\BiomAPI in x64 based system).
c. Locate PrecisionScannerTest.htm
d. Open PrecisionScannerTest.htm with Internet Explorer.
e. At the bottom of the browser window, there will be a pop-up, click Allow blocked
content.

f. Click Test Scanner button.

CONFIDENTIAL Precision Biometric India Pvt Ltd 17 of 26

Doc No. BiomAPI/341/001 Installation Manual

g. Click Yes

h. Provide your Finger as per the instructions mention in the fingerprint GUI.
i. Start using your application.

Annexure A - Frequently Asked Questions (FAQ):

Are you still facing problem in using the Biometric SDK after installing it? Please look in to
the following section.

1) How to configure the Biometric client package in Internet Explorer?

1. Add the application IP address or URL in the Trusted Sites

a) In internet explorer, Click Tools and then Internet Option
b) Click Security tab, then click Trusted Sites > Sites.
c) Type the IP address into the Add this web site to the zone field, click Add.
d) Server IP address is added to the websites field.

2. Change the Active x Settings

2.1 Go to Control Panel > Internet Options
2.2 Click the security tab and then click the Trusted Sites
2.3 Click the Custom level button
2.4 Select enable for Download signed ActiveX Controls and Initialize and script
Active x controls not marked as safe for scripting as shown in the figure

CONFIDENTIAL Precision Biometric India Pvt Ltd 18 of 26

Doc No. BiomAPI/341/001 Installation Manual

3. Turn off popup blocker

a) Clicks Tools and then Internet options
b) Go to privacy tab
c) Make sure that Turn on pop blocker is not checked

4. If it is internet explorer 9 and above, Disable ActiveX filter

a) Go to Settings and then safety
b) Make sure that ActiveX Filtering is not checked

CONFIDENTIAL Precision Biometric India Pvt Ltd 19 of 26

Doc No. BiomAPI/341/001 Installation Manual

5. Clear the cache and cookies in the browsers

a) In Internet Explorer, Click Settings then Internet options and in General tab,
b) Click the Delete button
c) Select the checkbox for Cookies, Temporary Internet Files and Preserve Favorites
website Data
d) Click Delete

CONFIDENTIAL Precision Biometric India Pvt Ltd 20 of 26

Doc No. BiomAPI/341/001 Installation Manual

2) Is there no response after clicking the fingerprint capture button in

PrecisionTestScanner.htm in internet explorer?

If your answer is yes. Please do the following steps to fix the issue.
1. Go to Tools->Internet Options, Click Advanced tab and uncheck the Disabling Script
Debugging (Internet explorer) and then press ok to close the wizard.
2. Open the PrecisionTestScanner.htm in internet explorer and do the process as listed
in the Testing the scanner section
3. If the internet explorer give the following error

a. Login into the system as Administrator and close the all the running Internet
Explorer before doing the following steps
b. Go to start->All programs->Accessories->command prompt, if the OS above
Windows XP right click it and select Run as Administrator otherwise just click it
to open
c. Go to the system32 folder location, in case of x86 based system and syswow64,
in case of x64 based system. Type regsvr32 BIOM_API.dll and press enter.
d. Click ok

e. If the command prompt gives any error, please check the below
i. If the following error appears, please check whether you have the
administrator privilege to run the batch file or make sure that gone
through the above steps properly.

CONFIDENTIAL Precision Biometric India Pvt Ltd 21 of 26

Doc No. BiomAPI/341/001 Installation Manual

ii. If any other error appears, please contact the support team for further
assistance or make a screen shot of the error and drop a mail to the
support team or concern person
4. After success completion of above steps, test the scanner using the
PrecisionTestScanner.htm.

3) Is there no response after clicking the fingerprint capture button in the application URL
in internet explorer?
1. Make sure that fingerprint scanner is working properly in the PrecisionTestScanner.htm
which is present in the Biometric Package installation location.
2. If it is not working, please check the 1 section to fix this issue otherwise go to the next
step
3. Check whether the application URL is added in the trusted sites
a. In Tools->Internet options, Go to security tab and select the Trusted Sites
b. Click the button Sites
c. Check the whether Application URL is added in the trusted sites, if not please go
to the Configuring Internet explorer(sec. 1) to know the step for doing the same.
4. Check whether the Activex Settings are configured properly as listed below:
a. In Tools->Internet options, Go to Security tab and select the Trusted Sites
b. Click the button Custom level
c. Make sure that the following settings are properly configured under Activex
Controls and Plugins

i. Allow previously unsed ActiveX to run with out prompt - Enable

ii. Run ActiveX control and - Enable

CONFIDENTIAL Precision Biometric India Pvt Ltd 22 of 26

Doc No. BiomAPI/341/001 Installation Manual

iii. Script ActiveXcontrol marked safe for scripting - Enable

iv. Only allow approved domains to use ActiveX without prompt -Disable

v. Allow Activex filtering (only in IE 10) -Disable

vi. Download Signed Activex Controls - Enable

vii. Initialize and script Activex Controls not safe for scripting - Enable

d. Go to Security Tab and enable Scripting

CONFIDENTIAL Precision Biometric India Pvt Ltd 23 of 26

Doc No. BiomAPI/341/001 Installation Manual

4) If you get the message box as Check whether the service is running or not.

1. Go to Services.msc, then go to PrecisionBiometricService and Click Start.

5) If you get the message box as No scanner found, check the scanner connected properly

This message will appear due to the following reasons:

1. Scanner may be unplugged from the system
2. USB Port may have some problem
3. Device Driver may not be installed properly
To resolve these issue,
1. Check the scanner system connectivity
2. If you still have the same problem, unplug the device and connect it in other usb
port (Try in all available USB port).
3. If you still have the same problem, Login into the system as administrator.
4. Open the Device Manager and check for the biometric device

CONFIDENTIAL Precision Biometric India Pvt Ltd 24 of 26

Doc No. BiomAPI/341/001 Installation Manual

5. If you are not able to find the device or find the device with exclamatory (!) Or
question (?) mark, Go to the BiomAPI installation folder and install the
appropriate driver.
If you are still facing the problem, contact the Precision Biometric Technical Team or
write us (biometricsupport@precisionit.co.in) about the error or contact the support team
or concern person.

6) If you get the message box as Legend License Not found

This message will appear due to the following reasons:

1. License may not be obtained from Precision.
2. License may not be deployed correctly.
3. The License may be invalid or corrupted.
To resolve these issue,
1. Check whether you have purchased the License form Precision.
2. To obtain, go to the BiomAPI installation location, open the folder License and
Right click the License Manager.exe, select Run as administrator.
3. Click on Generate button

4. Once the ID has been generated, click on the Save to save the id in a file and send
the same to Precision Biometric Support (biometricsupport@precisionit.co.in).
5. Precision will the share the license file.
6. Download the license file to the local system, click on Deploy button and select
the license file
7. Go to Run, type Services.msc and then restart the PrecisionBiometricService.
8. Click on Verify button to verify the license.

CONFIDENTIAL Precision Biometric India Pvt Ltd 25 of 26

Doc No. BiomAPI/341/001 Installation Manual

If you are still facing the problem, contact the Precision Biometric Technical Team or write
us (biometricsupport@precisionit.co.in) about the error or contact the support team or
concern person.

Annexure B -Support Contact Details

For any assistance feel free to contact Precision Biometric India Private Ltd. Support Team.

Phone number : +91 44 33775210

Email: biometricsupport@precisionit.co.in

CONFIDENTIAL Precision Biometric India Pvt Ltd 26 of 26