Consultar e alterar o estado de serviços com o Service Management Facility: svcs e svcadm

Objetivo

Determinar o estado dos serviços em um host Solaris 11.4 e habilitar, desabilitar, reiniciar ou limpar uma instância de serviço com segurança, usando o Service Management Facility (SMF).

Pré-requisitos

Um shell na zona cujos serviços você gerencia (cada zona não global executa a sua própria instância do SMF e é administrada de dentro dela), com permissão para gerenciar serviços: o papel root ou um perfil com a autorização SMF correspondente (veja o artigo sobre RBAC nesta série). Consultar o estado não exige privilégios.

Passos

1. Liste tudo: svcs -a mostra todas as instâncias de serviço com o respectivo estado (online, offline, disabled, maintenance, degraded, legacy_run) e o identificador de recurso do gerenciamento de falhas (FMRI, fault management resource identifier).
2. Encontre problemas rapidamente: svcs -x imprime uma explicação apenas para instâncias que estão habilitadas mas não estão em execução, ou que têm dependências não satisfeitas; não produz saída se tudo o que está habilitado estiver em execução.
3. Inspecione uma instância em detalhe: svcs -l <fmri> imprime as dependências, o contrato de processo e o caminho do log dessa instância; svcs -L <fmri> imprime somente o caminho do log.
4. Habilite de forma persistente: svcadm enable <fmri>. Por padrão, o enable persiste após a reinicialização; acrescente -t para habilitar apenas temporariamente, até a próxima reinicialização.
5. Desabilite, reinicie ou atualize: svcadm disable [-t] <fmri> (persistente, a menos que use -t); svcadm restart <fmri> (parada seguida de início; atua apenas em instâncias online ou degraded, portanto não faz nada com uma instância em maintenance); svcadm refresh <fmri> (copia a configuração atual para o snapshot em execução e executa o método de refresh, se houver). O -t existe apenas para enable e disable; acrescente -s para aguardar até a instância se estabilizar.
6. Leia os logs de uma instância com falha no caminho informado por svcs -l, normalmente um arquivo em /var/svc/log/ com o nome baseado no FMRI do serviço.
7. Limpe uma instância travada: depois de corrigido o problema de fundo, svcadm clear <fmri> tira uma instância do estado maintenance ou degraded para que o restarter a reavalie.

Resultado esperado

svcs -x não produz saída quando todos os serviços habilitados estão de fato em execução; a instância alvo aparece como online (ou disabled, se esse era o objetivo) em svcs -a, e o arquivo de log deixa de acumular o erro anterior.

Limites e base de verificação

As alterações feitas com svcadm enable/disable -t se perdem na próxima reinicialização, por projeto; não conte com -t para nada que precise sobreviver a um reinício, e remova o -t quando tiver certeza de que a mudança está correta. Limpar uma instância em maintenance não corrige a causa de fundo: se o método de início continuar falhando, a instância volta imediatamente a maintenance; quando um clear não se sustenta, leia o log em vez de repetir o clear. As mudanças de estado são reversíveis executando svcadm no sentido oposto, mas nem sempre a partir de onde você está: desabilitar ou reiniciar network/ssh, network/physical ou um serviço do qual eles dependam pode derrubar a sua própria sessão remota, então mantenha acesso ao console nesses casos. Isto cobre o Oracle Solaris 11.4; os conceitos de SMF aqui descritos também valem para sistemas baseados em illumos, que compartilham o mesmo framework de gerenciamento de serviços.