iSentry–Axis Camera Integration
Overview
iSentry Axis transforms Axis cameras into even more advanced security devices by incorporating New Generation Video Analytics directly onto the device. This integration provides end-users with a top-tier video security system that combines high-quality surveillance with cutting-edge AI-driven video analytics for enhanced security. By embedding iSentry’s leading AI algorithms directly into the camera, the system ensures real-time, reliable monitoring with reduced system complexity and cost.
For system integrators, iSentry Axis offers a seamless and efficient solution that merges iSentry’s deep learning AI models and machine learning capabilities with the robust Axis Camera Applications Platform (ACAP).
This integration not only simplifies the deployment process by eliminating external dependencies but also enhances the performance of the surveillance system. Integrators can deliver a smarter, scalable security solution, ensuring clients receive a highly effective, integrated video analytics system that is easier to install and maintain.
Benefits
- Processing on The Edge
- Reduced bandwidth needs
- Compatible with whole iSentry portfolio
- Designed for both small and large projects
- Supports Axis ecosystem
Explore the Full Potential of Your Security System
Delve into the details of maximising your security with iSentry Axis by exploring our comprehensive user manual. Discover how to harness the full capabilities of your integrated system, ensuring you make the most of our advanced video analytics technology. Whether you’re setting up for the first time or looking to fine-tune your security measures, our user manual is your go-to resource for all your needs.
Perimeter Protection
Object Attributes
Unusual Behaviour
Smoke & Fire Detection
Object Counting
Popular Use Cases
Solar Farm
iSentry Axis maximises efficiency in solar farm monitoring by processing video analytics at the edge, significantly reducing bandwidth usage, and utilising advanced AI for long-range detection to ensure comprehensive coverage and security.
Casino
iSentry Axis enhances casino security by integrating advanced AI that excels in detecting unusual behaviour, identifying vandalism, and recognising specific threats like unauthorised helmet or gun presence, ensuring a safer gaming environment.
Telecommunication
iSentry Axis streamlines surveillance of telecommunication towers by extending detection range and limiting hardware requirements, efficiently managing bandwidth and reducing false alarms through precise AI analytics.
Construction Site
iSentry Axis boosts construction site security with robust perimeter protection, reduces false alarms with accurate AI monitoring, and ensures PPE compliance, enhancing safety and operational efficiency.
Installation Manual
Introduction
iSentry Axis is the add-on application built for a suitable Axis camera to run on-camera Video Analytics. This document is a tutorial providing the steps to integrate the iSentry Video analytics standalone platform into suitable Axis cameras.
Product overview
The fully integrated product contains the following components:
- Axis Cameras with the iSentry Axis add-on application installed
- An iSentry Event Management Server (service)
- One or more Deep Learning processors (DLP)
- An alert front-end interface such as the iSentry Web Client or another 3rd party integration for viewing and managing alerts.
Figure 1: iSentry Axis integration diagram logical flow from left to right
Axis Camera
The add-on iSentry Axis analyses data captured from Axis camera in real-time and sends alert events to the ISentry Event Management server if anything is triggered.
iSentry Event Management Server
iSentry Event Management Server, is a message queue server with a preconfigured queue for iSentry deep learning. The alert data from Axis Camera (as the producer) is pushed to the queue and then pulled by deep learning processors.
Deep learning processor
Deep learning processor acts as the “consumer” of the ISentry Event Management server, will pull the alert data that included the images for Deep learning, run deep learning on those images, verify with the configured deep learning rules and push the final alert data with deep learning results to the iSentry Web Client or any supported 3rd party integrators software.
Prerequisites
Axis cameras with an SD CARD supported. Axis cameras are listed in the iSentry supported list (check the appendix).
Sanity check SD CARD is installed and formatted.
Step 1: In the Onboard Storage menu, sanity check for a pre-formatted SDCARD and see that the space is <100MB free required for the iSentry application, and that the status of the SDCARD is ‘Okay’.
(See example screenshot below)
SDCARD Format to follow if no SD Card found or SD CARD not formatted yet.
Step 1: If you do not see the SDCARD icon with storage but are sure that an SDCARD has been supplied with or been installed to the Axis camera, then please follow the SDCARD format instructions as per Axis documentation for first-time use.
Specification
Camera port required | 8123, 8124 |
Internal storage minimum size | 100MB |
External micro-SD card size | > 8GB class 10, V10 |
Minimum camera firmware | 10.12 |
Installation steps
Install iSentry Axis add-on application
This section shows steps to install iSentry Axis application to Axis Camera.
There are two ways to install the app: Via Axis Camera Web or via iSentry Axis Uploader app.
Installation Method | Description |
Via Axis Camera Web app | Traditional method – application will remain on internal storage. Require at least 100MB free on internal storage |
Via iSentry Axis Uploader | New method, available for Camera firmware >= 10.12 Application can be either installed on sdcard1 or internal storage. |
Download the iSentry-Axis binary package
The package will be provided by Intelex Vision. It is a single file with extension *.eap. For example: iSentry_axis-20240111d_1_0_0_aarch64.eap
Access the Axis Application via Axis Camera web
Step 1: Login to the Axis Camera Web Page via a web browser.
The image below shows how to access the axis camera web using web browsers. In this example, the axis camera’s ip address is 192.168.30.250
Step 2: From Axis camera web interface, select the Apps tab and hit Add App button
Step 3: Navigate to the location of the iSentry-Axis binary package *.eap file, open it and click on the Install button
Step 4: Verify that the app has been installed. After this step, the app needs to be licensed before it can start.
Install app via iSentry Axis App Manager
Step 1: Check existing SD Card on Axis camera
From Axis camera app, make sure that SD Card is available and must be labeled SD card 1
Step 2: Open iSentry Axis App Manager tool to upload the application.
Step 3: From interface, enter Axis Camera IP, username and password
Step 4: Hit the List current app button
This step is to check the installed applications status on the Axis Camera as well as verify the connection from the iSentry Axis App Manager tool to the Axis Camera.
Step 5: Enter/Browse the *.eap iSentry Axis app file Path
Step 6: Hit upload button to upload the app
Installing a License for iSentry Axis add-on
There are two ways to license iSentry Axis:
License method | Pros | Cons |
Axis ACAP Service Portal | Simple. No extra license server required. | Problem with deploying at scale, i.e. installing and licensing iSentry Axis applications over 100 or 1000 cameras. |
iSentry Live Licensing Server (LLS) | Scalability. You only need to enter the license server URL in configuration. | Need an extra machine with Windows OS to run the live license server service. |
Licensing using the Axis ACAP Service portal
If choosing to license iSentry Axis app via the Axis portal, this step must be completed by an Intelex Vision technician.
Step 1: Go to Axis partner page and log in with partner account: https://www.axis.com/partner_pages/compatible_applications/#/
Step 2: Navigate to the license page for iSentry Axis application by selecting ‘Applications”.
Step 3: To create a new license, hit the CREATE LICENSE CODES button.
Step 4: Fill in the required information for the license and click GENERATE.
Step 5: Go to License Codes tab and copy the generated license code.
Step 6: Go to Apps in Axis Camera web page, click the icon from the iSentry axis app and choose Activate license automatically.
Step 7: Enter the license code in the pop-up windows (Internet required).
Step 8: Check the license status to make sure the iSentry Axis is licensed.
License using an iSentry Live Licensing Server (LLS)
If licensing iSentry App via an iSentry Live Licensing Server, please check the configurations section below for further detail.
Configuration
Run the application
From the Axis Web page, go to the Apps panel and start the iSentry Axis Application by toggling the Start switch from OFF (grey) to ON (Blue).
If the circle icon to the left of the application turns green, it means that the application has successfully started.
Checking the application status
Green light means that app is running.
App stopped
App started
Configuration via the iSentry Web Settings interface
Once the ISentry Axis app has successfully started, the iSentry web settings can be accessed at URL http://[AXIS_CAMERA_IP]:8123
E.g. http://192.168.30.250:8123
If a password is required, then the default credentials are:
username / email: | user@intelexvision.com |
password: | isentry2023 |
NOTE: After every configuration change, please ensure to click on the ‘UPLOAD TO SERVER’ button to update the settings for the iSentry Axis app.
Adding cameras and setting-up an RTSP URL
This step is compulsory to the Axis Camera application working correctly with iSentry.
Camera Id
The camera ID of an Axis camera must be 1. If the current settings page shows a different camera ID value, please reset the page and redo the settings over again from scratch.
Camera RTSP
rtsp://user:password@localhost/axis-media/media.amp?resolution=640×480
user: password is username and password to access the axis camera web page
640×480: is the recommended input frame size (width x height) in pixels. To know the list of supported frame sizes and which ratios are supported, please go to Axis Camera web page → Video → Stream → General → Resolution for reference.
CAUTION! Changing the input size must be done with care because it can affect the behavior of some analytics, as well as the performance of the camera.
Adding the iSentry Deep learning Server information
This step is for entering the relevant information of the DL queue server in order for the alerts from Axis Camera to be pushed to this component.
From Web Settings, go to Settings → Integrators Management → Select type = “DL & Rule queue server”
Enter the queue server information and hit the save button.
Below is the default information to enter (assume the queue server ip is 192.168.30.251)
Integrator Type | DL & Rule queue server |
Enabled | True |
Queue server URL | amqp://user:iSentry2023@192.168.30.251/intelex |
Queue name | iSentry_dl_queue |
Route key | iSentry_dl |
Exchange | intelex_exchange |
Username | user |
Password | iSentry2023 |
Adding a Web Client Server info
Alerts will need to be pushed to an iSentry Web Client or the 3rd party integrator front-end interface to be viewed and managed.
Please check the section titled Integrators Management in the iSentry Web Settings User Manual for further steps regarding this configuration.
Setting up a Live licensing server URL (Optional)
Skip this section if the iSentry Axis app has been licensed using the Axis Portal method.
The detailed steps to set up a Live Licensing Server (LLS) in Web Settings can be found in the iSentry Web Settings User Manual (Section Server Miscellaneous Settings).
Further integration into Milestone VMS (Optional)
Navigate to the “users” tab in the Firefly Web Settings interface and turn the following toggle off.
iSentry Processing Server created in Milestone machine and configured to accept the external ‘stand_alone_RTSP-Decoding’ Video Processor type in the iSentry Milestone MIP Management Client
Configuring the iSentry VP to accept Firefly devices
Steps:
1. Create a bespoke Processing Server for Firefly devices
2. If Remote Recording Retrieval from the Axis camera is required, then this setting should be turned on
3. Under Object Classification, please ensure that the following setting is turned OFF:
Create and map an associated Milestone Metadata device to the Processing Server
(This will allow us to insert our alert indicators into live and playback video)
Create, name and configure the iSentry Video Processor type to accept Firefly Devices
Change VP type from internal to ‘stand_alone_RTSP_decoding’
Remote Web Services Menu exposed:
insert alert web server url here, starting http://[AXIS_CAMERA_IP]:8123
e.g. http://192.168.30.250:8123
Map the VP to the Metadata device
Configuring and mapping an iSentry Deep Learning Server in Milestone MIP
Map Axis camera to Firefly Video Processor
Please follow the as per normal camera map adding process in iSentry in Milestone instructions (right to left mapping)
Configure time zones, alert types and rules check as per normal Milestone Device(s)
Advanced Settings, in VP, to turn on
Internal Deep Learning Turn ON
Advanced Settings, Edge architecture settings, once device has been selected on left-hand-side:
Step 1: RTSP url – insert the very same Axis rtsp here following standard RTSP url syntax as we did in 6.4:
rtsp://user:password@localhost/axis-media/media.amp?resolution=640×480
Other General Advanced Settings to Turn ON:
Configure trigger analytics and rules on the Axis camera as per normal Milestone iSentry camera additions
Map the Axis Camera to the correct Milestone Profile in the iSentry MIP
Ensure to save the configuration using the save button
Uninstalling the iSentry Axis application
Step 1 – Stop the iSentry Axis app (if running)
Step 2 – Deactivate the license on the now stopped application (if using Axis License portal)
Step 3 – Deactivate the license on Axis ACAP Service Portal
After step 2, the Intelex technician should be notified to deactivate the license on the Axis ACAP Service Portal in order for the license code can be used for another Axis camera.
Go to license code →find the device ID that matches the camera axis serial number (Axis SN can be found in step 7, section (Licensed by Axis portal) that need to be deactivated → Switch the Status button from Active to Inactive.
Step 4 – Delete the iSentry Axis app
Q&A and Troubleshooting
What if I run the iSentry Axis app without a license?
Running the iSentry Axis application without a license will result in no alerts or analytic events, because the analytic has stopped internally.
How to check the iSentry Axis Log
Go to Apps in Axis Camera web page, click the icon from ISentry axis app and choose App Log
How to set up the iSentry Message Queue Server and iSentry Deep Learning Processor
Check the document iSentry Event Management Server Installation Manual
Integrating iSentry Axis app with 3rd party integrator
iSentry Axis app works in the same way as Firefly that can be integrated via API endpoint or using alert push mechanism.
For the API integration, iSentry Axis app introduces authorization mode which provides extra security to access the endpoint. Also, the HTTPS protocol can also be supported. Please check the iSentry Third Party Integration document for detail.
Appendices
Supported Axis camera list
Technically, all axis camera with the below specifications will be assumed to work with the iSentry Axis application:
- Axis products with Axis 10.12 or later and 11.x. For a full list: please check here:
https://www.axis.com/support/tools/product-selector
check ARTPEC-8; single lens camera, no fisheye. For CV-25 chipset, contact us for detailed information. - Support extended micro-SD card (must be a High Endurance card, > 8GB class 10, V10)
- Internal storage must have at least 100MB free.
So far, the iSentry Axis app has been tested on the following camera models:
Camera model | Axis Firmware |
P3265-V | 10.12 |
M3064-V | 10.12 |
P1465-LE | 11 |
M2035-LE | 10.12 |
M3085-LE | 10.12 |