Child pages
  • opReports 3.x Release Notes
Skip to end of metadata
Go to start of metadata

opReports 3.1.0

This major update of opReports was published on 16 Nov 2017.

Please note that this version of opReports strictly requires NMIS 8.6.2G or newer to be installed on the same system.


  • There is a new report type "Class of Service", which presents Juniper-sourced Quality/Class of Service information.
  • This version also introduces the new report type "Configuration Summary", which presents an overview of the configuration items, monitored services and elements with alerts and thresholds for  any number of nodes.
  • opReports now supports CSV as format for Node, Interface and Type selection files, and logs inconsistencies with this input type better.
  • The report scheduler now handles 'impossible' reports more robustly and with fewer unnecessary retries
    (e.g. a daily report where the business week is set to Mon-Fri, which therefore cannot be generated for Sat or Sun)
  • The error reporting and logging was improved for greater robustness and clarity.
  • Various bug fixes and improvements.

opReports 3.0.14

This major update of opReports was released on 27 Jun 2017.

Please note that the licensing system has been updated, and licenses issued before July 2017 will not work for opReports 3.0.14: You will have to obtain an updated license for this version of opReports.
You can check your licenses by visiting the My Licenses page; If unsure about your options, please email


  • The Report Scheduling GUI was reworked completely which should make it much easier to use.
  • The Interface Capacity report offers more flexible percentile display options.
    You can now choose between showing
    • the 95th percentile for combined in and out utilisation,
    • or separate percentiles for in and out utilisation,
    • or the display of all three measurements (in, out and combined).
  • The validity checks for report schedules were extended, and invalid combinations of report options are now reported better.
  • The opReports scheduler is now started every 5 minutes by default (before: once hourly).
  • The installer was adjusted to support all recent mainstream Linux distributions: Debian 7, 8 and 9, CentOS/RedHat 6 and 7.
  • opReports now supports the new selection source "Business Service", which lets you select nodes and interfaces from one or more opCharts Business Service definitions.
    This feature requires that opCharts is installed (and licensed) on the same system. Like all other dynamic selection sources (e.g. node regular expression, group membership), Business Service selections are expanded at report creation time.

    Please note: when you add a license for opCharts for the first time, then it may take up to one hour for opReports to detect opCharts as available. Until then you'd see an empty list of Business Services in opReports' scheduling GUI. The simplest workaround is to restart the omkd application (using sudo service omkd restart) after the licenses are installed.
  • This version of opReports supports Delegated Authentication.
  • The landing page at /omk now checks for updates for all installed applications.
  • When opReports emails Zipped reports, Javascript files are not included anymore.
    GMail recently started rejecting all emails with JS files in them, which made it impossible to email opReports reports where GMail was involved.
    Furthermore, CSS files are now embedded in the report HTML when generating Zip archives.
  • The Node Availability report now correctly embeds graphs in XLSX outputs when instructed; in earlier versions graphs were incorrectly omitted unless HTML output was also selected.
  • Problems with the generation of scheduled reports are now handled more robustly and better error indications are shown in the GUI.
  • A new report  type called "Traffic Snapshot" was added. This report type integrates with and depends on opCharts Business Services.
  • Various internal robustness improvements and bug fixes.

opReports 3.0.12

This maintenance release of opReports was released on 20 Feb 2017.


  • The Node Availability report now supports selectable definitions for Uptime.
    If you set the config option  opreports_availability_nodata_separate to "true", then Uptime, Downtime and  No-Data periods are treated as non-overlapping, independent concepts.
    If "false" (the default), then uptime includes everything except confirmed downtime, i.e. Uptime includes (confirmed) uptime as well as periods of no data.
  • Embedded graphs in a Node Availability report now display No-Data periods as yellow bars.
  • The generated HTML reports now contain the URLs for any custom attached files in a Javascript object.
    window.opreports_custom_files is a map/hash of original name and instance URL. This makes it easier for a customised report template to refer to or render things like custom banners.
  • Minor bug  fixes and improvements.

opReports 3.0.10

Version 3.0.10 was published on 7 Nov 2016. It's a major release consolidating a number of features that were begun in 3.0.8.


  • The Node Availability and Interface Capacity reports now support embedded graphs.
    Embedded graphs work for the XLSX and HTML output formats; when emailing such reports, the HTML and graph files will be supplied as a ZIP.
    The size of the embedded graphs is configurable, and graph embedding can be enabled for each report instance.
    Embedded graphs also honor business hour and business week exclusions, which are shown shaded.
  • OpReports can now label nodes and interfaces with the name (as before) or optionally by custom naming property from NMIS.

    The GUI offers this option under the title "Node Naming" and "Interface Naming", similar in the schedules and the opreports-cli tool.
    Please note that using this feature requires NMIS version 8.6.0G or above.

  • Better error handling for editing of both report schedule as well as on-demand reports.
    Should there be are any mistakes or invalid inputs when a report schedule is edited, you will now get more precise feedback within the editing GUI.
  • opReports now supports more customisation options for HTML reports, including things like custom logos and the like.
  • various bug fixes and minor improvements.

opReports 3.0.8

