For the complete documentation index, see llms.txt. This page is also available as Markdown.

Plugin checks

Things to check if the plugin is running correctly, and how to check it.

Confirm the System checks pass first.

Check the Integration Installation

Check the device settings page for the "AI Manager" plugin in the Integrations tab. Download the plugin if the tab or the AI Manager entry is missing.

Is the Plugin Available

When opening the camera settings the Integrations tab is available, and on the Integrations tab the AI Manager is present

Camera Settings dialog with the Integrations tab selected, showing AI Manager listed in the plugin list
AI Manager present in the Integrations tab

Is the Plugin Installed

If the plugin is not available, verify whether it is installed and check its version.

  • Nx Meta version 6.0 or newer is required.

  • The plugin requires version 4.0 or higher. This document uses the plugin version 4.6 or higher.

The plugin might not be properly installed. Follow the instructions at Starting the plugin, and check that the plugin file is installed at:/opt/networkoptix-metavms/mediaserver/bin/plugins/nxai_plugin/libnxai_plugin.so

If the plugin file is not there, or it exists but the server still cannot detect it, follow the Manual Plugin Installation or Manual Plugin Installation manual installation instructions.

Are the Needed Drivers Installed: NVIDIA Orin Accelerated

If you're running on NVIDIA Orin - is a current version of NVIDIA Jetpack installed?

Are the Needed Drivers Installed: Hailo Accelerated Devices

The runtime using Hailo accelerators requires the correct Hailo Runtime (hailort). Currently, the AI Runtime supports Hailo driver version 4.17.0. Ensure that the correct runtime is installed.

Is the AI Runtime Running

The AI Runtime is the hardware-specific inference engine that runs as a sub-process inside the AI Manager plugin. It starts once a device is set active.

Check the Plugin Interface

If the plugin is not running, the Plugin tab shows a deactivated toggle for the device.

Camera Settings Integrations tab showing the AI Manager toggle in the off/disabled position
Device disabled - toggle is off, device is not sending frames for inference

Enable the AI Runtime by clicking the Device Active switch.

Camera Settings Integrations tab showing the plugin active with Device Active toggle on and active pipeline summary in Device Overview
Plugin active with Device Active enabled - the AI Runtime is running

Check the Command Line

Check the console if it is running with the following command:

The return should be something similar to if the plugin is running:

If none of these lines are present, the AI Manager is not running.

Is It a Model Problem?

Confirm that the model has something to detect. For example if you're using a model that is expecting vehicles, that will not be detected on a camera that is viewing an empty warehouse.

Is the Model Working

Check if the module is started by looking into the logfile at /opt/networkoptix-metavms/mediaserver/bin/plugins/nxai_plugin/nxai_manager/etc/sclblmod_log.log.

It should show updates like the following:

If there is no output, or the only output is an error message the plugin is not running.

Is the Model Downloaded

Find the model ID on the model detail page in the AI Manager Cloud:

AI Manager Cloud model detail page showing the model UUID highlighted in the URL and on the page
The model ID (UUID) is shown on the model detail page: use it to locate the cached file.

Models are stored in the local filesystem at:

Open an SSH session to the server and use ls to confirm the file exists:

The model file is stored encrypted, so its size will be similar to but not exactly match the size shown on the model detail page in the cloud.

Last updated