Categories
User Guides Documentation Integrations Illustra Categories Products exacqVision Integrations Uncategorized

Illustra Body Worn Camera Kiosk 2.x Integration Guide

Overview

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

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;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

  1. Unpack the contents of the downloaded .ZIP file containing the install package.<br><br>
  2. Within the extracted files, locate and run the Setup.exe file.<br>
    <br><br>
  3. Use the text fields provided to create a Kiosk Password. Enter this twice to confirm the entered password before clicking Next.<br>
    <br><br>
  4. 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>
  5. When installation has finished, click the Close button.<br>
    <br><br>
  6. 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.

  1. 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>
  2. 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>
  3. Click the gear icon in the upper-right corner of the page to access the Kiosk Settings.<br>
    <br><br>
  4. 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>
  5. 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>
  6. 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>
  7. 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>
  8. Click Save.

<br>

Creating a Camera Profile

Camera profiles allow you to define common configurations to be easily applied to multiple cameras.

  1. 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>
  2. Click the Add New Profile button. Within the New Camera Profile Configuration window, the Profile Overview tab appears.<br>
    <br><br>
  3. Provide a unique Profile Name.<br>
    <br><br>
  4. 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>
  5. 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>
  6. 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>
  7. APN Settings are not supported at this time.<br><br>
  8. 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>
  9. 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>
  10. The Sounds and Vibrations tab provides the ability to customize audio indicators to alert the wearer to status changes.<br><br>
  11. 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.

  1. Enter the network SSID.<br><br>
  2. Enter the authentication Password.<br><br>
  3. Select the Security method.<br><br>
  4. Click the Add Network button. Repeat the previous steps as needed for additional SSIDs.<br>
    <br><br>
  5. Click the Save button when done.<br><br>
  6. Additional network settings may be located towards the bottom of this page.

<br>

Configuring Users

  1. Click the menu icon in the top-left corner of the page, then select Users.<br>
    <br><br>
  2. Click the Add New User button.<br>
    <br><br>
  3. Complete the provided fields for the user’s First Name, Last Name, and Email.<br><br>
  4. 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>
  5. 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>
  6. Check the box confirming the identity of the user before clicking the Save button.<br><br>
  7. Repeat Steps 2 through 6 for each user needed.

<br>

License Management

Bodycam Kiosk requires licensing for live video and audio streaming.

  1. Click the menu icon in the top-left corner of the page, then select Live Stream License.<br>
    <br>
    <br><br>
  2. 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>
  3. 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>
  4. 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.

  1. 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>
  2. Use the Browse Files button to locate your firmware .APK file.<br><br>
  3. Select the Update button.<br><br>
  4. 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.

  1. Within the ExacqVision Client software, click the gear icon to enter Configuration settings.<br><br>
  2. 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>
  3. Expand the Configure System node.<br><br>
  4. Select the Body Worn Cameras node.<br><br>
  5. On the Body Worn Cameras page, check the Enable checkbox.<br><br>
  6. Using the Type selector, choose Illustra Body Worn.<br><br>
  7. Enter the IP Address of the Kiosk workstation. Do not alter the port number.<br><br>
  8. Enter the API Username and API Password you created in the Kiosk Setup steps into the Username and Password fields.<br><br>
  9. If you plan to use live streaming in your deployment, check the Enable Live Streaming checkbox.<br><br>
  10. 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:

  1. Select one of the Available cameras to use.<br><br>
  2. Press the Check-Out button.<br><br>
  3. 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>
  4. Check the box titled, I certify that I have confirmed the identity of this user.<br><br>
  5. Click the Check-Out button.<br><br>
  6. 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:

  1. Sign into the Kiosk using the registered email and password.<br><br>
  2. Click the Assign A Camera button.<br><br>
  3. The Kiosk will inform the user which camera to remove by name.<br><br>
  4. Wait until the light on the camera flashes before disconnecting.<br><br>
  5. 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.

<br>

Categories
Knowledge Support Support exacqVision Hardware

Screensaver Lock Screen is Activating on exacqVision Server Running Ubuntu Linux

Description 

By default the screensaver lock screen is off on exacqVision Servers.  However manually created OS users may have them enabled.

Product 

  • Ubuntu 16.04 or higher

Steps to Reproduce 

  • Login to the OS using the manually created users account

Expected Results 

  • Screensaver lock screen never appears

Actual Results 

  • After a period of time the screensaver lock screen will activate

Solution

This has been observed on manually created users accounts which were not created, using the provided Kiosk setup scripts.
In this case new kiosk user can be created or the screen lock can be manually disabled for the current user. 
For instructions on setting up a Kiosk user see Knowledge Base Article #788
To manually disable you will need to be logged in as that user and then disable the screen saver lock in the Linux system settings.

Categories
Knowledge Support Categories exacqVision Hardware

Setting up the Kiosk User for ExacqVision Systems

Windows systems built by ExacqVision no longer ship with a default ‘admin’ and restricted ‘user’ account beginning with Windows 10.

