Installation

XorMon in a Docker

XorMon application it is not available in XoruX Docker distro during beta testing

You can run XorMon easily with Docker.
No missing modules, library version conflicts or dependency hell.
It's based on the latest official Alpine Linux with all necessary dependencies installed.

Quick start:

docker run -d --name XoruX --restart always -p 8080:80 xorux/apps

or better

export XORUX_DIR=/srv/xorux   # select any directory with rwx owner permissions
mkdir -p $XORUX_DIR/lpar2rrd $XORUX_DIR/stor2rrd
chown 1005 $XORUX_DIR/lpar2rrd $XORUX_DIR/stor2rrd   # uid of user lpar2rrd inside the container 
docker run -d --name XoruX --restart always -v $XORUX_DIR/lpar2rrd:/home/lpar2rrd/lpar2rrd -v $XORUX_DIR/stor2rrd:/home/stor2rrd/stor2rrd -p 8080:80 xorux/apps

If you run container with volume params, it will use XORUX_DIR to store all data and configurations for easy backups, log access and further upgrades.

You can set container timezone via env variable TIMEZONE in docker run command:

docker run -d --name XoruX --restart always -v $XORUX_DIR/lpar2rrd:/home/lpar2rrd/lpar2rrd -v $XORUX_DIR/stor2rrd:/home/stor2rrd/stor2rrd -p 8080:80 -e TIMEZONE="Europe/Prague" xorux/apps>

or later in web UI.

On first run:

  • visit web GUI on port 80 (mapped to host port 8080 in example)
  • continue to LPAR2RRD and use admin/admin as username/password
  • or continue to STOR2RRD and use admin/admin as username/password

You can connect via SSH on port 22 (exposed), username lpar2rrd, password xorux4you - please change it ASAP.

Docker Hub
Dockerfile
Docker source code


Troubleshooting

  • How to find IP of deployed Docker instance:
    Apache and everything needed is already included in Docker container, it should work out-of-the-box.
    Just try if your instance is running:
    > docker ps
    CONTAINER ID IMAGE      COMMAND     CREATED     STATUS       PORTS                                      NAMES
    d96c9e5edcdb xorux/apps /startup.sh 7 weeks ago Up 8 minutes 22/tcp,443/tcp,8162/tcp,0.0.0.0:80->80/tcp berserk_payne
    
    Then you can find IP address of running container
    You will get other random name of the instance, do not use berserk:payne:
    > docker inspect berserk_payne | grep Address
        "LinkLocalIPv6Address": "",
        "SecondaryIPAddresses": null,
        "SecondaryIPv6Addresses": null,
        "GlobalIPv6Address": "",
        "IPAddress": "172.17.0.2",
        "MacAddress": "02:42:ac:11:00:02",
         "IPAddress": "172.17.0.2",
         "GlobalIPv6Address": "",
         "MacAddress": "02:42:ac:11:00:02"
    
    and finally you can get product UI on this address: http://172.17.0.2

  • In case of a problem check our forum or contact us via support@lpar2rrd.com