Overview

The default VMS installation includes a basic Milesight plugin developed by the Nx integrations team. However, Milesight has since developed their own upgraded plugin for our VMS, offering enhanced features and improved performance.

This document guides you through the replacement process to exchange the default plugin for the new, official Milesight plugin.

Notes

Please read these notes carefully before proceeding.

• Avoid Running Both Plugins: While it is technically possible to run both plugins simultaneously, doing so creates a redundant load on both the Media Server and the camera hardware. This is strongly discouraged.

• Rule Configuration Loss: Transitioning to the new plugin will void any event rules associated with the previous plugin. You will need to recreate your rules for the new Milesight plugin once the installation is complete.

• Authorization: Administrator/sudo privileges are required to move files in the Media Server installation directory and to restart the service. On Windows, if File Explorer prompts for administrator confirmation, click Continue or run File Explorer as Administrator. For Linux you use sudo.

• Monitoring: The plugins_optional folder is not monitored by the Media Server. Files stored there will not load unless manually moved back.

• Services: A service stop/start is always required after moving a plugin, changes do not take effect while the service is running.

Steps to disable the current Milesight Plugin

Windows

1. Stop the Media Server service: open Task Manager (Ctrl+Shift+Esc), go to the Services tab, find networkoptix-mediaserver, right-click it and select Stop.
2. Open File Explorer and navigate to the active plugins folder: 
   C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins
3. Cut (Ctrl+X) the milesight_analytics_plugin.dll file the  from the active plugins folder: 
   C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins
4. Paste (Ctrl+V), the file to the inactive folder: 
   C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins_optional
5. Start the Media Server service: open Task Manager (Ctrl+Shift+Esc), go to the Services tab, find networkoptix-mediaserver, right-click it and select Start.

Linux

To disable a plugin file: 

1. Open the terminal (Ctrl+Alt+T).
2. Move the plugin file to the inactive folder: 
   sudo mv /opt/networkoptix/mediaserver/bin/plugins/libmilesight_analytics_plugin.so /opt/networkoptix/mediaserver/bin/plugins_optional/
3. Restart the Media Server service: 
   sudo systemctl restart networkoptix-mediaserver.service

Steps to enable the current Milesight Plugin

Download the Milesight Analytics Plugin for Network Optix for the Operating System you use from the Milesight Website HERE, under SDK & Plugin, and unzip the downloaded file. 

Windows

1. Stop the Media Server service: open Task Manager (Ctrl+Shift+Esc), go to the Services tab, find networkoptix-mediaserver, right-click it and select Stop.
2. Open File Explorer and navigate to the folder where you extracted the zip file.
3. Cut (Ctrl+X) the entire milesight_analytics_plugin_windows folder the  from folder where you extracted the zip file. 
   (NOTE: not the milesight_analytics_plugin_windows_<version> folder, but one level down)
4. Paste (Ctrl+V), the folder to the active folder: 
   C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins
5. Start the Media Server service: open Task Manager (Ctrl+Shift+Esc), go to the Services tab, find networkoptix-mediaserver, right-click it and select Start.

Linux

1. Open the terminal (Ctrl+Alt+T).
2. Move the plugin folder from the folder where you extracted the zip file (/Downloads in this example) to the destination folder.
   sudo mv /home/<user>/Downloads/milesight_analytics_plugin_linux_<version>/milesight_analytics_plugin /opt/networkoptix/mediaserver/bin/plugins/
3. Restart the Media Server service: 
   sudo systemctl restart networkoptix-mediaserver.service