Some early Ubuntu 16.04 images still contain the ‘admin’ account, but do not have the restricted ‘user’ (this was changed in a later image will not have either ‘admin’ or ‘user’). 

This change is due to security compliance requirements. 

The first time a system boots, the user will be asked to create a custom user account with admin privileges. 

To enable similar functionality of the old restricted ‘user’ account, you will need to enable ‘Kiosk Mode’ by following the instructions below, based on your operating system.

<br>

Windows 10

1. Access the Desktop for your custom user created when the machine first booted.

2. Double-click the Setup Kiosk Mode script.

3. Follow the prompts to set a custom account name, enter the desired password twice, the use Y or N to determine if the OS will automatically boot to the new restricted Kiosk user.

To undo the changes, use the Undo Kiosk Mode script and follow the prompts.

<br>

Ubuntu 16.04 & higher

1. Access the Desktop for your custom user created when the machine first booted.

2. Use the Exacq Kiosk User either on the Desktop, or from the menu Applications > Exacq.

3. Type in your desired restricted user account name.

NOTE: Ubuntu has the following restrictions for user names.

  • Must start with a lowercase letter
  • May only contain lowercase letters, underscore (_), and dash (-)
  • May optionally end with a dollar sign ($)

4. Enter your desired password, then check the Auto Login User option if the OS will automatically boot to the new restricted Kiosk user.

5. To undo the changes, run the same Exacq Kiosk User link on the Desktop and type in the name of the user you want to remove or modify.

<br><br>

Troubleshooting

In the event you get an Error similar to the following check the user name to ensure it meets Ubuntu’s restrictions.

  • Must start with a lowercase letter
  • May only contain lowercase letters, underscore (_), and dash (-)
  • May optionally end with a dollar sign ($)

<br>

Categories
Knowledge Support Support exacqVision Server Categories Products exacqVision Hardware

Changing the Automatic Login User in Linux (Legacy)

To change the automatic login user in Linux, complete the steps provided for your Linux version.

<br>

Ubuntu 18.04 and higher

On systems built by Exacq with Ubuntu version 18.04 and higher, the ability to use the operating system to configure automatic logins has been removed as a security measure.

You may, however, utilize the Exacq Kiosk User software to create kiosk user accounts and select whether or not a kiosk user account will automatically login.

See also: Setting up the Kiosk User for ExacqVision Systems

Ubuntu 16.04

  1. Log out of the User account.
  2. Log in as an Admin.
  3. From the upper-right corner, click the computer icon from the menu bar.
  4. Select System Settings from the menu.
  5. In the Settings window that appears, select Users.
  6. Select Unlock. Enter the admin password when prompted.
  7. Highlight the user account you wish to automatically login.
  8. Toggle the Automatic Login switch for the user account.
  9. Close the User Accounts window.
  10. Restart the system to test the new automatic login.

Ubuntu 14.04

  1. Log out of the User account.
  2. Log in as an Admin.
  3. From the upper-left corner, open the Applications menu.
  4. Expand the System Tools option from the menu.
  5. Expand the Administration menu, then select User Accounts.
  6. Select Unlock. Enter the admin password when prompted.
  7. Highlight the user account you wish to automatically login.
  8. Toggle the Automatic Login switch for the user account.
  9. Close the User Accounts window.
  10. Restart the system to test the new automatic login.

Ubuntu 12.04

  1. Log out of the User account.
  2. Log in as an Admin.
  3. From the upper-left corner, open the Applications menu.
  4. Expand the System Tools option from the menu.
  5. Select System Settings.
  6. In the System Settings window, select User Accounts.
  7. Select Unlock. Enter the admin password when prompted.
  8. Highlight the user account you wish to automatically login.
  9. Toggle the Automatic Login switch for the user account.
  10. Close the User Accounts window.
  11. Restart the system to test the new automatic login.

Ubuntu 10.04

  1. Log out of the User account.
  2. Log in as an Admin.
  3. In the upper-left corner, select System from the menu bar.
  4. Select Administration from the menu.
  5. Select Login Screen from the menu.
  6. Select Unlock. Enter the admin password when prompted.
  7. Select Log In As and then select the desired user from the drop-down list.
  8. Click Close.
  9. Restart the system to test the new automatic login.

<br>

Categories
Knowledge Support Support exacqVision Client Categories Products

Default Windows User Accounts on Exacq Systems

When setting up a new Exacq system, the out-of-box experience will prompt you to create a default operating system account. This account will be given administrative privileges.

Additional user accounts may be created using the Kiosk scripts available on the Desktop. Kiosk user accounts have restricted privileges. The Kiosk account is blocked from all operating system functions and the user can only close the exacqVision Client and log out of the operating system account. This prevents the Kiosk user from shutting down the system, opening web browsers, or from starting and installing other applications while logged in as the Kiosk user. You are given the option to automatically log into the system with the Kiosk user account during creation of the account.

If you license exacqVision software and install it on your own computer, this script is not available, and you are responsible for configuring all operating system accounts and privileges.

<br>