Introduction

Opmantek applications' released on or after 30 Sept 2020 will work on Opmantek's latest and fastest platform, however, earlier installed products are incompatible with this new platform.

This solution was needed as NMIS 8.6.7G1, opReports 3.2.0 and other Opmantek applications released prior to 30 September were installed on server(s).
However, opReports 3.4.1 was needed to overcome the issue in the  95th Percentile calculation in the WAN Utilisation Distribution Report and the WAN Utilisation Distribution Summary Report prior to opReports 3.4.1


Install parallel opReports 3.4.1 to /opt/omk/

opReports 3.2.0 and other Opmantek applications released prior to 30 September were installed on server(s) at /usr/local/omk/

opReports 3.4.1 was then installed at /opt/omk/ as follows:


Food for thought: Experimental (untested) suggestions

  1. Implement the omkd-standalone service on port 8043:

    # set up init.d service (opReports-3.4.1-standalone.tar.gz was built on a VM with systemd
# - hence the '.bak' in filename at this stage: install/omkd-standalone.init.d.bak)
# - we copy to /etc/init.d and rename file to omkd-standalone
sudo cp install/omkd-standalone.init.d.bak /etc/init.d/omkd-standalone
# on Debian or Ubuntu we would now:
#		sudo update-rc.d omkd-standalone defaults
# but we are on Centos, so:
sudo chkconfig --add omkd-standalone
sudo chkconfig omkd-standalone on

sudo service omkd-standalone start


  2. This suggestion requires implementation of omkd-standalone service on port 8043 as per Point 1. immediately above.
    This suggestion should integrate omkd.service and omkd-standalone service better - with opReports 3.4.1 seamlessly replacing opReports 3.2 in the GUI.
    Replaces /etc/apache2/conf.d/05omk-standalone-proxy.conf with this /etc/apache2/conf.d/03omk-standalone-proxy.conf

    sudo rm /etc/apache2/conf.d/05omk-standalone-proxy.conf

# this is one copy and paste command - up to 'EOF' about 3 lines from the end of this code block:
#
sudo cat > /etc/httpd/conf.d/03omk-standalone-proxy.conf <<EOF
## For more information on the listed Apache features please consult:
## http://httpd.apache.org/docs/

# Don't forget to restart the daemon if you make changes to this configuration file1
# apachectl restart

<IfModule mod_proxy.c>
ProxyRequests off

<IfModule mod_headers.c>
# if you are using the Opmantek applications behind an ssl-terminating apache vhost,
# then you should adjust the vhost configuration to add this header but with 
# protocol "https". 
# The Opmantek applications are location- and protocol-independent in almost all cases.
RequestHeader set X-Forwarded-Proto "http"
</IfModule>

<Location "/omk/opReports">
    ProxyPass http://localhost:8043/omk/opReports retry=5
    ProxyPassReverse http://localhost:8043/omk/opReports
                ErrorDocument 503 '<html><head><meta http-equiv="refresh" content="60"></head><body><h1>Temporary Service Interruption</h1>The requested OMK page should be back soon. This page will automaticall$
</Location>

<Location "/omk">
    ProxyPass http://localhost:8042/omk retry=5
    ProxyPassReverse http://localhost:8042/omk
               ErrorDocument 503 '<html><head><meta http-equiv="refresh" content="60"></head><body><h1>Temporary Service Interruption</h1>The requested OMK page should be back soon. This page will automaticall$
</Location>

# the first location directive only covers /omk and /omk/something,
# not /omk.json
<Location "/omk.json">
    ProxyPass http://localhost:8043/omk.json retry=5
    ProxyPassReverse http://localhost:8043/omk.json
</Location>


<Location "/es/omk/opReports">
    ProxyPass http://localhost:8043/es/omk/opReports retry=5
    ProxyPassReverse http://localhost:8043/es/omk/opReports
		ErrorDocument 503 '<html><head><meta http-equiv="refresh" content="60"></head><body><h1>Temporary Service Interruption</h1>The requested OMK page should be back soon. This page will automatically reload in 60 seconds.</body></html>'
</Location>

<Location "/en/omk/opReports">
    ProxyPass http://localhost:8043/en/omk/opReports retry=5
    ProxyPassReverse http://localhost:8043/en/omk/opReports
		ErrorDocument 503 '<html><head><meta http-equiv="refresh" content="60"></head><body><h1>Temporary Service Interruption</h1>The requested OMK page should be back soon. This page will automatically reload in 60 seconds.</body></html>'
</Location>

<Location "/pt/omk/opReports">
    ProxyPass http://localhost:8043/pt/omk/opReports retry=5
    ProxyPassReverse http://localhost:8043/pt/omk/opReports
		ErrorDocument 503 '<html><head><meta http-equiv="refresh" content="60"></head><body><h1>Temporary Service Interruption</h1>The requested OMK page should be back soon. This page will automatically reload in 60 seconds.</body></html>'
</Location>


<Location "/es">
    ProxyPass http://localhost:8042/es retry=5
    ProxyPassReverse http://localhost:8042/es
		ErrorDocument 503 '<html><head><meta http-equiv="refresh" content="60"></head><body><h1>Temporary Service Interruption</h1>The requested OMK page should be back soon. This page will automatically reload in 60 seconds.</body></html>'
</Location>

<Location "/en">
    ProxyPass http://localhost:8042/en retry=5
    ProxyPassReverse http://localhost:8042/en
		ErrorDocument 503 '<html><head><meta http-equiv="refresh" content="60"></head><body><h1>Temporary Service Interruption</h1>The requested OMK page should be back soon. This page will automatically reload in 60 seconds.</body></html>'
</Location>

<Location "/pt">
    ProxyPass http://localhost:8042/pt retry=5
    ProxyPassReverse http://localhost:8042/pt
		ErrorDocument 503 '<html><head><meta http-equiv="refresh" content="60"></head><body><h1>Temporary Service Interruption</h1>The requested OMK page should be back soon. This page will automatically reload in 60 seconds.</body></html>'
</Location>

</IfModule>

EOF
#
# this is the end of the above copy and paste command - which starts with 'sudo cat > /etc/httpd/conf.d/03omk-standalone-proxy.conf <<EOF'

# restart Apache
sudo service httpd restart



How opReports-3.4.1-standalone.tar.gz was built

opReports-3.4.1-standalone.tar.gz was created as follows: