SMF-verwaltete Dienstkonfiguration mit svccfg ändern, statt die Konfigurationsdatei zu bearbeiten

Ziel

Die persistente Konfiguration eines SMF-verwalteten Dienstes (zum Beispiel des DNS-Resolvers) auf dem unterstützten Weg ändern, sodass die Änderung einen Refresh des Dienstes übersteht und nicht stillschweigend überschrieben wird.

Voraussetzungen

Berechtigungen zum Ändern des Service-Configuration-Repositorys für den betroffenen Dienst (Rolle root oder ein zugewiesenes Profil); die FMRI des Dienstes und die Property-Gruppe mit der zu ändernden Einstellung. Beide sind vor jedem Schreibvorgang mit listprop zu ermitteln.

Schritte

1. Vor jeder Änderung die aktuellen Werte lesen: svccfg -s <fmri> listprop listet alle Property-Gruppen und Properties mit ihrem Typ auf; mit svccfg -s <fmri> listprop <pg> lässt sich die Ausgabe auf eine Gruppe eingrenzen.
2. Eine Property nicht interaktiv ändern: svccfg -s network/dns/client setprop config/nameserver = net_address: '(10.0.0.1 10.0.0.2)' – auf der Shell-Kommandozeile muss die Liste in Klammern in Anführungszeichen stehen, sonst lehnt die Shell sie ab. Derselbe Unterbefehl funktioniert ohne Anführungszeichen in einer interaktiven svccfg -s <fmri>-Sitzung am Prompt.
3. Die Änderung auf die laufende Instanz anwenden: svcadm refresh <fmri>. setprop ändert nur das Repository; der laufende Dienst verwendet weiterhin seinen laufenden Snapshot, und erst ein Refresh kopiert die neuen Werte dorthin. svcadm restart allein aktualisiert diesen Snapshot nicht – bei Diensten, die ihre Konfiguration nur beim Start lesen, zuerst Refresh, danach Restart.
4. Prüfen, ob die Änderung wirksam ist: svccfg -s <fmri> listprop <pg> zeigt die Werte im Repository, während svcprop -p <pg> <fmri> zeigt, was die laufende Instanz sieht (ihren laufenden Snapshot). Für einen DNS-Client setzt die dokumentierte Vorgehensweise zusätzlich config/search, setzt config/host = astring: "files dns" auf svc:/system/name-service/switch, führt für beide Instanzen einen Refresh durch und aktiviert dns/client und name-service/switch, falls sie deaktiviert sind.
5. Für eine neue Property ohne bestehenden Standardwert zuerst die Property-Gruppe mit svccfg -s <fmri> addpg <pg> <pgtype> anlegen und erst danach setprop darin ausführen.

Erwartetes Ergebnis

listprop zeigt den neuen Wert, die aktualisierte Instanz verhält sich entsprechend (ein DNS-Client liest seine Konfiguration neu ein, wie sie aus den SMF-Properties erzeugt wird), und die Änderung übersteht einen Neustart, weil das Repository und nicht eine einfache Textdatei massgeblich ist.

Grenzen und Prüfbasis

Eine Konfigurationsdatei, die SMF aus Dienst-Properties erzeugt, nie von Hand bearbeiten: Bei network/dns/client erzeugt Solaris /etc/resolv.conf aus den SMF-Properties neu, sodass eine manuelle Änderung beim nächsten Refresh des Dienstes überschrieben wird. Nicht jeder SMF-Dienst funktioniert so (viele lesen weiterhin ihre eigene Datei); deshalb vorab in der Dokumentation des Dienstes nachprüfen, welcher Fall vorliegt. Zum Rückgängigmachen vor einer riskanten Änderung die Ausgabe von listprop <pg> sichern und den alten Wert per setprop zurückschreiben, oder administrative Anpassungen mit svccfg -s <fmri> delcust <pattern> verwerfen (vorher mit denselben Argumenten listcust ausführen, um zu sehen, was entfernt würde); in beiden Fällen folgt ein svcadm refresh. Dies gilt für Oracle Solaris 11.4; illumos-Distributionen übernehmen dasselbe svccfg-Repository-Modell.