All Collections
Documentation and help
VMS Gateway
Troubleshooting
Testing VMS Gateway using ONVIF device manager
Testing VMS Gateway using ONVIF device manager

ONVIF Device Manager (ODM) is a tool that can be used to check if your VMS Gateway installation is working

Updated over a week ago

If you are having trouble getting VMS Gateway to work, there is an open source tool called ONVIF Device Manager (often abbreviated to ODM) that is often used as an ONVIF test and validation tool. It is only supported on Windows.

You can download ONVIF Device Manager from SourceForge.

Diagnosing issues

There are two main types of issue you can face with VMS Gateway:

  • There is a network problem stopping your VMS Gateway working correctly with your VMS.

  • There is compatibility issue between VMS Gateway and your VMS

The first step is to try and eliminate the first potential issue.

Steps:

  • Download ODM onto a machine on the same network as your VMS.

  • When you run ODM it will search your network for any ONVIF devices that it can see on your network:


  • The virtual ONVIF devices you have created should appear in the list on the left. Don't click on it just yet, or you'll likely get an error that you are not authorised:

If your virtual ONVIF device does not appear in the list then this could signify a network issue.

You can try manually adding your virtual ONVIF device to ODM, otherwise please review this list of common networking issues.

  • Enter your ONVIF/RTSP credentials into the Name / Password fields at the top of the page. When you hit Log in ODM will rescan your network using the credentials you supply.

  • If you have entered the credentials correctly you should not that the Firmware field now shows the VMS Gateway version number - if not please retry the previous step:

  • Click on one of your virtual ONVIF devices. It should now list each of the output streams in the next columns (if you do not, and see an authentication/authorised error you should re-enter your ONVIF/RTSP credentials):

  • Under the NVT section there should be an item listed for each of your output streams. The final part of the name of each item should correspond to the name of the EdgeVis encoder you added as an output stream.
    Note: preview images for each output stream are disabled for security reasons.

  • On one of your output streams click the Live video link. This should open another panel to your right, and after a short delay, the corresponding EdgeVis encoder should being video playback:

If you can successfully play the video within ODM then it is likely that you do not have a networking issue and the installation and configuration of VMS Gateway was successful.

It is more likely that you have an issue between VMS Gateway and VMS.

If you require video streaming (and no advanced features such as PTZ) then your next step is to use VLC to test VMS Gateway. Otherwise you should contact support for further guidance.

Manually adding your virtual ONVIF device to ODM

If you can not see your virtual ONVIF device listed in ODM then it is likely you have a networking issue.

ONVIF discovery relies on your network supporting multicast data packets, which some IT prohibit and block. Additionally these normally only operate on the same subnet as your VMS Gateway installation.

As an additional test it is possible to skip automatic ONVIF discovery, and manually add your virtual ONVIF device directly to ODM.

Steps:

  • From the VMS Gateway homepage, click the > button on one of your virtual ONVIF devices.

  • On the details page of your virtual ONVIF device click the Discovery URL button - this will copy the ONVIF Discovery URL to your clipboard:

  • Within ODM, click the Add button at the bottom left of the window. This will open up the Add device dialog box:

  • In the URL: text box, delete any address there, then paste in the address from the previous step.

  • After hitting Apply, this will add a new entry into the device list (it will be marked as a Manual entry:

  • Click on the new manual entry in the list. If ODM is unable to contact your virtual ONVIF device, it is likely you will see an error like this:

If ODM doesn't connect can't see your virtual ONVIF devices it is likely you have a networking issue. Please refer to this list of common networking issues for further guidance.

If ODM can stream when you manually add the virtual ONVIF device it likely there is an issue with multicast packets on your network. You should add the remainder of your devices manually - there is no loss in functionality, it is only automatic discovery that relies on multicast.


Did this answer your question?