VxFaces
The VxFaces recognition module is designed to extend the functionality of the VideoXpert video surveillance system developed by Pelco by integrating biometric identification.
1. DESCRIPTION OF THE PRODUCT
VxFaces components
The following equipment is required for the correct operation of the System:
- Server
- Client computer
- Monitor
- Camera(as)
More detailed information on recommended hardware and software specifications you can find below.
Architechture
The system consists of the following components:
- Pelco VideoXpert – surveillance system;
- VxFaces Core – system server part, consists of the services, which include the system settings interface, recognition algorithms, database and reports;
- Плагин VxFaces – the plugin, which integrates with VxFaces Core and displays visitor information in the application on the PC, on which VxOps Center has been installed;
- Утилита VxFaces Toolbox – part of the system, that is used for setting up the VxFaces plugin;
- Tracker – video preprocessing server.
Recommended installation order:
- Server VxFaces: VxFaces Core + VxFaces Toolbox + Tracker
- Server VX: Pelco VideoXpert + VxFaces plugin
Technologies
The programming languages and software used in VxFaces are presented below:
- Golang
- C#
- AngularJS
- RabbitMQ
- Nginx
- PostgreSQL
- Redis
VxFaces Core includes the following services:
| Service | Description | Port |
|---|---|---|
| RabbitMQ | Data queuing service | 15672 |
| Nginx | A web server and mail proxy server | 80, 443, 23231 |
| PostgreSQL | Free and open-source relational database management system (RDBMS) | 5432 |
| Redis | NoSQL database, open-source software | 6379 |
| IdMe-backup-client-server-api | System data backup service | 11506 |
| IdMe-logging-server-api | Service is used to get logs from services | 11508 |
| IdMe-mas-server-settings | The main purpose of this service is to store and send the configuration to the modules. This service is run first. If an error occurs while the service is running, the system will not start | 11102 |
| IdMe-mas-server-api | Management service, which provides API for processing data about devices, applications, cameras | 11101 |
| IdMe-mfs-server-api | Service for storing and working with images | 11300 |
| IdMe-mfs-server-thumbnail | Service for working with thumbnails of the file storage | 11301 |
| IdMe-mfs-server-url | Service for processing image requests by URL | 11302 |
| IdMe-mi-sender-email | Service sends e-mail notifications | 11400 |
| IdMe-mi-sender-http | Service sends notifications by http (push) | 11401 |
| IdMe-mi-saver-incident | Service sends notifications about various incidents | 11069 |
| IdMe-mi-server-api | Service is used to perform notifications | 11403 |
| IdMe-mkv-server-admin | User interface for the system administration module | 11500 |
| IdMe-mkv-server-api | The service contains API methods to work with the main functionality of the system | 11501 |
| IdMe-mkv-server-auth | Service for authorization in the system by entering a username and password | 11502 |
| IdMe-mkv-server-report | Service for generating reports. Includes reports by gender, age, visits | 11084 |
| IdMe-mkv-server-ws | Application’s back-end in order to work with the client via WebSocket | 11503 |
| IdMe-mkv-server-url-shortener | URL shortening service | 11092 |
| IdMe-mkv-scheduler-api | Service that implements work with scheduled tasks | 11910 |
| IdMe-mkv-client-profiles-import | Service for importing profiles into the system | 8851 |
| IdMe-mkv-server-auth-vx | Authorization service that uses VxFaces Core credentials | 8111 |
| IdMe-modi-image-worker | Image processing service (crop/resize and etc.) | 11700 |
| IdMe-modi-server-api | Service for processing discrete images | 11701 |
| IdMe-modi-portraitAnaliser-01, IdMe-modi-portraitAnaliser-02, IdMe-modi-portraitAnaliser-03, IdMe-modi-portraitAnaliser-04 |
Services for obtaining information on a face detected from the image | 11710-11713 |
| IdMe-monitoring-server-windows | Services for monitoring statuses of the running services | 11507 |
| IdMe-mrp-matching | Service provides facial recognition process by the images provided | 11806 |
| IdMe-mrp-server-api | Service that provides API for processing data during working with the streaming video | 11800 |
| IdMe-mrp-server-broker | Service is used to manage a request queue to the matching algorithms | 11821 |
| IdMe-ms-server-filecache | Service provides caching files | 11900 |
| IdMe-support-server-api | Monitoring service that allows to work with metrics and desktops | 11091 |
| IdMe-mmpd | Manager module of detection processes | 11600 |
| IdMe-event-configuration-api | Service is used to simplify working with event-storage, so that a single request creates a pool of necessary entries in the dictionaries for event processing | 11509 |
| IdMe-event-storage-server-api | Service for processing system events and performing various actions depending on the type of event (sending an email after creating a business notification) | 11510 |
| IdMe-march-mrp-matching | Face recognition service | 11810 |
| IdMe-march-server-api | Archive management service | 11601 |
| IdMe-march-storage | Storage service for the archive | 11062 |
| IdMe-pelco.controller.vx3 | Integration with Pelco VideoXpert |
One of the server requirements for installation of the VxFaces software is the software specified in the table above cannot be installed on the same device, on which you are going to install VxFaces Core system and the ports specified above must be free.
2. SOFTWARE REQUIREMENTS
VxFaces server
VxFaces Core, VxFaces Toolbox and Tracker is installed on the server. Hardware specifications depend on the number of cameras processed by the system. Recommended server specifications are presented in the table below.
| Number of cameras | CPU (Core) | RAM (GB) | HDD (GB) | SSD (GB) |
|---|---|---|---|---|
| 1 camera | 5 | 16 | 600 | 300 |
| 2 cameras | 6 | 16 | 700 | 300 |
| 3 cameras | 8 | 16 | 700 | 300 |
| 5 cameras | 10 | 24 | 800 | 300 |
| 7 cameras | 14 | 24 | 900 | 300 |
| 10 cameras | 18 | 40 | 1000 | 300 |
Operating systems: Windows 10, Windows Server 2012 and higher. Account (username/password) (including a remote user) must remain unchanged throughout the installation. Account (username/ password) should allow granting administrator privileges, if necessary.
VX server
On the server you install Pelco VideoXpert and VxFaces plugin.