This version of opReports was published on 17 Aug 2016 and is a preview/early-adopter's release with a number of new features.


  • There are two new report types, Node Availability and Interface Capacity.
    Please note that the exact contents of these reports may change somewhat up to the next major release.
  • Nodes can now be labelled with their name (as before) or optionally with any node property in NMIS (unique or not).
    The GUI offers this option under the title "Node Naming", similar in the schedules and the opreports-cli tool.
    Please note that using this feature requires either a customised Table-Nodes.nmis, or NMIS version 8.6.0G or above.
  • HTML reports are now templated and can be adjusted by the customer.
    Please note that the exact data interface between opReports and the templates is subject to change, but will be finalised (and documented) by the next major release.
  • opReports now produces higher-precision data in CSV and XLSX outputs (more decimals for fractional numbers), and the display of fractional numbers and interface speeds in HTML reports was reworked.
  • The navigation/menu bar was updated for responsive operation and  now works better on small screens.
  • opReports now supports the concept of filtering by Business Days, and the GUI by default offers the choice of unrestricted and 'monday to friday' business weeks.
    This feature is independent of but compatible with business hours filtering, i.e. you can use neither, one or both.
  • All reports that display interfaces now include the interface description (aka ifAlias) as a separate column.
  • The WAN report's status color is now based correctly on the worst interface of a node, and the restriction to only process nodes with an NMIS net type 'wan' was removed (see config  option wan_nettypes).
  • The HTML report footers now include the correct application version.
  • Various installer robustness fixes and support for non-interactive installation, and simple uninstallation.
  • and a variety of internal efficiency improvements and other minor adjustments.

opReports 3.0.7

This maintenance release of opReports was published on 8 Apr 2016 and can be downloaded here.


  • Report schedules now support multiple email addresses (comma-separated).
  • Node+Interface+Type selection files now work for scheduled reports.
  • The schedule editing GUI now displays whether any perviously uploaded selection files are already present on the server.
    Repeated edit operations for uploadable selection files was made more robust.
  • To simplify diagnostics, the opReports log now contains the actual report generator command line arguments for both on-demand and scheduled reports.

opReports 3.0.6

This maintenance release of opReports was published on 16 Mar 2016.


  • The multiprocessing code was made more robust, and the selftest should no longer report problems about not being able to run "df".
  • Node and Group selections in the report generation gui are now sorted.
  • Uploading of Node+Interface+Type selection files now works for on-demand reports.
  • opReports' timezone handling was greatly extended.
    If you set the config option omkd_display_timezone to your desired timezone, then all times in the opReports GUI will be displayed in that timezone and including the timezone offset.
    You can use any timezone definition from the ISO8601 standard and the Olson database, plus "local" (meaning the timezone configured on the server).
    If this option is not set, the times will be shown in the "local" timezone but without zone offset. If explicitely set to "local", the offset suffix is shown.
  • The WAN reports now show interface descriptions with interface names.

opReports 3.0.4

This version is a maintenance release, primarily fixing bugs and various usability issues; it was released on 2 Dec 2015.


  • opReports 3.0.4 now offers free licenses which are not time limited (but limited to 20 nodes).
  • opReports now supports optional Single-Sign-On across servers.
  • Report schedules by group ("Each" or specific group name) now works correctly.
    In 3.0.2 such reports were incorrectly rejected by the report generator, with the log message being "no nodes or interfaces found".
  • A number of GUI pages were reworked for improved compatibility and usability.
    The schedule editor displays better checkboxes.
    Lists of nodes and groups are now sorted before display (for both scheduled and on-demand report creation).
    All irrevocable operations in the GUI now require confirmation.
  • The new configuration option opreports_application_heading lets you change the page heading to a custom value.
  • Various installer improvements and minor bug fixes.

opReports 3.0.2

Version 3.0.2 was released on 4 Jun 2015. This is a stable, general release.

Changes since the 3.0 pre-release

  • The report scheduling system is now fully manageable from the GUI (but we also retained the ability of very direct control via JSON schedule files).
  • Reports can now be deleted from the GUI, which also includes uncompleted reports whose generation has not been completed (due to misconfigurations for example).
  • opReports now offers an authorisation mechanism for reports: you can optionally designate an NMIS group, whose members are the only users allowed to see a report.
  • Only admin users can access the scheduling system. Non-admin users are only able to see reports they are authorised to see.
  • The opReports installer was improved for greater robustness.
  • Error reporting was improved.
  • Integration between command-line tool and GUI was improved.

opReports 3.0

Version 3.0 was released on 8 Apr 2015. This is a pre-release of the 3.X series of opReports; a general full release is expected to follow very soon.


  • A new look and feel: the GUI was completely rebuilt and now behaves like our other modern applications.
  • A new, flexible scheduling system: any number of repeated or one-off reports can be specified, each with their own parameters and options.
  • A number of new report types, both special-purpose as well as generic ones
  • More flexibility: there are new mechanisms for selecting nodes and interfaces, the report titles and the banners are configurable
  • A comfortable interactive installer: opReports now uses the Opmantek Installer for installation and upgrades.
  • Better archive management: You can now define how long (and where) opReports should keep particular reports (or classes of reports).
  • Easier archive access: The opReports GUI now keeps track of all reports (scheduled or on-demand) and provides fast access to them.
  • More output formats: reports can now be created in HTML (for both inline as well as standalone viewing), CSV and XLSX - all selectable.
  • More self-contained outputs: reports are now saved together with their metadata, which captures all parameters and inputs of a report.
  • Better exporting: You can now get a report in ZIP form from the GUI. The GUI also allows you to email that ZIP file to anybody.
  • Nicer Emails: reports can be emailed to anybody (automatically on generation), and contain all selected formats as attachments.
  • Easier Administration: opReports now has a self-test (for diagnosing common problems) and is much easier to configure than before.
  • No labels