Intelligent Video Analytics Version Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

Transcription

1 Intelligent Video Analytics Version Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

2

3 Intelligent Video Analytics Version Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

4 Note Before using this information and the product it supports, read the information in Copyright notices and trademarks on page 7. Edition This edition applies to IBM Intelligent Video Analytics version 1, release 5, modification 0. This edition applies to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents IBM Intelligent Video Analytics Face Capture Enhancement for i2 Facial Recognition Solution Installation and Configuration Prerequisites Minimum system requirements Installing and configuring Configuring the i2 Facial Recognition server and database Configuring the Smart Surveillance Engine... 2 Enrolling the i2 Facial Recognition Watch List.. 3 Configuring Middleware for Large Scale Surveillance Copyright notices and trademarks... 7 Notices Copyright notice Trademarks Copyright IBM Corp iii

6 iv Intelligent Video Analytics: Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

7 IBM Intelligent Video Analytics Face Capture Enhancement for i2 Facial Recognition Solution Installation and Configuration IBM Intelligent Video Analytics provides facial recognition capability through an external Facial Recognition server. This document explains how you can integrate IBM Intelligent Video Analytics 1.5 with the IBM i2 Facial Recognition Solution (FRS) to enable this capability. This document also explains how you can set up a watch list to implement facial recognition. Prerequisites Before you can install the Face Capture Enhancement for i2 Facial Recognition Solution fix pack for IBM Intelligent Video Analytics, you must ensure that the prerequisite SDK is available. The Face Capture Enhancement for i2 Facial Recognition Solution fix pack for IBM Intelligent Video Analytics is integrated through the IBM i2 Facial Recognition Software Development Kit (FR SDK) v Contact your IBM i2 representative for access to this service asset. Minimum system requirements Before you start to install the Face Capture Enhancement for i2 Facial Recognition Solution fix pack for IBM Intelligent Video Analytics, check that the minimum system requirements are met. The minimum system requirements for this fix pack are as follows: v IBM Intelligent Video Analytics 1.5 is installed, and the Smart Surveillance Engine (SSE) is installed on a 64-bit Windows platform with fixes IVA-PO02325 and IVA-SSE-PO02327 applied. For details on the installation and configuration of SSE, refer to the SSE installation guide. v A database server for Microsoft SQL or Oracle must be available. v A 64-bit Windows platform must be available for the i2 Facial Recognition (FR) server. v The contents of the Face Capture Enhancement for i2 Facial Recognition Solution fix pack for IBM Intelligent Video Analytics must be accessible to these servers. Installing and configuring Installing and configuring Face Capture Enhancement for i2 Facial Recognition solution to work with IBM Intelligent Video Analytics V1.5 About this task Follow these steps to install and configure the components of the Face Capture Enhancement for i2 Facial Recognition solution. Procedure 1. Configuring the i2 Facial Recognition server and database on page 2 2. Configuring the Smart Surveillance Engine on page 2 3. Enrolling the i2 Facial Recognition Watch List on page 3 4. Configuring Middleware for Large Scale Surveillance on page 4 Copyright IBM Corp

8 Configuring the i2 Facial Recognition server and database About this task You must set up the IBM i2 Facial Recognition Software Development Kit to prepare the i2 Facial Recognition server. Procedure 1. Follow the installation instructions in the FR SDK Demo App Setup document that is included in the IBM i2 Facial Recognition Software Development Kit service asset. 2. Check that on the Facial Recognition Server Properties page, the values on the Attributes tab are set as in Table 1. Values not listed in Table 1. should be blank. Table 1. Persons table attributes Attribute Table name Primary key Last name First name Date of birth Gender User field 1 Value dbo.personstable PersonID LastName FirstName DOB Gender Address Configuring the Smart Surveillance Engine About this task Complete the following tasks to configure the Smart Surveillance Engine (SSE) for Face Capture Enhancement for i2 Facial Recognition Solution: Procedure Install the i2 Facial Recognition (FR) Client Control component. 1. On every SSE server: a. Run the i2 FR SDK installer. b. Ensure that the Facial Recognition Server component is not selected for installation. Install and configure Facial Recognition on every SSE server. 2. Extract the installation file IVA-SSE-FR-i2-Integration.zip to a temporary directory available to the SSE server. 3. Copy the file S3FaceRecogDriver_I2.dll from the temporary directory to the SSE installation directory. The default SSE installation directory is C:\Program Files (x86)\ibm\sse4.0 on a 64-bit operating system. 4. Stop the SSE service: a. Run the service management tool on the SSE server: Start > Run > services.msc. The Services window opens. b. Locate and right-click the service IBM SSE 4.0. c. Select Stop. d. Close the Services window. Note: A reboot may be required before you continue. 2 Intelligent Video Analytics: Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

