Fehlerhafte und inkonsistente Installdoku für docker mit openhab - SOLVED

[galexey]

Die Doku auf dockerhub (https://hub.docker.com/r/cometvisu/cometvisu) und auf cometvisu (https://www.cometvisu.org/CometVisu/...r_openhab.html) sind inkonsistent und fehlerhaft.

docker-compose.yaml

auf cometvisu ist der Environment-Parameter fälschlich

CGI_URL_PATH: "/rest/cv/"

definiert.
korrekt ist

CGI_URL_PATH: "/rest/"

.
auf dockerhub sind folgende Parameter offenbar für openhab irrelevant und/oder falsch:

• BACKEND_OPENHAB
• BACKEND_NAME
• CGI_URL_PATH
• BACKEND_PROXY_SOURCE

die korrekte docker-compose.yaml sieht so aus:

version: '3.4'
services:
    cometvisu:
        image: "cometvisu/cometvisu:latest"
        restart: always
        ports:
        - 80:80
        volumes:
            - ./resource/config:/var/www/html/resource/config
        environment:
            CGI_URL_PATH: "/rest/"
            BACKEND_PROXY_SOURCE: "/rest"
            BACKEND_PROXY_TARGET: "http://<IP-Openhab>:8080/rest"​

Beispiel visu_config file: um z.b. auf die items test_text vom Typ String und test_switch vom Typ Switch zuzugreifen:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<pages xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" lib_version="9" design="metal" xsi:noNamespaceSchemaLocation="../visu_config.xsd" scroll_speed="0" bind_click_to_widget="true">
  <page name="Testraum">
    <info>
      <label>test-string</label>
      <address transform="OH:String" mode="read">test_text</address>
    </info>
  
    <switch mapping="OnOff" styling="GreyGreen">
      <label>test-switch</label>
      <address transform="OH:switch">test_switch</address>
    </switch>
  </page>
</pages>

​
​

[peuter]

Das ist so alles nicht ganz korrekt, auch wenn es technisch funktioniert:

1. CGI_URL_PATH ist veraltet und sollte nicht mehr benutzt werden, das ist da nur noch drin um kompatibel mit existierenden Installationen zu sein. Stattdessen sollte BACKEND_KNXD oder BACKEND_OPENHAB verwendet werden, je nachdem welches backend man nutzen möchte.
2. BACKEND_NAME = "default" oder nicht angegeben schaltet den im Container vorhandenen KNXD an, BACKEND_NAME = "openhab" schaltet den aus. Merkt man zwar nicht ob der läuft oder nicht, aber die Einstellung ist nicht irrelevant
3. BACKEND_PROXY_SOURCE ist zwingend notwendig damit man openHAB als backend nutzen kann. Da Du das selbst in deinem funktionierendem Beispiel benutzt, gehe ich mal davon aus, dass das fälschlicherweise in der Liste der irrelevanten/falschen Einstellungen gelandet ist.

Der Pfad "/rest/cv/" ist tatsächlich mittlerweile veraltet, das müssen wir in der Doku anpassen.