Users fail to receive alerts and/or ExacqVision actions configured through Event Linking or Event Monitoring fail to occur when using an Illustra Pro Gen4 Multisensor camera as the source.
<br>
Product
Illustra Pro Gen4 Multisensor
IPR32-M13-OIA4
IPR20-M12-OIA4
IPS32-M13-OIA4
IPS32-M13-OTA4
IPS20-M12-OIA4
IPS20-M12-OTA4
<br>
Steps to Reproduce
None. This issue exists in firmware prior to Illustra.SS017.06.05.00.0008
<br>
Expected Results
Analytic events, including those caused by motion detection, are received by ExacqVision.
<br>
Actual Results
ExacqVision stops reporting analytic alerts, including motion, from all but the first sensor.
<br.
Solution
Update the camera firmware to Illustra.SS017.06.05.00.0008 or later.
DSX is a powerful access control system monitoring application. This integration solely supports PTZ, Live View and Recorded View video and utilizes evAPI.
<br>
Requirements
Licensed exacqVision Server 23.09 or later
WinDSX version 3.7.52 or later
<br>
Installation
Before configuring WinDSX for use with the exacqVision System, complete the following steps:
Obtain a valid Username and Password from the exacqVision Server that will be used with WinDSX.<br><br>
Obtain the IP address of the exacqVision system. Alternatively, you may use the domain hostname if the system is on the same domain as WinDSX.<br><br>
Obtain the User ID and Password for the WinDSX Database/Server.
NOTE: It is strongly advised to use or create an account with limited privileges for this purpose. (e.g. – Live + Search)<br><br>
On the WinDSX server, install the exacqVision plug-in for WinDSX. Follow the on-screen prompts.<br><br>
From the Start menu, select All Programs > WinDSX. Log in using the User ID and Password obtained previously.<br><br>
Click the Database window: a. Double-click Locations. b. Double-click your location. c. Click Camera. d. Click on the New button in the menu to display the New Camera window.
<br>
On the General tab, enter the following information: a. Camera #: This is generic, such as 1, 2, 3, and so on. It is not the same as the camera number on the exacqVision Server. b. Name: This can be any name that you want to assign to the camera. c. Camera Type: Select Exacq Technologies from the drop-down list.
<br>
On the Digital Video Camera tab, enter the following information: a. DVR Server Name: Enter the IP address of the exacqVision Server. b. Assign Cameras: The number of the exacqVision camera (numbering starts at zero). See TIP below. c. DVR Server User Logon: The exacqVision Username obtained previously. d. DVR Server Password: The exacqVision Password obtained previously.
TIP: Clicking Help > Camera List from the exacqVision Driver window will show all camera names, camera IDs, and input numbers on the server. Use the camera ID in step 5b above.
NOTE: If you are using a PTZ camera, select the PTZ box and enter any preset position you want to see in the PTZ Preset Position field.
<br>
Click OK.<br><br>
Click the Workstation window. a. Double-click your location. b. Click Cameras.
<br>
The cameras defined for your location appear in the right window. Right-click any camera and choose Live Video or Recorded Video from the pop-up menu. A window with the desired video is displayed.
<br>
NOTE: If socket errors appear when you try to view live or recorded video, ensure that the dongle is correctly plugged in and the DSXKey service is running on the WinDSX server.
The following is a reference for the meaning of several indicators that may appear on the Illustra Body Worn Camera screen during use.
REC – indicates that the camera is recording to local storage<br><br>
Information – pressing this icon on the camera’s touch screen displays the information panel with details about the camera<br><br>
WiFi – when lit, this icon signifies that the camera is connected to a WiFi network<br><br>
ONLINE – displayed when the device has a connection the Mobile Video Manager software and is ready for live streaming (live streaming requires a valid license)<br><br>
Battery – indicates the current charge level<br><br>
Alert – displayed when a configured action button has been pressed (See Integration Guide)<br><br>
IR ENABLED – indicates the camera has enabled IR mode for poorly lit scenes<br><br>
PRIVACY MODE ENABLED – camera wearer has enabled Privacy Mode, preventing Live streaming (Requires camera firmware 8.2.0.111 or higher)
NOTE: A fresh installation of the Kiosk software will require rebuilding the Kiosk user accounts.
NOTE: When reconnecting to ExacqVision NVRs previously added users will no longer be associated with the previous user data as the underlying GUIDs will have changed.
This document will guide you through installation, configuration, and functionality of the Illustra Body Worn Camera system and how to view this video, both live and recorded, from the ExacqVision Server.
<br>
Requirements
Kiosk Requirements
Illustra Body Worn Kiosk 2.0.124 or higher
NOTE: Microsoft .NET 4.8 or higher is needed and will be included if not already found during installation.
Workstation Requirements
For best performance, we recommend installing the Kiosk software on hardware that meets or exceeds that of an Exacq C-Series workstation. For third-party workstations, not built by Exacq, adhere to the following specifications:
Operating System – Windows 10 or later
RAM – minimum 16GB
CPU – Intel Core i7 or greater
If using a C-Series workstation, built by Exacq, please use the Windows OS image release version 22.02.07 or above.
ExacqVision Requirements
ExacqVision Server 23.09 or higher
ExacqVision Client 23.09 or higher
<br>
<br>
Kiosk Software Installation
Unpack the contents of the downloaded .ZIP file containing the install package.<br><br>
Within the extracted files, locate and run the Setup.exe file.<br> <br><br>
Use the text fields provided to create a Kiosk Password. Enter this twice to confirm the entered password before clicking Next.<br> <br><br>
The following step displays the four Kiosk components to be installed. Click the Agree and Install button to accept the End User License Agreement and continue.<br> <br><br>
When installation has finished, click the Close button.<br> <br><br>
If you did not uncheck the box to create a Desktop shortcut, you may now use the created shortcut to open a web browser to access the Kiosk software. If you did not choose to create this shortcut, you will need to navigate to https://localhost:5000 in your web browser.<br> <br><br>
NOTE: Successful Kiosk installation will include four new running Windows Services.
JCI Body Worm Camera Kiosk Driver Service
JCI Dock Controller Service
Illustra Mobile Video Manager
Illustra Mobile Live Relay
<br>
Kiosk Setup
The Bodycam Kiosk is where camera checkouts are managed and recorded video will be uploaded. These recordings can be searched from a connected ExacqVision server.
The Kiosk utilizes a self-signed certificate A self-signed certification cannot be verified by your browser, so your browser will most likely warn you that your connection is not private. Use the Advanced option to continue to the Kiosk login.<br><br>
Login using ‘admin’ as the Email ID for the default administrator account, and the Kiosk Password you created in Step 3. Additional accounts may be created by followin the User Setup steps.<br> <br><br>
Click the gear icon in the upper-right corner of the page to access the Kiosk Settings.<br> <br><br>
Create and enter an API Username and an API Password in the labeled fields. These are used in a later step to connect the ExacqVision VMS to your Kiosk.<br><br>
If your deployment will include live video streaming, you will also need to complete the Relay Server field. Enter the IP address of the Kiosk workstation followed by the port number 4257. Example: 192.168.10.3:4257<br><br>
In the bottom-right corner is the Charging Threshold. A camera that is docked will not become Available to check out again until the battery charge has reached this threshold. By default this is set to 90(%).<br><br>
Lastly, it is recommended to check the One Camera Per User box, near the bottom, to prevent multiple devices being allotted to a single user/camera wearer.<br> <br><br>
Click Save.
<br>
Creating a Camera Profile
Camera profiles allow you to define common configurations to be easily applied to multiple cameras.
Click the menu icon in the top-left corner of the page, then select Profiles.<br> <br> IMPORTANT: At this time only the Default profile supports WiFi. Edit the Default profile, using the pencil icon, if you require WiFi enablement. WiFi is only necessary for live streaming.<br><br>
Click the Add New Profile button. Within the New Camera Profile Configuration window, the Profile Overview tab appears.<br> <br><br>
Provide a unique Profile Name.<br> <br><br>
You may toggle the option to apply this profile to all available cameras. This will only apply to cameras already added to the Kiosk. Cameras added later will need the profile applied manually, or by re-editing the profile configuration. Alternatively, you may opt to select specific cameras to apply the profile to, using the Select Camera menu and Add button.<br><br>
Navigate to the Camera and Recording option. Use the Camera tab to select the aspect ratio, resolution, and frame rate settings for this profile.
Additional controls on the Recording tab permit you to enable/disable Auto IR and audio recording settings, as well as enable/disable Privacy Mode. Privacy Mode allows the camera wearer to prevent live streaming. The camera firmware must be version 8.2.0.111 or higher to enable Privacy Mode.<br> <br><br>
If your intended deployment requires live video streaming, you will configure the Illustra Mobile Video Manager tab. Within the Server Address field, enter the IP address of the Kiosk workstation, which hosts the Illustra Mobile Video Manager service. Example: 192.168.10.3<br> <br><br>
APN Settings are not supported at this time.<br><br>
Toggle the control to Enable WiFi. See also: Network Profiles. Cameras must be connected to the same internal network as the Kiosk workstation and Illustra Mobile Video Manager service via WiFi for live video streaming.<br> <br><br>
Using the Actions and LEDs tab, you may configure the behavior and actions taken by the camera’s buttons and LED indicators.<br> <br><br>
The Sounds and Vibrations tab provides the ability to customize audio indicators to alert the wearer to status changes.<br><br>
Click the Save button when you are finished making settings changes to the profile.
<br>
Network Profiles
Enabling WiFi within a Camera Profile permits the device to use WiFi capabilities. To configure the network authentication, select the Network Profiles tab at the top of the Profiles page.
Enter the network SSID.<br><br>
Enter the authentication Password.<br><br>
Select the Security method.<br><br>
Click the Add Network button. Repeat the previous steps as needed for additional SSIDs.<br> <br><br>
Click the Save button when done.<br><br>
Additional network settings may be located towards the bottom of this page.
<br>
Configuring Users
Click the menu icon in the top-left corner of the page, then select Users.<br> <br><br>
Click the Add New User button.<br> <br><br>
Complete the provided fields for the user’s First Name, Last Name, and Email.<br><br>
Create the user’s password by completing the Password field. It is suggested that the user enters this while being enrolled to prevent an administrator from knowing other user’s passwords.<br> <br><br>
From the User Type selector, choose whether the user account will be a Camera Wearer or Kiosk Admin.
Camera Wearer – may check out cameras, cannot affect changes to Kiosk settings or users.
Kiosk Admin – full Kiosk access.<br><br>
Check the box confirming the identity of the user before clicking the Save button.<br><br>
Repeat Steps 2 through 6 for each user needed.
<br>
License Management
Bodycam Kiosk requires licensing for live video and audio streaming.
Click the menu icon in the top-left corner of the page, then select Live Stream License.<br> <br> <br><br>
This page allows Kiosk Admins to quickly view the license status. Click the View Available Licenses button for an overview of the number of licenses in use or available.<br> <br><br>
Clicking Request a New License provides a new dialogue window. Complete the Email and Sales Reference Number fields, then select whether to:
Email the license request (requires an email client on your Kiosk workstation).
Download the license request file to send from another workstation, or at a later time.<br><br>
Once a valid license file has been provided, return to this page to utilize the Upload a New License button so it may be applied to the system.
<br>
Connecting Cameras
Illustra Body Worn Cameras may be connected to the Kiosk workstation in one of two ways:
USB Cable – each camera is packaged with a USB-C to USB-A cable. The USB-A connector will connect to the Kiosk workstation while the USB-C end will connect to the camera.
It is strongly recommended to keep these cables even if using the Docking Station as you may find that many USB-C cable connectors are not of sufficient depth to properly connect when plugged into the camera.<br><br>
Docking Station – an optional 8-port docking station is available, capable of charging and transferring data for up to 8 cameras over USB-A 3.0 cable. Multiple docking stations may be utilized on a single Kiosk.
IMPORTANT: It is strongly recommended to connect cameras and Docking Stations to the blue USB 3.0 ports on the Kiosk workstation. Failing to do so will result in much slower data transfer times.
<br>
Updating Firmware
The process of updating the firmware running on the cameras can be performed through the Kiosk dashboard by a Kiosk Administrator.
Select the gear icon in the upper-right corner of the dashboard and choose Update Firmware, or select the gear icon on one of the individual camera tiles and select Update Firmware.<br><br>
Use the Browse Files button to locate your firmware .APK file.<br><br>
Select the Update button.<br><br>
During the update process you will notice cameras in the Kiosk move to Not Ready and the cameras will reboot. Do not disrupt the update process or disconnect the cameras during this period. When completed, the cameras will return to the Available state.
The camera firmware files may be found in the Kiosk install package. Open the contents of the extracted .ZIP file and locate the .APK file within the ‘bin’ folder.
NOTE: A firmware update will affect all connected cameras.
<br>
Kiosk Dashboard
Kiosk Admins will see a Tiled View by default. Each camera is displayed as a tile, showing the camera name and status information.
The camera tiles are separated into three sections:
Available – cameras to ready to be checked out for use.
Checked Out – cameras already checked out.
Not Ready – cameras still transferring data or charging.
Clicking on the gear icon allows a user to manually change the profile assigned to the camera. If changing the profile assigned to a camera, this must be done prior to check-out. It is not recommended to change the camera password in the camera settings as this is tied to Mobile Video Manager and will prevent live streaming without manual intervention to match this password within the MVM software.
An administrator also has the option of using the Forget Camera button in the camera settings to permanently remove a camera from the Kiosk, as in the case of a lost or damaged camera that will not be reconnected.
A Kiosk Admin may also choose to view cameras in a List View using the View type buttons in the upper right-hand corner of the page.
Adding a new camera to the Kiosk is as simple as plugging in the USB cable or seating the camera in the Docking Station.
When connecting a camera to charge or transfer data, it may take a moment to be recognized and its status to be updated in the Kiosk.
NOTE: A camera must reach the configured battery charge threshold before it becomes Available.
<br>
Connecting to ExacqVision
ExacqVision integration copies the downloaded video/audio from the Kiosk workstation to the ExacqVision Server making the video easy to store and search alone, or alongside your connected IP security cameras.
Within the ExacqVision Client software, click the gear icon to enter Configuration settings.<br><br>
Within the navigation tree on the left-hand side, expand the node labeled with the server name, to display the nodes nested beneath it.<br><br>
Expand the Configure System node.<br><br>
Select the Body Worn Cameras node.<br><br>
On the Body Worn Cameras page, check the Enable checkbox.<br><br>
Using the Type selector, choose Illustra Body Worn.<br><br>
Enter the IP Address of the Kiosk workstation. Do not alter the port number.<br><br>
Enter the API Username and API Password you created in the Kiosk Setup steps into the Username and Password fields.<br><br>
If you plan to use live streaming in your deployment, check the Enable Live Streaming checkbox.<br><br>
Click Apply.<br>
Body Worn Camera users will appear on the camera tree to the left alongside any infrastructure IP or analog cameras.
<br>
Camera Check Out
IMPORTANT: When checking out a camera, wait until the light on the camera begins flashing before disconnecting from the USB cable or Docking Station. This light not only indicates the assigned camera, but tells the user it is ready to be disconnected. Disconnecting prior to this will leave the camera in a disconnected, unassigned state.
Kiosk Admin
When logged in as an administrator:
Select one of the Available cameras to use.<br><br>
Press the Check-Out button.<br><br>
In the field titled User ID number, enter the assignee’s email address. This was configured when creating the User account. You may also begin typing the user’s name and select it from a displayed list of matches.<br><br>
Check the box titled, I certify that I have confirmed the identity of this user.<br><br>
Click the Check-Out button.<br><br>
Wait for the camera light to flash before disconnecting.<br><br>
Camera Wearer
If the deployment is not attended by a Kiosk Admin, the Kiosk provides a self check-out experience. A registered Kiosk user will:
Sign into the Kiosk using the registered email and password.<br><br>
Click the Assign A Camera button.<br><br>
The Kiosk will inform the user which camera to remove by name.<br><br>
Wait until the light on the camera flashes before disconnecting.<br><br>
Close the window by clicking the X or the Cancel button to automatically logout, ready for the next user.
<br>
Camera Check In
Reconnect the camera to the USB cable or Docking Station. The Kiosk will automatically begin transferring recorded data. The camera will become Available again once charged and all data has been transferred.
NOTE: A camera must have at least 90% battery charge before it becomes Available.
<br>
ExacqVision Live Streaming
Cameras with WiFi enabled will automatically connect when in range of access points correlating with the SSID and credentials entered in the Network Profile. Cameras that are connected and ready to live stream will display a green arrow in the camera tree of the ExacqVision Client’s Live viewing page.
To view the live stream, add the camera to a panel just as you would a fixed IP or analog camera, by dragging it onto a camera panel or double-clicking it.
When viewing live streaming video or listening to live streaming audio the data is automatically recorded on the NVR. You may stop the live stream by positioning your cursor over the center of the panel and pressing the Stop icon that appears. This will also cease recording on the NVR, but will not stop local recording on the camera if the wearer has enabled recording.
Streams which have been disconnected may be restarted by pressing the Play icon when the ‘Live Stream Available’ message appears.
If attempting to display a live stream when the camera wearer has enabled Privacy Mode, the following image will appear until Privacy mode has been disabled.
<br>
ExacqVision Search
Performing forensic search and playback of video and audio is similar to that of fixed cameras. However, you will note that each camera wearer’s name appears twice in the Camera List pane.
Video and Audio recorded locally on the device while being worn is downloaded from the device to the Kiosk when docked. This data is then transferred to the NVR. Locally recorded video and audio data is searched using option labeled ‘– Recorded‘.
Video and Audio that have been live streamed to ExacqVision Client users is recorded directly to the NVR. This is a separate stream and is searched using the option without the ‘– Recorded‘ label.
Live stream recordings, camera-side recordings, and fixed infrastructure camera recordings may all be displayed side-by-side within the Search screen of the ExacqVision Client, and/or exported.
<br>
GPS Data
Cameras with location data enabled, with a clear view of the sky for GPS positioning, record GPS data as an analytic. Select the geolocation box beneath the camera wearer name from the camera tree, as pictured.
Enter your search date/time range, then press the Search button as you would any permanently positioned IP camera. GPS data is recorded in intervals when the device is moving. This is indicated by the red lines on the geolocation row in the timeline.
Clicking the Show/Hide Keywords and Serial Data icon below the Quick Export button will toggle the Keywords and Serial Data panel to view the geolocation data similar to analytics from infrastructure IP cameras.
When troubleshooting TCP/IP connectivity issues, it is often helpful to confirm that the network path is open over a specified port and that there is no interference from a firewall or antivirus. This also rules out software level problems that may be causing a failure to connect.
While there exists many utilities to accomplish this task (telnet, putty, nmap, etc…), often these utilities aren’t previously isntalled and can’t be accessed when troubleshooting.
This utility will attempt to make a TCP connection to a specified IP Address or hostname over a specified port and return either success or failure.
If you are unable to transfer the file, the contents can be copy and pasted into a file manually and run from command line.
::PortCheck.bat
::This utility will check the network path to the specified IP address/Hostname.
::It will accept the first argument as the IP Address/Hostname, and the second argument as the port.
::Author - Isaac Penrod
@echo off
set $IP=%1
set $PORT=%2
IF "%~1" == "" set /p $IP="Enter the IP Address or Hostname: "
IF "%~2" == "" set /p $PORT="What TCP Port: "
set $COMMAND="^(New-Object System.Net.Sockets.TcpClient^).ConnectAsync^('%$IP%', '%$PORT%'^).Wait^(800^)"
echo.
echo Checking connectivity to %$IP%:%$PORT%
echo If the network path is open and something is listening
at that location, the result will be "True"
echo.
powershell -command " %$COMMAND% "
echo.
pause
If you are unable to transfer the file, the contents can be copy and pasted into a file manually and run from terminal.
You will also need to make the file executable with – chmod +x portcheck.sh
#!/bin/bash
#This utility will check the network path to the specified IP address/Hostname.
#It will accept the first argument as the IP Address/Hostname, and the second argument as the port.
#Author Isaac Penrod
IP=$1
PORT=$2
if test -z "$IP"
then
read -p "Enter the IP Address or Hostname: " IP
fi
if test -z "$PORT"
then
read -p "What TCP Port: " PORT
fi
echo
echo Checking connectivity to $IP:$PORT
echo If the network path is open and something is listening at that location, the result will be "success"
echo
timeout 2 bash -c 'if > /dev/tcp/'$IP'/'$PORT'; then echo success; fi'
if [ $? != "0" ]; then
echo failure
fi
echo
Arguments
This utility will also accept command line arguments. $1 – IP Address/Hostname $2 – Port