Using the docker appliance¶

Installing Docker¶

Install docker using the following documentation https://docs.docker.com/engine/installation/

Initial installation¶

Create a ‘store’ container :

$ make docker-local-store

Create a ‘running’ container :

$ make docker-local-running

Yous should now have 2 created containers :

$ docker ps -a

CONTAINER ID        IMAGE                          COMMAND             CREATED             STATUS      PORTS       NAMES
2f2496fbd885        bibi21000/janitoo_tellstick    "/root/auto.sh"     9 seconds ago       Created                                    tellstick_running
1b6e0270e728        bibi21000/janitoo_tellstick    "/bin/true"         20 seconds ago      Created                                    tellstick_store

Start the container¶

Start it :

$ docker start tellstick_running

Check that is running :

$ docker ps

CONTAINER ID        IMAGE                          COMMAND             CREATED              STATUS          PORTS                  NAMES
cc1a58b59f7c        bibi21000/janitoo_tellstick   "/root/auto.sh"     About a minute ago   Up 8 seconds    0.0.0.0:8885->22/tcp   tellstick_running

And stop it :

$ docker stop tellstick_running

Customize your installation¶

You can find basis customizations tips here : https://bibi21000.github.io/janitoo_docker_appliance/customize.html.

This configuration is saved in the ‘store’ container.

Configuration¶

Update the nut configuration file :

$ ssh root@127.0.0.1 -p 8885

Default password is janitoo. You can change it but it will be restored on the next running container update. Prefer the key solutions.

Open the configuration file. The docker image contains a nano or vim for editing files :

root@8eafc45f6d09:~# vim /opt/janitoo/etc/janitoo_tellstick.conf

You must at least update the broker ip. It should match the ip address of your shared “mosquitto” :

broker_ip = 192.168.1.14

If you plan to install more than one janitoo_tellstick image on your network, you must change the hadd of the bus and components :

hadd = 0120/0000

to

hadd = 0127/0000

And so on for 0120/0001, 0120/0002, ... Keep in mind that hadd must be unique on your network.

Save your updates and restart jnt_tellstick :

root@8eafc45f6d09:~# killall jnt_tellstick

Ups¶

Update the ip, upsname, username ans password matching your nut server installation :

[tellstick__3]

Save and restart your server to apply.

Performances¶

The top result in the running appliance :

root@7de7e4993b13:~# top

top - 19:15:46 up 10 days, 53 min,  1 user,  load average: 1.19, 0.85, 0.68
Tasks:   8 total,   1 running,   7 sleeping,   0 stopped,   0 zombie
%Cpu(s):  6.8 us,  1.5 sy,  0.1 ni, 91.4 id,  0.2 wa,  0.0 hi,  0.0 si,  0.0 st
KiB Mem:  11661364 total, 11337104 used,   324260 free,   587492 buffers
KiB Swap: 19530748 total,   301772 used, 19228976 free.  4396544 cached Mem

  PID USER      PR  NI    VIRT    RES    SHR S  %CPU %MEM     TIME+ COMMAND
   13 root      20   0  480680  22516   4384 S   2.0  0.2   0:39.28 /usr/local/bin/python /usr/local/bin/jnt_tellstick -c /etc/janitoo/janitoo_tellstick.conf front
    1 root      20   0   21740   1604   1328 S   0.0  0.0   0:00.03 /bin/bash /root/auto.sh
   10 root      20   0   55508  10064   1336 S   0.0  0.1   0:00.05 /usr/bin/python /usr/bin/supervisord -c /etc/supervisor/supervisord.conf
   11 root      39  19   23500   1492   1200 S   0.0  0.0   0:00.09 top -b
   12 root      20   0   55176   3120   2444 S   0.0  0.0   0:00.02 /usr/sbin/sshd -D
   44 root      20   0   82716   3932   3076 S   0.0  0.0   0:00.06 sshd: root@pts/0
   46 root      20   0   20244   1904   1488 S   0.0  0.0   0:00.02 -bash
   50 root      20   0   21940   1424   1048 R   0.0  0.0   0:00.04 top

Administer your containers¶

You can find basis administration tips here : https://bibi21000.github.io/janitoo_docker_appliance/administer.html.