Manual Plugin Installation

This page describes how to manually install the plugin if automatic installations do not work

Plugin Installation

The Nx Meta Server version 6.1.1 and newer is packaged with the AI Manager Plugin, so a separate installation should not be necessary.

If the Mediaserver installation does not come with the plugin, refer to the scripted installation or manual installation.

The desktop client does not need a separate installation of the plugin.

Scripted Installation

If your installation did not come with the AI Plugin, you can install it yourself.

The manual installation works on Linux based systems with a single command line script.

Installing the AI Manager Plugin restarts the Mediaserver. This takes a couple of seconds, and the client reconnects automatically.

Open a terminal window on the device where you installed the Mediaserver and execute the following command to install the AI Manager plugin:

sudo bash -c "$(wget -q -O - https://artifactory.nxvms.dev/artifactory/nxai_open/NXAIPlugin/install.sh)"

This script downloads the latest plugin and places it in the appropriate plugin folder.

The installation detects device features and selects appropriate settings, which is sufficient for most users and devices. If customization is needed or the automatic installation fails, install the AI Manager manually.

Re-installation or Updates

To update or reinstall the AI Manager Plugin, safely re-run the same command.

The install script removes the old version of the plugin before installing the new version.

Existing settings are stored and reused. Check the settings afterward, because new options may require changes. An example might be a new runtime that is available for your hardware.

Advanced Manual Installation

Linux

The plugin can be downloaded from the following link for x86 devices:

https://artifactory.nxvms.dev/artifactory/nxai_open/NXAIPlugin/release/libnxai_plugin.soartifactory.nxvms.dev

Plugin download link x86_64

You can also download an aarch64 version of the plugin for ARM64 based devices:

https://artifactory.nxvms.dev/artifactory/nxai_open/NXAIPlugin/release/libnxai_plugin_aarch64.soartifactory.nxvms.dev

Plugin download link aarch64

Once downloaded, copy the plugin file to the appropriate plugins folder.

/opt/networkoptix-metavms/mediaserver/var/nx_ai_manager/libnxai_plugin.so

The folder and the plugin file should be named in this exact way. Rename the plugin file if necessary.

Make sure to give read and write permissions to the created directory so that the AI Plugin can create the files it needs by running:

sudo chmod -R 777 /opt/networkoptix-metavms/mediaserver/var/nx_ai_manager

Once installed, the Mediaserver must be restarted before the plugin is detected.

Windows

On Windows, the plugin cannot be downloaded separately.

The plugin is installed on windows in the following location.

C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins\nx_ai_manager_plugin

The installed Mediaserver path differs for each VMS variant, such as Nx Meta:

C:\Program Files\Network Optix\Nx Meta\MediaServer\plugins\nx_ai_manager_plugin

Verifying the Installation

Once the plugin file is in place and the Mediaserver has been restarted, open any camera's settings in the desktop client, navigate to the Integrations tab, and confirm that AI Manager appears in the plugin list.

AI Manager appears in the Integrations tab once the plugin file is installed and the server has been restarted

Customized Installation Path

The install path can be customized for testing purposes and manually started to see output. The AI Manager Plugin expects the AI Manager to be installed in the same folder. The Stop/Start commands in the AI Manager Plugin UI do not work if the AI Manager is installed elsewhere.