Configuring Mobotix Cameras
This document describes Viakoo’s special support for Mobotix cameras and how to set up your Viakoo environment to monitor and collect data from this special class of cameras.
Because Mobotix cameras have an onboard video management system (VMS), they can be configured to record to local storage (SD card) or network attached storage without a 3rd-party VMS. Normal Viakoo discovery and data collection is done from the vantage point of a recording server so users will need to explicitly add these devices to include self-recording Mobotix devices into the site’s configuration.
Starting in agents <y2020q1>, Mobotix cameras can be added explicitly through the ViakooCA Console.
Users who have configured in Mobotix cameras with older Viakoo Agents using the mobotix-config.csv camera discovery file will have to migrate to the new agents through procedures outlined below.
Adding Mobotix cameras using the ViakooCA Console
For with built-in Mobotix support, you will see a “Mobotix Cameras” row in the expanded view for any configured ViakooRA on the ViakooCA Home Screen. Click “add a Mobotix camera” on the right end of the row. This will bring up the “Add a Mobotix Camera” pop-up.
The pop-up allows you to add a camera by prompting you to enter the following fields:
- Protocol [either HTTP or HTTPS]
- Camera IP Address (required)
- Custom Camera Port Number (optional - see below)
- Camera Name
- username (required for detailed camera configuration and status)
- password (required for detailed camera configuration and status)
- SNMP Port Number (necessary for base collection of Mobotix OID)
- SNMP Read Community Name (necessary for base collection of Mobotix OID)
You must have an IP Address for the camera. Other entries are optional though if no username/password or SNMP credentials are supplied, Viakoo agents can only PING the device to determine status.
Camera port defaults to port 80 for http and 443 if enabled for https if no entry is supplied. However, if you have a Mobotix cameras that are located at a site without a server, with each camera referenced through the firewall-gateway with different port-forwarding entries for each camera, you can supply the IP address of the firewall-gateway and then enter the port reference for that camera.
Camera Name becomes the name associated with the device in Viakoo. Though optional, it is valuable to have a name so you can easily identify this device.
The username and password fields allow the Viakoo agent to pull nearly all the available configuration and status information from the device.
SNMP port and read community string allow the Viakoo agent to pull additional fields available through standard and Mobotix specific OIDs. If no values are given, they default to standard default values. SNMP must be enabled in the device for these fields to be collected.
Adding Multiple Mobotix Cameras at Once
If you have numerous Mobotix Cameras, go to the main ViakooCA menu, and click on “Mobotix Cameras” in the “Add Multiple:” section:
This brings up a page which allows you to enter several Mobotix cameras:
The main form allows you to enter one after the other. As you start entering a device in the first row of the form, another form row will appear. Each row has the same fields as before when adding just a single Mobotix Camera with the addition of the Select an RA dropdown, to choose the ViakooRA that should be responsible for collecting data.
You can include as many devices as you would like in this step. When you have all your devices entered, click “Save Mobotix Cameras” and follow the instructions in the pop-up to persist your entered devices to the system.
Clicking on “Load CSV” allows you to import a spreadsheet (of type CSV) that contains all your Mobotix cameras. This will populate the ui with the data from your spreadsheet. From there you can make any needed adjustments before clicking “Save Mobotix Cameras” to persist everything.
For best results make sure to include a header row with the names of the fields listed in the interface. To download an example spreadsheet with the correct column headers, click the “Template” button.
Reviewing Mobotix Camera Configuration
From the Home Screen you can review the Mobotix Cameras that have been configured for each ViakooRA in the “Mobotix Cameras” section.
Any individual Mobotix camera can be removed () or modified (). Clicking on the settings / modify icon (), brings up the “Update” pop-up:
From this window, any of the settings can be modified. Clicking “Save” will commit your changes. Cancel will leave the entry unchanged.
Viewing Mobotix Cameras in Viakoo
Properly configured, your Mobotix devices will then show up in the Viakoo web console. You will see them in both the camera table and, if the credentials are correct, in the stream table.
Migrating from Older “Discovery File” Configurations
Earlier releases of Mobotix support in Viakoo agents relied on a discovery file (mobotix-config.csv) placed in a specific location in the RA’s server. This will no longer work for agents version <y2020q1> or later.
Instead of having separate files for each RA with mobotix cameras, these cameras can be entered from the CA Console in one location. The ideal process is to merge your older mobotix-config.csv files into a single import csv to load into the new “Add Multiple: Mobotix Cameras” interface.
NOTE: To avoid losing work, make sure you copy your mobotix-config.csv files to a safe location before upgrading the agents.
The new format for importing:
Is a bit different from the old template as follows:
- There is a new first column which specifies the protocol (“HTTP” or “HTTPS”).
- Rather than embedding custom port information in the IP address, custom port entries are their own separate column.
- The new template requires that you specify the RA to be used to collect the data as opposed to this being implicit based on where you’ve located the file.
Now, working with Viakoo, upgrade your agents to the new version-level that supports Mobotix cameras through the CA console. Then, go to the ViakooCA Console’s “Add Multiple: Mobotix Cameras” menu item. Then, import this new CSV spreadsheet file you’ve created to re-add your Mobotix cameras.
Contact your Viakoo Support personnel if you have any questions about the migration process (email: firstname.lastname@example.org).