9 5. If the file S3FaceRecogDriver.dll exists in the SSE installation directory, delete it. 6. Rename S3FaceRecogDriver_I2.dll in the SSE installation directory to S3FaceRecogDriver.dll. 7. Copy the i2 Facial Recognition Solution configuration file, S3I2FRServer.cfg, from the temporary directory to the SSE installation directory. 8. Navigate to the SSE installation directory and open the file S3I2FRServer.cfg with your preferred text editor or Notepad. Update the following fields: a. Set ServerIP to the IP address or host name of the i2 Facial Recognition (FR) server. b. Set ServerPort to the port for the i2 FR server. c. Set UserName to a valid user name for the i2 FR server database. d. Set Password to the corresponding password for the i2 FR server database. e. Set MatchThreshold to the facial recognition threshold used to match faces. A typical value of MatchThreshold is 0.6. A lower value of MatchThreshold results in more faces being matched. A higher value of MatchThreshold results in less faces being matched, but with a higher confidence in the matching results. 9. Run the service management tool on the SSE server: Start > Run > services.msc. 10. Restart the SSE service: a. Run the service management tool on the SSE server: Start > Run > services.msc. The Services window opens. b. Locate and right-click the service IBM SSE 4.0. c. Select Start. d. Close the Services window. Enrolling the i2 Facial Recognition Watch List About this task Follow this procedure to add faces to the watch list for Facial Recognition. Procedure 1. Start the i2 SDK Demo tool: C:\Program Files (x86)\ibm\i2 Recognition SDK\SDK Demo App\SDKDemoApp.exe. 2. Enroll a target suspect, as illustrated in Figure 1 on page 4. IBM Intelligent Video Analytics Face Capture Enhancement for i2 Facial Recognition Solution Installation and Configuration 3

10 Figure 1. Video Watch App a. Click Add Person, and enter the name of the suspect and any other known demographic information. b. Click Save to add the suspect to the Person list. c. Select the name of the suspect in the Person list, and click Load Image. d. Select a photo of the suspect. e. Click Enroll Image. 3. Repeat the previous enroll steps until all subjects of interest are enrolled. Note: Images can be enrolled in batches. To do this, click Batch Insert and follow the on-screen instructions. Configuring Middleware for Large Scale Surveillance About this task Set up Facial Recognition alerts to trigger real-time alerts when target subjects are recognized. Procedure To set up real-time alerts, follow these steps: 1. Log on to the Middleware for Large Scale Surveillance (MILS) server Administrator Client (user pvdmin). 2. Create a new view using the Near Field People Search profile. For instructions on creating a view, see the Administrator guide ( 3. In the new Near Field People Search view, click Alert Type and then select Face Recognition from the drop down list. For more details, refer to the context help of the Alert Editor for the usage of the Face Recognition alert by clicking the Help button on the Alert Editor window. Note: The IBM i2 Facial Recognition Software Development Kit (FR SDK) v10.6.0, that is a prerequisite for IBM Intelligent Video Analytics 1.5 Face Capture, does not support name checking. 4 Intelligent Video Analytics: Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

11 The user cannot check if a specified name is already in the FR database. The result of clicking Check on the IVA Face Recognition alert dialog is undefined. The message returned does not indicate that the name is found in the database. 4. To verify the installation, log on to the IBM Intelligent Video Analytics Operator Client, and perform alert searches on detected and recognized subjects. IBM Intelligent Video Analytics Face Capture Enhancement for i2 Facial Recognition Solution Installation and Configuration 5

12 6 Intelligent Video Analytics: Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

13 Copyright notices and trademarks Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd , Nihonbashi-Hakozakicho, Chuo-ku Tokyo , Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Copyright IBM Corp

14 Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Department T81B F6/Building S. Miami Boulevard Durham NC U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information softcopy, the photographs and color illustrations may not appear. Copyright notice Copyright IBM Corporation All rights reserved. May only be used pursuant to an IBM software license agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior written permission of IBM Corporation. IBM Corporation grants you limited permission to make hardcopy or other reproductions of any machine-readable documentation for your own use, provided that each such reproduction shall carry the IBM Corporation copyright notice. No other rights under copyright are granted without prior written permission of IBM Corporation. The document is not intended for production and is furnished as is without warranty of any kind. All warranties on this document are hereby disclaimed, including the warranty of non-infringement and the implied warranties of merchantability and fitness for a particular purpose. U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. 8 Intelligent Video Analytics: Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

15 Trademarks IBM and ibm.com are trademarks of the IBM Corporation in the United States, other countries, or both. Microsoft, Internet Explorer, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Oracle is a registered trademark of Oracle Corporation. Other names may be trademarks of their respective owners. Other company, product, and service names may be trademarks or service marks of others. Visit the IBM Terms of Use website for trademark attribution. Copyright notices and trademarks 9

16 10 Intelligent Video Analytics: Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide

17 Readers Comments We'd Like to Hear from You Intelligent Video Analytics Face Capture Enhancement for i2 Facial Recognition Solution Installation and configuration guide Version We appreciate your comments about this publication. Please comment on specific errors or omissions, accuracy, organization, subject matter, or completeness of this book. The comments you send should pertain to only the information in this manual or product and the way in which the information is presented. For technical questions and information about products and prices, please contact your IBM branch office, your IBM business partner, or your authorized remarketer. When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate without incurring any obligation to you. IBM or any other organizations will only use the personal information that you supply to contact you about the issues that you state on this form. Comments: Thank you for your support. Submit your comments using one of these channels: v Send your comments to the address on the reverse side of this form. v Send a fax to the following number: (US and Canada) If you would like a response from IBM, please fill in the following information: Name Address Company or Organization Phone No. address

18 Readers Comments We'd Like to Hear from You Fold and Tape Please do not staple Fold and Tape BUSINESS REPLY MAIL FIRST-CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK POSTAGE WILL BE PAID BY ADDRESSEE IBM Information Development Department DLUA P.O. Box Research Triangle Park, NC USA NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES Fold and Tape Please do not staple Fold and Tape Cut or Fold Along Line Cut or Fold Along Line

19

20 Printed in USA