Cambiar la configuración de un servicio gestionado por SMF con svccfg en lugar de editar su archivo de configuración

Objetivo

Cambiar la configuración persistente de un servicio gestionado por SMF (por ejemplo, el resolvedor DNS) de la forma admitida, de modo que el cambio sobreviva a un refresh del servicio y no se sobrescriba sin aviso.

Requisitos previos

Permisos para modificar el repositorio de configuración de servicios para el servicio de destino (rol root o un perfil asignado); el FMRI del servicio y el grupo de propiedades que contiene el valor que se quiere cambiar, localizados con listprop antes de escribir nada.

Pasos

1. Lea los valores actuales antes de cambiar nada: svccfg -s <fmri> listprop muestra todos los grupos de propiedades y sus propiedades con su tipo; para limitarlo a un grupo, use svccfg -s <fmri> listprop <pg>.
2. Cambie una propiedad de forma no interactiva: svccfg -s network/dns/client setprop config/nameserver = net_address: '(10.0.0.1 10.0.0.2)'. En la línea de comandos del shell, la lista entre paréntesis debe ir entre comillas; de lo contrario, el shell la rechaza. El mismo subcomando funciona sin comillas dentro de una sesión interactiva de svccfg -s <fmri>, en su prompt.
3. Aplique el cambio a la instancia en ejecución: svcadm refresh <fmri>. setprop solo modifica el repositorio; el servicio en ejecución sigue usando su instantánea en ejecución, y únicamente un refresh copia en ella los nuevos valores. svcadm restart por sí solo no actualiza esa instantánea: en los servicios que leen la configuración solo al arrancar, haga primero el refresh y después el restart.
4. Compruebe que el cambio surtió efecto: svccfg -s <fmri> listprop <pg> muestra los valores del repositorio, mientras que svcprop -p <pg> <fmri> muestra lo que ve la instancia en ejecución (su instantánea en ejecución). Para un cliente DNS, el procedimiento documentado también establece config/search, define config/host = astring: "files dns" en svc:/system/name-service/switch, hace refresh de ambas instancias y habilita dns/client y name-service/switch si están deshabilitados.
5. Para una propiedad completamente nueva y sin valor predeterminado, cree primero el grupo de propiedades con svccfg -s <fmri> addpg <pg> <pgtype> antes de ejecutar setprop dentro de él.

Resultado esperado

listprop muestra el nuevo valor, la instancia refrescada se comporta en consecuencia (un cliente DNS vuelve a leer su configuración regenerada a partir de las propiedades de SMF) y el cambio persiste tras un reinicio, porque la autoridad es el repositorio y no un archivo plano.

Límites y base de verificación

No edite nunca a mano un archivo de configuración que SMF genera a partir de las propiedades del servicio: en network/dns/client, Solaris regenera /etc/resolv.conf a partir de las propiedades de SMF, de modo que una edición manual se sobrescribe la próxima vez que el servicio se refresque. No todos los servicios SMF funcionan así (muchos siguen leyendo su propio archivo), por lo que conviene consultar la documentación del servicio antes de dar por sentado cualquiera de los dos casos. Para deshacer un cambio, guarde la salida de listprop <pg> antes de una modificación arriesgada y restaure el valor anterior con setprop, o elimine las personalizaciones administrativas con svccfg -s <fmri> delcust <pattern> (ejecute antes listcust con los mismos argumentos para ver qué se eliminaría); en ambos casos, ejecute después svcadm refresh. Esto se aplica a Oracle Solaris 11.4; las distribuciones illumos heredan el mismo modelo de repositorio de svccfg.