Alterar a configuração de um serviço gerido pelo SMF com svccfg em vez de editar o arquivo de configuração

Objetivo

Alterar a configuração persistente de um serviço gerido pelo SMF (por exemplo, o resolvedor DNS) da forma suportada, de modo que a mudança sobreviva a um refresh do serviço e não seja sobrescrita silenciosamente.

Pré-requisitos

Permissão para modificar o repositório de configuração de serviços para o serviço em questão (papel root ou um perfil atribuído); o FMRI do serviço e o grupo de propriedades que contém a configuração a alterar, identificados com listprop antes de gravar qualquer coisa.

Passos

1. Leia os valores atuais antes de alterar qualquer coisa: svccfg -s <fmri> listprop lista todos os grupos de propriedades e propriedades com o respectivo tipo; para restringir a um só grupo, use svccfg -s <fmri> listprop <pg>.
2. Altere uma propriedade de forma não interativa: svccfg -s network/dns/client setprop config/nameserver = net_address: '(10.0.0.1 10.0.0.2)' — na linha de comando do shell, a lista entre parênteses precisa estar entre aspas, ou o shell a rejeita. O mesmo subcomando funciona sem aspas dentro de uma sessão interativa svccfg -s <fmri>, no respectivo prompt.
3. Aplique a mudança à instância em execução: svcadm refresh <fmri>. O setprop apenas edita o repositório; o serviço em execução continua usando o seu snapshot de execução, e somente um refresh copia os novos valores para ele. svcadm restart sozinho não atualiza esse snapshot — para serviços que só leem a configuração na inicialização, faça primeiro o refresh e depois o restart.
4. Valide se a mudança teve efeito: svccfg -s <fmri> listprop <pg> mostra os valores do repositório, enquanto svcprop -p <pg> <fmri> mostra o que a instância em execução enxerga (o seu snapshot de execução). Para um cliente DNS, o procedimento documentado também define config/search, define config/host = astring: "files dns" em svc:/system/name-service/switch, faz o refresh das duas instâncias e habilita dns/client e name-service/switch caso estejam desabilitados.
5. Para uma propriedade totalmente nova, sem valor padrão existente, crie primeiro o grupo de propriedades com svccfg -s <fmri> addpg <pg> <pgtype> antes de executar setprop dentro dele.

Resultado esperado

listprop mostra o novo valor, a instância atualizada se comporta de acordo (um cliente DNS relê a sua configuração tal como regenerada a partir das propriedades do SMF) e a mudança sobrevive a uma reinicialização, porque quem tem a autoridade é o repositório, e não um arquivo simples.

Limites e base de verificação

Nunca edite manualmente um arquivo de configuração que o SMF gera a partir de propriedades do serviço: no caso de network/dns/client, o Solaris regenera /etc/resolv.conf a partir das propriedades do SMF, de modo que uma edição manual é sobrescrita na próxima vez que o serviço sofrer refresh. Nem todo serviço SMF funciona assim (muitos ainda leem o seu próprio arquivo), por isso consulte a documentação do serviço antes de presumir uma coisa ou outra. Para desfazer, salve a saída de listprop <pg> antes de uma mudança arriscada e use setprop para voltar ao valor antigo, ou descarte as personalizações administrativas com svccfg -s <fmri> delcust <pattern> (execute antes listcust com os mesmos argumentos para ver o que seria removido); em ambos os casos, finalize com svcadm refresh. Isto vale para o Oracle Solaris 11.4; as distribuições illumos herdam o mesmo modelo de repositório do svccfg.