====== Installation Fix für node-red-contrib-knx-ultimate ======

{{:attention-98643_640.png?nolink&100|}}
**WICHTIG:** Diese Anleitung funktioniert nicht auf der Proxmox-Shell. Es wird eine SSH-Verbindung benötigt, um die Installation nach dieser Anleitung durchzuführen.


Da die derzeit vom Entwickler bereitgestellte Version von ''node-red-contrib-knx-ultimate'' nicht mit der aktuellsten Snap-Version von Node-RED kompatibel ist, bietet diese Anleitung eine Lösung, wie eine ältere, kompatible Version installiert werden kann. Die in der Anleitung angegebenen Pfade sind wichtig, damit sie erfolgreich ausgeführt werden kann.


<code bash node-red-contrib-knx-ultimate_installation_fix.sh>
# Die Anleitung muss aus dem Verzeichnis /var/snap/node-red/current/node_modules ausgeführt 
# werden, sonst schlägt sie fehl.
cd /var/snap/node-red/current/node_modules

# Falls bereits ein nicht erfolgreicher Installationsversuch über die Palettenverwaltung
# stattgefunden hat, bitte zuerst mit Hilfe des folgenden Befehls das fehlerhafte
# Unterverzeichnis aus dem oben gewählten Verzeichnis löschen.
rm -rf node-red-contrib-knx-ultimate

# Den node-red-Snap-Container anhalten
snap stop node-red

# Den node-red-Snap-Container zum Betreten mit einer Shell starten
snap run --shell node-red

# In der geöffneten Shell (sieht genauso aus, wie eine normale Shell; kann aber
# z. B. überprüft werden, wenn man das Kommando "ping" eingibt. Wenn man die Meldung
# "Permission denied" erhält, ist man in der node-red-Shell) den Installationsbefehl
# für eine ältere, funktionierende Version ausführen
npm install --no-audit --no-update-notifier --no-fund --save --save-prefix=~ --engine-strict --production node-red-contrib-knx-ultimate@1.4.8

# node-red-Shell verlassen
exit

# node-red-Snap wieder starten
snap restart node-red

# Ab jetzt sollte in der Werkzeugpalette ziemlich weit unten ein Abschnitt "KNX Ultimate" vorhanden sein.
</code>

===== Plan C =====

Falls der oben beschriebene Lösungsweg fehlgeschlagen ist **obwohl die Anleitung inklusive vorangestellter Erläuterung korrekt befolgt worden ist**, gibt es noch eine weitere Möglichkeit, die Installation vorzunehmen.

{{:attention-98643_640.png?nolink&100|}} Diese Vorgehensweise nur anwenden, wenn die obige Variante ohne Selbstverschulden fehlgeschlagen ist.

<code bash>
# System aktualisieren
apt update
apt -y upgrade

# Paketquellen für nodejs installieren
curl -fsSL https://deb.nodesource.com/setup_18.x | bash -

# nodejs installieren
apt -y install nodejs

# KNX-Node installieren
cd /var/snap/node-red/current/node_modules
npm install --no-audit --no-update-notifier --no-fund --save --save-prefix=~ --engine-strict --production node-red-contrib-knx-ultimate@1.4.8

# Node-RED neustarten
snap restart node-red
</code>