smf_restarter man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

SMF_RESTARTER(5)					      SMF_RESTARTER(5)

NAME
       smf_restarter - service management facility conventions for restarters

DESCRIPTION
       All  service  instances in the service management facility must be man‐
       aged by a restarter. This manual page  describes	 configuration,	 func‐
       tionality,  and	reporting  characteristics  that  are  common  to  all
       restarters in the framework.  Characteristics specific to a  particular
       restarter are described in the restarter's man page.

       For  each  managed service, a restarter relies on retrieving properties
       on the service instance to determine configuration. The restarter  man‐
       ages a set of property groups to communicate the current disposition of
       a service with display tools such as svcs(1).

   Service Configuration
       The common restarter configuration for all services is captured in  the
       general	property group. This group includes the following required and
       optional property settings.

       enabled
			  This is a required property. If set,	the  restarter
			  of  an instance attempts to maintain availability of
			  the service.

       restarter
			  This is an optional property that allows the	speci‐
			  fication  of	an  alternate  restarter to manage the
			  service instance. If the restarter property is empty
			  or absent, the restarter defaults to svc.startd(1M).

       single_instance
			  This	is  an	optional  property. When set, only one
			  instance of the service is allowed to transition  to
			  an online or degraded status at any time.

   Service Reporting
       All  restarters report status using the restarter property group, which
       includes the following properties:

       next_state
			  The current state and next state,  if	 currently  in
			  transition,  for  instances  stored in these proper‐
			  ties. See smf(5) for a description of the  potential
			  states.

       auxiliary_state
			  An  astring  with  no spaces that contains a precise
			  term to describe the full  restarter-specific	 state
			  in  combination  with	 the restarter state property.
			  The auxiliary state cannot  always  be  set  and  is
			  always  cleared  during transition out of any state.
			  Each restarter must define the precise list of  aux‐
			  iliary states it uses.

       state_timestamp
			  The time when the current state was reached.

       contract
			  The primary process contract ID, if any, under which
			  the service instance is executing.

SEE ALSO
       svcs(1), svc.startd(1M), service_bundle(4), smf(5), smf_method(5)

				 May 23, 2008		      SMF_RESTARTER(5)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net