Follow this procedure only if you upgrade from Xorux Virtual Appliance v7.00-2 and older.
Virtual Appliance v7.01+ has all necessary already in place.

All installation steps do either under root user or use sudo


    Install Java runtime environment version >= 8 from repository or by direct download.
    It might be already in place, verify it.
    java -version
      openjdk version "1.8.0_101"
    Upgrade/install if does not:
    yum install java-1.8.0

XorMon Installation

    Adjust version number if necessary.
    rpm -Uvh ./xormon-1.0.0-1.noarch.rpm
    It will be installed into /opt/xorux/xormon dicretory
    /opt/xorux/xormon/config/ can be modified to change webapp defaults (e.g. server.port=8443, server.ssl.key-store=selfsigned).
    In case there is only /opt/xorux/xormon/config/ then copy it to /opt/xorux/xormon/config/
    When it runs then it creates its own database and application logs in home directory of the user: /home/lpar2rrd/xormon-data

Service (systemd)

    Service must be configured to start XorMon on system start.
    XorMon uses embedded Tomcat.

    Create systemd.service file: /etc/systemd/system/xormon.service
    vi /etc/systemd/system/xormon.service
    Description=XorMon webapp
    ExecStart=/usr/bin/java -Xms512M -Xmx1024M -server -XX:+UseG1GC -Dh2.bindAddress= -jar /opt/xorux/xormon/xormon.war
    Start service:
    systemctl daemon-reload
    systemctl enable xormon
    systemctl start xormon
    Check service status:
    systemctl status xormon

Optional: enable UI to run on port 443 instead of default 8443

    Configure proxy in Apache under root.
    vi /etc/httpd/conf.d/ssl.conf
    and put below code right behind this line: "<VirtualHost _default_:443>"
    RewriteEngine On
    RewriteCond %{HTTP:Upgrade} =websocket [NC]
    RewriteRule ^/xormon/ws(.*)    wss://$1 [P,L]
    ProxyPass /xormon/
    <location /xormon/>
    ProxyPassReverse /
    ProxyPreserveHost On
    SSLProxyEngine On
    # skip self-signed cert verification
    SSLProxyVerify none
    SSLProxyCheckPeerCN off
    SSLProxyCheckPeerName off
    SSLProxyCheckPeerExpire off
    Restart Apache
    systemctl restart httpd.service


    Upgrade to the latest LPAR2RRD and STOR2RRD, get them from download page. Use always the latest version.


    There must be installed SQlite 3.8+
    Check actual SQLite version
    sqlite3 -version
      3.26.0 2018-12-01 12:34:55 bf8c1b2b7a5960c282e543b9c293686dccff272512d08865f4600fb58238alt1
    Install/upgrade SQLite to 3.26 if actual version is less than 3.8
    CentOS 7 std repositories does not contain such new version
    Download and install these packages sqlite-3.26.0-3.el7.x86_64.rpm, sqlite-libs-3.26.0-3.el7.x86_64.rpm
    You can even download perl-DBD-SQLite-with_dependencies.x86_64.tgz
    yum install perl-DBD-SQLite
    yum install sqlite-3.26.0-3.el7.x86_64.rpm
    yum install sqlite-libs-3.26.0-3.el7.x86_64.rpm
    Make sure all is installed:
    cd /home/lpar2rrd/lpar2rrd

    Enable XorMon connection on LPAR2RRD/STOR2RRD

      Edit /home/lpar2rrd/lpar2rrd/etc/.magic and enable XorMon application connection.
      umask 022
      cd /home/lpar2rrd/lpar2rrd/    # or where is your LPAR2RRD home
      vi etc/.magic
      export XORMON=1
      Do same for STOR2RRD: /home/stor2rrd/stor2rrd/etc/.magic
      Note: it might take up to 1 hour since enabling XORMON=1 till XorMon front-end can succesfully connect to the back-end (backend creates all necessary databases within an hour)

    LPAR2RRD: restart the daemon

      Restart LPAR2RRD daemon to apply XorMon setting under lpar2rrd user account:
      cd /home/lpar2rrd/lpar2rrd
      ./ daemon_stop
      ./ daemon_start
Application access
XorMon is available at https://<server>:8443/, (if you have enabled Apache proxy then https://<server>/xormon/)
Note: do not miss the last "/" in the URL when using a proxy
XorMon actually supports access only over the HTTPS protocol.
The default login credentials are username:, password: xorux4you
XorMon login

LPARRRD/STOR2RRD back-end conenction
Navigate: UI ➡ Top-right ➡ Settings ➡ Other ➡ Backend and configure path to local STOR2RRD/LPAR2RRD installation or remote HTTPS server.

XorMon back-end

After save you will see if that connection is successfull or failed.
Check error message and correct problems.
If you have no clue then contact us via