opReports 4 is the NMIS 9 compatible version. In this guide, you will learn all you need to start using opReports 4.
The main difference from versions < 4.0.0:
opReports is distributed in a self-extracting download format that simplifies the installation process quite a bit. More information on running the installer can be found HERE: The Opmantek Installer
Transfer the opReports installer onto the server in question, either by direct download from the Opmantek website, or from your desktop with scp
or sftp
or a similar file transfer tool.
Make a record of where you put the tarball (root's home directory or /tmp
are good locations).
Start the interactive installer and follow its instructions. The installer now fully covers both initial installations as well as upgrades from earlier versions of opReports.
sudo sh ./opReports-Linux-x86_64-4.1.0.run ... ++++++++++++++++++++++++++++++++++++++++++++++++++++++ opReports (4.1.0) Installation script ++++++++++++++++++++++++++++++++++++++++++++++++++++++ ... This installer will install opReports into /usr/local/omk. To select a different installation location please rerun the installer with the -t option. |
opReports works almost completely "out of the box" and requires just a very few configuration settings to be adjusted initially:
Many reports contain clickable links to NMIS, which require that the setting for nmis_host_base
is correct. It is also important that the configuration setting opreports_url_base
is correct, or your report will display badly.
These are set in /usr/local/omk/conf/opCommon.json.
See the next item for details on how to modify this file safely.
Make a backup of /usr/local/omk/conf/opCommon.json before you edit the file as a syntax error induced in the file will cause all OMK applications to cease to function
The nmis_host_base configuration is required to make sure that graphs and other linked things can find the server correctly from a report which has been emailed.
"nmis_host_base":"http://nmis.yourcompany.com", "opreports_url_base":"http://nmis.yourcompany.com", |
When you're done making these adjustments, restart the Opmantek Web service with
sudo service omkd restart
.
If you plan to email reports out (via the CLI tool or the GUI), then it's vital that the email configuration is adjusted to reflect your environment.Open /usr/local/omk/conf/opCommon.json
with an editor of your choice, look for the section labelled "email
" and change the values as required.
When you're done making these adjustments, restart the Opmantek Web service with
sudo service omkd restart
.
If you want to run scheduled reports very frequently, then the default frequency for the opReports scheduler may be insufficient.
By default opReports installs a cron file (in /etc/cron.d/opreports
) which runs opreports-scheduler.pl once per hour. Feel free to modify that cron file to your liking.
Starting from version 4.2.0, we have made significant changes on our internal shared code for all our applications to work on Opmantek's latest and fastest platform, however, previously installed product are not compatible with this version.
To find out more about this upgrade please read: