AXIS Optimizer Body Worn Extension
AXIS Optimizer Body Worn Extension is an application that enables the connection between the Axis body worn system and Milestone XProtect®. Data transferred from the Axis body worn system includes video, audio, searchable location, categories, and notes.
How does it work?
The Axis body worn solution consists of at least one Axis body worn camera, an Axis docking station, an Axis system controller, and a content destination, in this case Milestone XProtect®. AXIS Body Worn Manager is the web application that lets you configure and manage your body worn system.
When you add a new user in the Axis body worn system, a new hardware, corresponding to the new user, is created in XProtect®. Each user in the body worn system uses one license in XProtect®.
When you place the Axis body worn camera in the docking station, the recording transfers start automatically. It takes a while before the recordings can be viewed in the XProtect® Smart Client. You can monitor the status of the file transfers in AXIS Body Worn Manager.
The beginning of each recording has a bookmark. The bookmark, shown in XProtect®, contains the following information:
camera name
activation method, for example if the recording was started using the button or by fall detection
any location data
any annotations from the category and notes created in AXIS Body Worn Assistant
System modes
AXIS Optimizer Body Worn Extension lets you choose between two system modes when setting up the connection with Milestone XProtect®.
User-centric system mode (recommended)
Each hardware device in Milestone XProtect represents a body worn user.
One user in the body worn system results in one Milestone XProtect license.
Control permissions on the user level.
Search recordings based on user.
Add, remove, or replace body worn cameras in the body worn system without affecting the structure in Milestone XProtect.
Replacing a body worn user results in a new hardware device in Milestone XProtect.
Device-centric system mode
Each hardware device in Milestone XProtect represents a body worn camera.
One camera in the body worn system results in one Milestone XProtect license.
Control permissions on the camera level.
Find user information related to recordings in metadata or bookmarks.
Add or remove body worn users without affecting the structure in Milestone XProtect.
Replacing a body worn camera results in a new hardware device in Milestone XProtect.
If you’re migrating a system, select the same system mode that you’re currently using.
System requirements
Milestone XProtect® 2020 R1 Corporate or newer versions, or
Milestone XProtect® 2020 R1 Professional+ or newer versions, or
Milestone XProtect® 2020 R1 Expert or newer versions
Siemens Siveillance® 2020 R1 Video Pro, or
Siemens Siveillance® 2020 R1 Video Advanced, or
Siemens Siveillance® 2020 R1 Video Core Plus
At least 10 GB of free disk space.
Always use the latest XProtect hotfixes and cumulative patch installers.
Get started
Install AXIS Optimizer Body Worn Extension
On the Milestone XProtect® Recording Server, run AxisOptimizerBodyWornExtensionSetup.exe.
Follow the instructions in the setup wizard.
- A firewall rule is added to the recording server during installation to allow incoming traffic on port 55771.
- The XProtect Recording Service will restart during installation.
Create a connection file
Right-click the application icon in the taskbar.
Select Open connection setup.
Select system mode. See System modes. Changing the system mode at a later time requires a full system reset.
Enter the address for the Milestone XProtect® Management Server.
Enter the Milestone XProtect® administrator account credentials.
- Note
We recommend that you log in using a separate XProtect® administrator account when setting up the connection with the Axis body worn system.
Click Login.
Select a Certificate installed on your machine. Alternatively, click Create a self-signed certificate to create one, and then select it.
- Note
- You need to setup a server certificate to secure the communication with the Axis body worn system. The selected certificate must contain a SAN (Subject Alternate Name) field, including a DNS name or IP address that identifies the recording server.
- If you're using Windows Server 2012 R2 you need to manually create the certificate.
Click Create connection file.
- The connection file contains information that enables data to be pushed to your Milestone XProtect® system. We recommend storing the connection file in a secure location. Alternatively, delete the connection file permanently after setting up the connection between the Axis body worn system and Milestone XProtect®.
- To maintain a stable connection between the Axis body worn system and Milestone XProtect®, we recommend using a DNS name for the Milestone XProtect® Recording Server.
Connect to the Axis body worn system
Make sure that you use the latest firmware for the Axis body worn system.
Access the Axis body worn system using a web browser.
Follow the instructions in the setup wizard.
In the Content destination step, upload the connection file that was generated by AXIS Optimizer Body Worn Extension.
For more help about setting up and using the Axis body worn system, go to Axis body worn solution help center.
Retention time
Change the retention time in Milestone XProtect®
To avoid losing recordings, we recommend changing the retention time in XProtect® to a higher value.
Using the default retention time of 7 days causes all recordings older than 7 days to be permanently deleted when uploaded from the body worn camera to XProtect®.
Control retention time with categories
You can add a category for a video in AXIS Body Worn Assistant (mobile application for recording categorization and annotation). In AXIS Optimizer Body Worn Extension, you can specify a retention time for a category. This generates an Evidence Lock for the category in Milestone XProtect® Smart Client.
To set the retention time for a category:
Right-click the application icon in the taskbar.
Select Settings.
Enter a Retention time (days) for any of the existing categories, or
Click + to add a new category, choose a category from the drop-down, and enter a Retention time (days) for the added category.
- Retention time is the time from when the recording was created until it is automatically deleted.
- The retention time set in AXIS Optimizer Body Worn Extension guarantees a minimum retention time. It may be longer if set to a higher value in the storage configuration for the recording server or device in XProtect®.
- If you leave Retention time (days) set to <default>, an Evidence Lock is not created.
- The retention time setting requires Evidence lock support, which is only supported on XProtect® Corporate and Siveillance® Video Pro. The setting is not available for any other product.
Offload corrupt recordings automatically
If a camera has issues that result in corrupt timestamps on recordings, it can be difficult to offload the files to Milestone XProtect®. You can set up the system to automatically offload such recordings to a folder on the recording server. Whenever files are offloaded to the folder, you get an alarm in the VMS.
- To set up automatic offloading of corrupt recordings:
Right-click the application icon in the taskbar.
Select Settings.
Under Corrupt recordings, turn on Automatically offload corrupt recordings.
Select the location for storing the files.
Select the number of days to save the files.
Maintenance
Remove a user from the system
Remove the user in AXIS Body Worn Manager.
- Note
The user device is disabled in XProtect, and the channel license is released. It’s no longer possible to view recordings by the user, but the recordings are still intact. To access them, enable the device.
Delete the device in XProtect® when you no longer need the recordings made by the user.
Never remove an enabled device in XProtect®. Always remove it from AXIS Body Worn Manager first.
Create a new self-signed certificate
To create a new self-signed certificate:
Right-click the application icon in the taskbar.
Select Open connection setup.
On the current certificate, click ✖ to reset the certificate binding.
Click Remove current self-signed certificate.
Click Create a new self-signed certificate.
Select the new certificate.
Migrate to a new server
Export users from the body worn system, see Export users.
Install AXIS Optimizer Body Worn Extension on the new Milestone XProtect recording server, using the same system mode as for the old server, see System modes for more information.
Move camera hardware objects from the old Milestone recording server to the new Milestone recording server.
Create a new connection file on the new Milestone XProtect recording server, see Create a connection file.
Upload the connection file to the body worn system in AXIS Body Worn Manager.
Troubleshooting
The taskbar icon turns red to indicate that something is wrong. Right-click the taskbar icon and select Show error information to see details about the problem.
Problem | Symptom | Probable cause and solution |
---|---|---|
Can’t connect to the Axis system controller | The web interface of the Axis system controller says: “Connection failed” |
|
Recording transfer error |
|
|
Recording is incomplete | Parts of the recording are missing in Smart Client. | Recordings are transferred in chunks, and not necessarily in chronological order. A bookmark is created at the beginning of the recording as the last step of a transfer. If no bookmark is found, the transfer is most likely not yet completed. Wait for the transfer to finish. |
Recording is missing | I can see a bookmark in Smart Client but there is no recording. |
|
No search results for Location data in Milestone XProtect® | Location data is not searchable for users added in version 1.0. | Upgrade to version 1.1 or higher and create new users in the body worn system. |
GPS coordinates are not shown in bookmark descriptions in Milestone XProtect® because Location data is not enabled in the body worn system. | Refer to the body worn solution user manual for information on how to enable and use Location data. | |
Connection lost between the body worn system and Milestone XProtect® | IP address changed on the Milestone XProtect® recording server. |
|
Corrupt recording detected | An error message in Milestone XProtect says: “Corrupt recording detected”. | Set up the system to automatically offload corrupt recordings to a separate folder on the recording server. For instructions, see Offload corrupt recordings automatically. |
After fixing a problem it can take a while for the system to transfer the recording, and for the taskbar icon to turn green. Restart the system controller to speed up the transfer.
Need more help?
Contact support
If you need more help, go to axis.com/support.
To help finding a quick solution, provide logs. To get the logs:
Right-click the application icon in the taskbar.
Select Save logs.