Friday, November 3, 2017

SMF service - stability

Any development can reach different maturity levels throughout its life-cycle. In SMF service development, annotation support for indicating this is provided by means of the old Solaris 10 classification scheme for Interface Stability notices as described in attributes(5).

In terms of SMF services this corresponds to the stability tag. If present, this tag can appear at just a few different places, but a common one is to the bottom of a service description (to indicate the whole service stability level), but just above a template tag if this last one is present.

It can assume the following values:
  • Standard
  • Stable
  • Evolving
  • Unstable
  • External
  • Obsolete

Example:

...

<service type="service" version="..."
 name="..." >

  ...

  <stability value="..." />

</service >

... 
     
NOTE
The stability level may have an impact on property groups across a release boundary of a service, in that Stable and Evolving ones are always preserved (not deleted) while Unstable ones may be deleted. See smf_bootstrap(5) for more detail.