Konfiguration: Unterschied zwischen den Versionen

Aus FHEMWiki
(→‎Konfiguration in einer SQL Datenbank: Migration einer bestehenden fhem-Installation auf configDB beschrieben. DB-Erstellung mit PostgreSQL fehlt noch mangels Erfahrung.)
K (Wiki-Link auf Befehl "save")
 
(61 dazwischenliegende Versionen von 10 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Die '''Konfiguration''' eines Fhem [[Systemübersicht|Systems]] wird im Normalfall definiert durch Eintragungen in der Konfigurationsdatei <code>fhem.cfg</code>, die standardmäßig im Fhem-Installationsverzeichnis abgelegt ist.
Die '''Konfiguration''' eines FHEM [[Systemübersicht|Systems]] wird über eine zentrale Datei, die <code>fhem.cfg</code><ref>Diese Begrifflichkeit wird im FHEM-Kontext auch verwendet, wenn die Konfiguration über mehrere Dateien verteilt oder in einer Datenbank gespeichert sein sollte</ref>, festgelegt<ref>Sofern nicht anderweitig erwähnt, beziehen sich alle weiteren Aussagen und Bildschirmfotos auf das [[FHEMWEB|Standard Webinterface]] im Stil "f18"</ref>.  
 
Sofern nicht anderweitig erwähnt, beziehen sich alle weiteren Aussagen und Bildschirmfotos auf das [[PGM2|Standard Webinterface]] im Stil "dark".


== Grundstruktur ==
== Grundstruktur ==
In einer Standardinstallation sind alle Definitionen in der Datei <code>fhem.cfg</code> abgelegt; diese Datei befindet sich im Installationsverzeichnis (z.&nbsp;B. <code>/opt/fhem</code>). Soll alternativ eine andere (Start-)Konfigurationsdatei verwendet werden, so ist deren Name beim Start von Fhem mitzugeben.
Beim Systemstart wird die zuletzt gespeicherte Konfiguration gelesen. Diese befindet sich standardmäßig in der Datei <code>fhem.cfg</code><ref>Diese Datei befindet sich im Installationsverzeichnis (z.&nbsp;B. <code>/opt/fhem</code>)</ref>, die Konfiguration kann stattdessen auch in einer [[Konfiguration#Konfiguration in einer SQL Datenbank|Datenbank]] hinterlegt werden.
Soll eine andere (Start-)Konfiguration verwendet werden, als im jeweiligen automatischen Startaufruf<ref>Betriebssystemspezifisch; bei neueren Linux-Versionen über systemd</ref> hinterlegt, so ist deren Name beim Start von FHEM mitzugeben.


== Autocreate ==
== Autocreate ==
Sofern die "Autocreate" Funktion aktiv ist (<code>define autocreate autocreate</code>), werden unter bestimmten Umständen Objekte automatisch angelegt. Diese Definitionen werden immer in der Start-Konfigurationsdatei abgelegt und abgespeichert. Nach der Erstinstallation von Fhem ist die "Autocreate" Funktion standardmäßig aktiv.
Sofern die "autocreate" Funktion aktiv ist (<code>define autocreate autocreate</code>), werden unter bestimmten Umständen Objekte automatisch angelegt. Diese Definitionen werden immer in der Start-Konfigurationsdatei abgelegt und abgespeichert. Nach der Erstinstallation von FHEM ist die [[Quick-Start#autocreate|autocreate]] Funktion standardmäßig aktiv.


== Bearbeitung der Konfiguration ==
== Bearbeitung der Konfiguration ==
[[Bild:saveConfig.png|mini|120px|links|"Knopf" zum Speichern der Konfigurationsänderungen]]
[[Bild:saveConfig.png|mini|130px|links|"Knopf" zum Speichern der Konfigurationsänderungen]]
[[Bild:saveConfigChangeList.png|mini|220px|rechts|Beispiel einer Liste der ungesicherten Anderungen der Konfiguration]]
[[Bild:saveConfigChangeList.png|mini|220px|rechts|Beispiel einer Liste der ungesicherten Änderungen der Konfiguration]]
Die Fhem-Konfiguration kann auf verschiedene Arten bearbeitet werden. Für Einsteiger empfiehlt sich grundsätzlich die Verwendung des "Befehl-Eingabefeld" und der "Objektdetails" mit eingeschalteter Syntaxhervorhebung. Die Methoden "Integrierter Editor" und insbesondere "Externer Editor" sollten als "Expertenmodus" angesehen und nur in begründeten (Ausnahme-)Fällen angewendet werden. Insbesondere beim Mischen der Arten können unerwünschte und/oder unerwartete Effekte auftreten, so beispielsweise, wenn ein benötigtes "Save config" nicht erfolgt ist, bevor ein "rereadcfg" oder Neustart von Fhem durchgeführt wird.  
Die FHEM-Konfiguration kann auf verschiedene Arten bearbeitet werden. Nicht nur für Einsteiger empfiehlt sich grundsätzlich die Verwendung des "Befehl-Eingabefeld" und der "Objektdetails" mit eingeschalteter Syntaxhervorhebung. Die Methoden "Integrierter Editor" und insbesondere "Externer Editor" sollten als "Expertenmodus" angesehen und nur in begründeten (Ausnahme-)Fällen angewendet werden; viele Automatiken und Fehlerkontrollen/-hinweise von FHEM stehen bei diesen Methoden nicht zur Verfügung. Insbesondere beim Mischen der Arten können unerwünschte und/oder unerwartete Effekte auftreten, so beispielsweise, wenn ein benötigtes "Save config" nicht erfolgt ist, bevor ein "rereadcfg" oder Neustart von FHEM durchgeführt wird.  


Seit Mitte Januar 2015 ist es, wie im Bild rechts gezeigt, möglich, sich eine Teilliste der ungesicherten Konfigurationsänderungen durch anklicken des roten {{Taste|?}} anzeigen zu lassen.
Ungesicherte Konfigurationsänderungen signalisiert FHEM durch ein rotes Fragezeichen neben dem Link "Save config". Durch Anklicken des roten {{Taste|?}} wird eine Teilliste der ungesicherten Konfigurationsänderungen, wie im Bild rechts dargestellt, angezeigt.


=== Befehl-Eingabefeld ===
=== Befehl-Eingabefeld ===
[[Bild:ConfCommandField.png|thumb|300px|Right|Befehl-Eingabefeld]]
[[Bild:ConfCommandField.png|thumb|300px|Right|Befehl-Eingabefeld]]
Eingaben in das Befehl-Eingabefeld (teilweise auch bezeichnet als "Kommando-Eingabefeld" oder kurz "Eingabefeld"), das sich oben auf jeder Seite des Standardinterfaces befindet, stellen einen schnellen und einfachen Weg dar, um z.&nbsp;B. neue Objekte zu definieren (im dargestellten Beispiel die Zuweisung eines (ggf. neuen) Raumes zu einem Objekt). Nach Bestätigung mit der <Enter>-Taste werden die Änderungen unmittelbar wirksam.
Eingaben in das Befehl-Eingabefeld (teilweise auch bezeichnet als "Kommando-Eingabefeld" oder kurz "Eingabefeld"), das sich oben auf jeder Seite des Standardinterfaces befindet, stellen einen schnellen und einfachen Weg dar, um z.&nbsp;B. neue Objekte zu definieren (im dargestellten Beispiel die Anlage eines dummy-Devices). Nach Bestätigung mit der <Enter>-Taste werden die Änderungen unmittelbar wirksam.


Die Änderung müssen manuell in der Konfigurationsdatei abspeichert werden, ansonsten gehen die Änderungen beim Neustart verloren: "Save config" (aus dem Menü in der linken Spalte) anklicken oder den Befehl "save" im Befehl-Eingabefeld eingeben.
Die Änderung müssen manuell in der Konfigurationsdatei abspeichert werden, ansonsten gehen die Änderungen beim Neustart verloren: "Save config" (aus dem Menü in der linken Spalte) anklicken oder den Befehl [[save]] im Befehl-Eingabefeld eingeben.


=== Objektdetails ===
=== Objektdetails ===
Durch Anklicken des Namensfeldes eines Objekts werden die Objektdetails aufgerufen. Je nach Objekttyp stehen auf dieser Seite verschiedene Optionen zur Manipulation von Objekteigenschaften zur Verfügung:
Durch Anklicken des Namensfeldes eines Objekts werden die Objektdetails aufgerufen. Je nach Objekttyp stehen auf dieser Seite verschiedene Optionen zur Manipulation von Objekteigenschaften zur Verfügung:
* [[Bild:ConfModifyDEF.png|300px|right]] <code>DEF</code> zur Anpassung der Definition  
* [[Bild:ConfModifyDEF.png|thumb|300px|right|DEF-Editor]] [[DEF-Editor]] zur Anpassung der Definition  
* [[Bild:ConfAttrDropdown.png|300px|right]] Attribute / Attributwerte aus Auswahllisten (nach Auswahl der Werte ist der <code>attr</code> Knopf anzuklicken)  
* [[Bild:ConfAttrDropdown.png|thumb|300px|right|Attribut-Auswahlliste]] Attribute / Attributwerte aus Auswahllisten (nach Auswahl der Werte ist der <code>attr</code> Knopf anzuklicken)  
* je nach Objekttyp stehen weitere / andere Aktionen zur  
* je nach Objekttyp stehen weitere / andere Aktionen zur Verfügung
Nach einem Klick auf "Modify" werden die Änderungen an der Defintion unmittelbar wirksam.
Nach einem Klick auf "Modify" werden die Änderungen an der Definition unmittelbar wirksam.
 
Die Änderung müssen manuell in der Konfigurationsdatei abspeichert werden, ansonsten gehen die Änderungen beim Neustart verloren: "Save config" (aus dem Menü in der linken Spalte) anklicken oder den Befehl "save" im Befehl-Eingabefeld eingeben.
 
=== RAW-Import ===
[[Datei:GotoRAW-Import firststeps.PNG|thumb|right|300px|"+" zum Öffnen des mehrzeiligen Befehl-Eingabefeld / RAW-Import]]Der [[Import von Code Snippets|RAW-Import]] ist eine einfache Möglichkeit, mehrere Befehle oder ganze Gerätedefinitionen samt [[Attribut|Attributen]] "en Block" in die Konfiguration zu übernehmen.
 
Im Style ''f18'' ist ein entsprechendes Dialogfeld direkt über das "+" neben dem Befehl-Eingabefeld zu erreichen, ansonsten am Ende jeder Geräte-Detailansicht über den Link ''Raw definition''.
 
Nach einem Klick auf "Execute" werden die Änderungen unmittelbar wirksam.


Die Änderung müssen manuell in der Konfigurationsdatei abspeichert werden, ansonsten gehen die Änderungen beim Neustart verloren: "Save config" (aus dem Menü in der linken Spalte) anklicken oder den Befehl "save" im Befehl-Eingabefeld eingeben.
Die Änderung müssen manuell in der Konfigurationsdatei abspeichert werden, ansonsten gehen die Änderungen beim Neustart verloren: "Save config" (aus dem Menü in der linken Spalte) anklicken oder den Befehl "save" im Befehl-Eingabefeld eingeben.
Zeile 35: Zeile 43:
[[Bild:ConfEditSyntaxHighlight.png|mini|300px|rechts|Editfenster (Ausschnitt) mit Syntaxhervorhebung]]
[[Bild:ConfEditSyntaxHighlight.png|mini|300px|rechts|Editfenster (Ausschnitt) mit Syntaxhervorhebung]]
Sollte ein direktes Editieren der Konfigurationsdatei als nötig erachtet werden, wird der Editor über den entsprechenden Menüeintrag in der linken Spalte erreicht. Auf die Einhaltung der Syntax von Befehlen und Definitionen ist zu achten, teilweise sind besondere Maßnahmen zu ergreifen ("Escapen" von Sonderzeichen, verdoppeln von Semikolon). Mit dem Abspeichern der editierten Datei werden die Änderungen unmittelbar aktiv, korrekte Syntax und Semantik vorausgesetzt.
Sollte ein direktes Editieren der Konfigurationsdatei als nötig erachtet werden, wird der Editor über den entsprechenden Menüeintrag in der linken Spalte erreicht. Auf die Einhaltung der Syntax von Befehlen und Definitionen ist zu achten, teilweise sind besondere Maßnahmen zu ergreifen ("Escapen" von Sonderzeichen, verdoppeln von Semikolon). Mit dem Abspeichern der editierten Datei werden die Änderungen unmittelbar aktiv, korrekte Syntax und Semantik vorausgesetzt.
Seit Februar 2015 ist die Bearbeitung der Konfiguration über den Integrierten Editor als nicht empfohlene Variante standardmäßig gesperrt. Rudolf König dazu: ''"Durch das direkte Editieren der Datei kann FHEM die Fehler der Benutzer nicht so gut abfangen (kein dropdown, wizard, etc), bzw. die Fehlermeldungen sind etwas aufwendiger  zu interpretieren, d.h. man muss sie lesen und verstehen. Dass sowas nicht selbstverstaendlich ist, beweist gerade diese Diskussion, und solche Probleme muessen wir (die Supporter) hier im Forum ausbaden. Deswegen sollten die Anfaenger nicht dazu ermuntert werden, die Konfiguration in FHEMWEB direkt zu editieren. Verboten ist es keinesfalls, es wird seit gestern nur eine kleine Huerde (Hinweis + Eintrittspruefung) hingelegt."'' {{Link2Forum|Topic=33839|Message=262029}}


=== Syntaxhervorhebung ===
=== Syntaxhervorhebung ===
[[Bild:ConfEditDEFAutocomplete.png|mini|300px|rechts|Automatische Vervollständigung / Befehlsauswahlfenster ("se" getippt, dann Strg+Leertaste gedrückt)]]
FHEM bietet für die oben genannten Varianten der Konfigurationsbearbeitung über FHEMWEB -mit Ausnahme des Befehl-Eingabefeldes- Syntaxhervorhebungs-, Befehlsauswahl- und Befehlsvervollständigungsfunktionen.
Seit Anfang April 2014 ist der in Fhem integrierte Editor um Syntaxhervorhebungs-, Befehlsauswahl- und Befehlsvervollständigungsfunktionen erweitert.
 
Um die Funktionalität zu aktivieren müssen die folgenden zwei Attribute gesetzt werden:
:<code>attr WEB JavaScripts codemirror/fhem_codemirror.js</code>
:<code>attr WEB codemirrorParam { "theme":"blackboard", "lineNumbers":true }</code>
 
Die Syntaxhervorhebung / Befehlsvervollständigung, sofern aktiviert, ist wirksam für
* Bearbeitung der [[Konfiguration#Objektdetails|Objektdetails]]
* [[Konfiguration#Integrierter Editor|Integrierter Editor]]


Darüber hinaus wird (wie im Bildauschnitt dargestellt) über Strg+Leertaste eine Befehlsauswahl bzw. automatische Befehlsvervollständigung angeboten.
Um die Funktionalität zu aktivieren, muss folgendes Attribut bei der entsprechenden FHEMWEB-Instanz gesetzt werden:
:<code>attr <FHEMWEB-Devicename> JavaScripts codemirror/fhem_codemirror.js</code>


Der Forums-Thread unter der Überschrift [http://forum.fhem.de/index.php/topic,20444.0.html Javascript Editor einbinden] enthält die Diskussion zum Entwicklungsprozess.
Details zu der Funktionalität und zu Anpassungsmöglichkeiten enthält der Artikel zu [[codemirror]].


=== Externer Editor ===
=== Externer Editor ===
Unter bestimmten Umständen kann auch das Editieren der Konfiguration mit einem externen Editor wie z.&nbsp;B.
Das Editieren der Konfiguration kann auch mit einem externen Editor wie z.&nbsp;B.
* Notepad++ (mit der nppFTP-Erweiterung)
* Notepad++ (beispielweise mit der nppFTP-Erweiterung)
* nano in einer Telnet Sitzung
* nano in einer Telnet Sitzung
* in wfftp integrierter / integrierbarer Editor
* in wfftp integrierter / integrierbarer Editor
* ...
erfolgen (duplizieren von Definitionen (auch möglich mit {{Link2CmdRef|Anker=copy|Label=copy}}), globale Änderungen (auch möglich mit {{Link2CmdRef|Anker=rename|Label=rename}}, {{Link2CmdRef|Anker=attr|Label=attr}}, usw in Verbindung mit {{Link2CmdRef|Anker=devspec|Label=devspec}}...), umsortieren von Definitionen (fehleranfällig und übernimmt FHEM bei Bearbeitung über FHEMWEB automatisch), etc.). In diesem Fall sollte der Benutzer sich mit der Bedienung des Editors in der gewählten Umgebung und FHEM hinreichend gut auskennen.
sinnvoll sein (duplizieren von Definitionen, globale Änderungen, umsortieren von Definitionen, etc.). In diesem Fall sollte der Benutzer sich mit der Bedienung des Editors in der gewählten Umgebung hinreichend gut auskennen.


Auf die Einhaltung der Syntax von Befehlen und Definitionen ist zu achten, teilweise sind besondere Maßnahmen zu ergreifen ("Escapen" von Sonderzeichen, verdoppeln von Semikolon). Nach dem Abspeichern der editierten Datei werden die Änderungen erst nach erneutem Einlesen der Konfiguration aktiv, korrekte Syntax und Semantik vorausgesetzt.
Auf die Einhaltung der Syntax von Befehlen und Definitionen ist zu achten, teilweise sind besondere Maßnahmen zu ergreifen ("Escapen" von Sonderzeichen, verdoppeln von Semikolon). Nach dem Abspeichern der editierten Datei werden die Änderungen erst nach erneutem Einlesen der Konfiguration aktiv, korrekte Syntax und Semantik vorausgesetzt.


Notwendige Aktionen nach Durchführung der Änderung: "rereadcfg" oder Neustart von Fhem.
Notwendige Aktionen nach Durchführung der Änderung: "rereadcfg" oder Neustart von FHEM.


== Auslagerung von Definitionen ==
'''Syntax-Highlighting''' kann bei verschiedenen externen Editoren verwendet werden, näheres s. [[Syntax Highlighting bei externen Editoren]].
Die Methode der Auslagerung von Definitionen gehört zum "Expertenmodus". Sie sollte nur bei detaillierter Kenntnis der Auswirkungen gewählt werden. Selbst einige Entwickler von Fhem wenden diese Methode nicht an. Sofern Definitionen aus der fhem.cfg ausgelagert werden sollen bzw. wurden, können die Dateien mit den ausgelagerten Anweisungen mithilfe von <code>include</code> eingebunden werden.
:<code>include Zimmer1.cfg</code> (Datei muss in <code>/opt/fhem/FHEM</code> liegen)
:<code>include /opt/fhem/eigene/Zimmer1.cfg</code> (Datei muss im angegebenen Verzeichnis liegen)


Sämtliche <code>attr global</code> Definitionen '''müssen''' in der fhem.cfg bleiben.  
== Aufteilung der fhem.cfg in mehrere Konfigurationsdateien ==
 
Die fhem.cfg kann bei Bedarf mit Hilfe des Befehls [[include]] in mehrere Konfigurationsdateien aufgeteilt werden. Dies ist als '''"Expertenmodus"''' zu betrachten und sollte (wenn überhaupt) nur von erfahrenen Benutzern angewendet werden.
Nur Konfigurationsdateien, die im Verzeichnis <installationsverzeichnis>/FHEM liegen, werden unter "Edit files" zur Bearbeitung mit dem integrierten Editor aufgeführt.


== Konfiguration in einer SQL Datenbank ==
== Konfiguration in einer SQL Datenbank ==
Seit April 2014 (Fhem-Version 5079) können Definitionen alternativ zur Speicherung in einer einfachen Text-Konfigurationsdatei(en) in einer SQL Datenbank abgelegt werden. Hierzu dienen configDB (Hilfsmodul) und configdb (command), die in der [http://fhem.de/commandref.html#configDB commandref] dokumentiert sind.
Seit April 2014 (FHEM-Version 5079) können Definitionen alternativ zur Speicherung in einer einfachen Text-Konfigurationsdatei(en) in einer SQL Datenbank abgelegt werden. Hierzu dienen configDB (Modul) und [[configdb]] (Befehl), die in der {{Link2CmdRef|Anker=configDB}} dokumentiert sind.
 
=== Voraussetzung ===
==== Datenbank ====
Unterstützt werden:
* [http://www.sqlite.org/ Sqlite]
* [http://www.mysql.de/ MySQL]
* [http://www.postgresql.org/ PostgreSQL]
 
==== Perl-Module ====
* Text::Diff (libtext-diff-perl)
* DBI (libdbi-perl)
* Je nach Datenbank:
** DBD::SQLite (libdbd-sqlite3-perl)
** DBD::mysql (libdbd-mysql-perl)
** DBD::Pg (libdbd-pg-perl)
 
==== configDB.conf ====
In einer Datei namens '''configDB.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese muß im fhem Hauptverzeichnis liegen (z.B. /opt/fhem).
* Sqlite<br />
<pre>%dbconfig= (
        connection => "SQLite:dbname=/opt/fhem/configDB.db",
        user => "",
        password => ""
);</pre>
* MySQL<br />
<pre>%dbconfig= (
      connection => "mysql:database=configDB;host=localhost;port=3306",
      user => "fhemuser",
      password => "fhempassword",
);</pre>
* PostgreSQL:<br />
<pre>%dbconfig= (
        connection => "Pg:database=configDB;host=localhost",
        user => "fhemuser",
        password => "fhempassword"
);</pre>
 
==== Datenbankerstellung ====
Es muß zuerst eine leere Datenbank erstellt werden. Die Tabellen werden automatisch erstellt.
* Sqlite<br />
<pre>pi@raspberrypi ~ $ sqlite3 configDB.db
 
SQLite version 3.7.13 2012-07-17 17:46:21
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
sqlite> pragma auto_vacuum=2;
sqlite> .quit</pre>
* MySQL<br />
<pre>pi@raspberrypi ~ $ mysql -u root -p
Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 2937
Server version: 5.5.41-0+wheezy1 (Debian)
 
Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved.
 
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
 
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
 
mysql> CREATE DATABASE `configDB` DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;
Query OK, 1 row affected (0.04 sec)
 
mysql> GRANT CREATE, SELECT, INSERT, DELETE, UPDATE ON `mahowi`.* TO 'fhemuser'@'%';
Query OK, 0 rows affected (0.04 sec)
 
mysql>  \q
Bye</pre>
* PostgreSQL<br />'''''TBD'''''
 
==== Migration der Konfiguration auf configDB ====
* Im laufenden fhem <code>configdb migrate</code> eingeben. Das kann eine Weile dauern. Wenn die Migration beendet ist, werden die Datenbank-Statistiken angezeigt. Die Original fhem.cfg wird nicht verändert.
* fhem herunterfahren (<code>shutdown</code>)
* fhem neu starten mit <code>perl fhem.pl configDB</code>.
* Eventuell in ''/etc/init.d/fhem'' die Zeile <code>perl fhem.pl fhem.cfg</code> auskommentieren und das ''#'' vor der Zeile <code>perl fhem.pl configDB</code> löschen.
 
Das war's. Ab jetzt wird die gesamte Konfiguration in einer Datenbank gespeichert.


Weitere Informationen hierzu im FHEM Forum:
* {{Link2Forum|Topic=54055|LinkText=Workshop zum Umstieg}}
* {{Link2Forum|Topic=20194|LinkText=Tester gesucht}}
* {{Link2Forum|Topic=20117|LinkText=Vorüberlegungen}}


Weitere Details zu dieser "Alternative":
== Anmerkungen ==
* Fhem Forum - [http://forum.fhem.de/index.php/topic,20194.0.html Tester gesucht]
<references />
* Fhem Forum - [http://forum.fhem.de/index.php/topic,20117.0.html Vorüberlegungen]


[[Kategorie:FHEM]]
[[Kategorie:FHEM-Verwendung]]
[[Kategorie:Glossary]]

Aktuelle Version vom 3. Juli 2020, 18:05 Uhr

Die Konfiguration eines FHEM Systems wird über eine zentrale Datei, die fhem.cfg[1], festgelegt[2].

Grundstruktur

Beim Systemstart wird die zuletzt gespeicherte Konfiguration gelesen. Diese befindet sich standardmäßig in der Datei fhem.cfg[3], die Konfiguration kann stattdessen auch in einer Datenbank hinterlegt werden. Soll eine andere (Start-)Konfiguration verwendet werden, als im jeweiligen automatischen Startaufruf[4] hinterlegt, so ist deren Name beim Start von FHEM mitzugeben.

Autocreate

Sofern die "autocreate" Funktion aktiv ist (define autocreate autocreate), werden unter bestimmten Umständen Objekte automatisch angelegt. Diese Definitionen werden immer in der Start-Konfigurationsdatei abgelegt und abgespeichert. Nach der Erstinstallation von FHEM ist die autocreate Funktion standardmäßig aktiv.

Bearbeitung der Konfiguration

"Knopf" zum Speichern der Konfigurationsänderungen
Beispiel einer Liste der ungesicherten Änderungen der Konfiguration

Die FHEM-Konfiguration kann auf verschiedene Arten bearbeitet werden. Nicht nur für Einsteiger empfiehlt sich grundsätzlich die Verwendung des "Befehl-Eingabefeld" und der "Objektdetails" mit eingeschalteter Syntaxhervorhebung. Die Methoden "Integrierter Editor" und insbesondere "Externer Editor" sollten als "Expertenmodus" angesehen und nur in begründeten (Ausnahme-)Fällen angewendet werden; viele Automatiken und Fehlerkontrollen/-hinweise von FHEM stehen bei diesen Methoden nicht zur Verfügung. Insbesondere beim Mischen der Arten können unerwünschte und/oder unerwartete Effekte auftreten, so beispielsweise, wenn ein benötigtes "Save config" nicht erfolgt ist, bevor ein "rereadcfg" oder Neustart von FHEM durchgeführt wird.

Ungesicherte Konfigurationsänderungen signalisiert FHEM durch ein rotes Fragezeichen neben dem Link "Save config". Durch Anklicken des roten ? wird eine Teilliste der ungesicherten Konfigurationsänderungen, wie im Bild rechts dargestellt, angezeigt.

Befehl-Eingabefeld

Befehl-Eingabefeld

Eingaben in das Befehl-Eingabefeld (teilweise auch bezeichnet als "Kommando-Eingabefeld" oder kurz "Eingabefeld"), das sich oben auf jeder Seite des Standardinterfaces befindet, stellen einen schnellen und einfachen Weg dar, um z. B. neue Objekte zu definieren (im dargestellten Beispiel die Anlage eines dummy-Devices). Nach Bestätigung mit der <Enter>-Taste werden die Änderungen unmittelbar wirksam.

Die Änderung müssen manuell in der Konfigurationsdatei abspeichert werden, ansonsten gehen die Änderungen beim Neustart verloren: "Save config" (aus dem Menü in der linken Spalte) anklicken oder den Befehl save im Befehl-Eingabefeld eingeben.

Objektdetails

Durch Anklicken des Namensfeldes eines Objekts werden die Objektdetails aufgerufen. Je nach Objekttyp stehen auf dieser Seite verschiedene Optionen zur Manipulation von Objekteigenschaften zur Verfügung:

  • DEF-Editor
    DEF-Editor zur Anpassung der Definition
  • Attribut-Auswahlliste
    Attribute / Attributwerte aus Auswahllisten (nach Auswahl der Werte ist der attr Knopf anzuklicken)
  • je nach Objekttyp stehen weitere / andere Aktionen zur Verfügung

Nach einem Klick auf "Modify" werden die Änderungen an der Definition unmittelbar wirksam.

Die Änderung müssen manuell in der Konfigurationsdatei abspeichert werden, ansonsten gehen die Änderungen beim Neustart verloren: "Save config" (aus dem Menü in der linken Spalte) anklicken oder den Befehl "save" im Befehl-Eingabefeld eingeben.

RAW-Import

"+" zum Öffnen des mehrzeiligen Befehl-Eingabefeld / RAW-Import

Der RAW-Import ist eine einfache Möglichkeit, mehrere Befehle oder ganze Gerätedefinitionen samt Attributen "en Block" in die Konfiguration zu übernehmen.

Im Style f18 ist ein entsprechendes Dialogfeld direkt über das "+" neben dem Befehl-Eingabefeld zu erreichen, ansonsten am Ende jeder Geräte-Detailansicht über den Link Raw definition.

Nach einem Klick auf "Execute" werden die Änderungen unmittelbar wirksam.

Die Änderung müssen manuell in der Konfigurationsdatei abspeichert werden, ansonsten gehen die Änderungen beim Neustart verloren: "Save config" (aus dem Menü in der linken Spalte) anklicken oder den Befehl "save" im Befehl-Eingabefeld eingeben.

Integrierter Editor

Aufruf des integrierten Editors
Editfenster (Ausschnitt) mit Syntaxhervorhebung

Sollte ein direktes Editieren der Konfigurationsdatei als nötig erachtet werden, wird der Editor über den entsprechenden Menüeintrag in der linken Spalte erreicht. Auf die Einhaltung der Syntax von Befehlen und Definitionen ist zu achten, teilweise sind besondere Maßnahmen zu ergreifen ("Escapen" von Sonderzeichen, verdoppeln von Semikolon). Mit dem Abspeichern der editierten Datei werden die Änderungen unmittelbar aktiv, korrekte Syntax und Semantik vorausgesetzt.

Seit Februar 2015 ist die Bearbeitung der Konfiguration über den Integrierten Editor als nicht empfohlene Variante standardmäßig gesperrt. Rudolf König dazu: "Durch das direkte Editieren der Datei kann FHEM die Fehler der Benutzer nicht so gut abfangen (kein dropdown, wizard, etc), bzw. die Fehlermeldungen sind etwas aufwendiger zu interpretieren, d.h. man muss sie lesen und verstehen. Dass sowas nicht selbstverstaendlich ist, beweist gerade diese Diskussion, und solche Probleme muessen wir (die Supporter) hier im Forum ausbaden. Deswegen sollten die Anfaenger nicht dazu ermuntert werden, die Konfiguration in FHEMWEB direkt zu editieren. Verboten ist es keinesfalls, es wird seit gestern nur eine kleine Huerde (Hinweis + Eintrittspruefung) hingelegt." Beitrag

Syntaxhervorhebung

FHEM bietet für die oben genannten Varianten der Konfigurationsbearbeitung über FHEMWEB -mit Ausnahme des Befehl-Eingabefeldes- Syntaxhervorhebungs-, Befehlsauswahl- und Befehlsvervollständigungsfunktionen.

Um die Funktionalität zu aktivieren, muss folgendes Attribut bei der entsprechenden FHEMWEB-Instanz gesetzt werden:

attr <FHEMWEB-Devicename> JavaScripts codemirror/fhem_codemirror.js

Details zu der Funktionalität und zu Anpassungsmöglichkeiten enthält der Artikel zu codemirror.

Externer Editor

Das Editieren der Konfiguration kann auch mit einem externen Editor wie z. B.

  • Notepad++ (beispielweise mit der nppFTP-Erweiterung)
  • nano in einer Telnet Sitzung
  • in wfftp integrierter / integrierbarer Editor

erfolgen (duplizieren von Definitionen (auch möglich mit copy), globale Änderungen (auch möglich mit rename, attr, usw in Verbindung mit devspec...), umsortieren von Definitionen (fehleranfällig und übernimmt FHEM bei Bearbeitung über FHEMWEB automatisch), etc.). In diesem Fall sollte der Benutzer sich mit der Bedienung des Editors in der gewählten Umgebung und FHEM hinreichend gut auskennen.

Auf die Einhaltung der Syntax von Befehlen und Definitionen ist zu achten, teilweise sind besondere Maßnahmen zu ergreifen ("Escapen" von Sonderzeichen, verdoppeln von Semikolon). Nach dem Abspeichern der editierten Datei werden die Änderungen erst nach erneutem Einlesen der Konfiguration aktiv, korrekte Syntax und Semantik vorausgesetzt.

Notwendige Aktionen nach Durchführung der Änderung: "rereadcfg" oder Neustart von FHEM.

Syntax-Highlighting kann bei verschiedenen externen Editoren verwendet werden, näheres s. Syntax Highlighting bei externen Editoren.

Aufteilung der fhem.cfg in mehrere Konfigurationsdateien

Die fhem.cfg kann bei Bedarf mit Hilfe des Befehls include in mehrere Konfigurationsdateien aufgeteilt werden. Dies ist als "Expertenmodus" zu betrachten und sollte (wenn überhaupt) nur von erfahrenen Benutzern angewendet werden.

Konfiguration in einer SQL Datenbank

Seit April 2014 (FHEM-Version 5079) können Definitionen alternativ zur Speicherung in einer einfachen Text-Konfigurationsdatei(en) in einer SQL Datenbank abgelegt werden. Hierzu dienen configDB (Modul) und configdb (Befehl), die in der commandref/configDB dokumentiert sind.

Weitere Informationen hierzu im FHEM Forum:

Anmerkungen

  1. Diese Begrifflichkeit wird im FHEM-Kontext auch verwendet, wenn die Konfiguration über mehrere Dateien verteilt oder in einer Datenbank gespeichert sein sollte
  2. Sofern nicht anderweitig erwähnt, beziehen sich alle weiteren Aussagen und Bildschirmfotos auf das Standard Webinterface im Stil "f18"
  3. Diese Datei befindet sich im Installationsverzeichnis (z. B. /opt/fhem)
  4. Betriebssystemspezifisch; bei neueren Linux-Versionen über systemd