PSARC 2007/519 svccfg restore

[Michael Shapiro]

I'm sponsoring the following fast-track for Keith Wesolowski.  This adds
a missing subcommand to the svccfg(1M) utility that was missing from
the original smf project.  As this is small and has been discussed
among a variety of people involved with SMF, I'm marking it closed
approved automatic.  Send email with any questions.

-Mike

--

1. Description

   This case describes the addition of a new subcommand to svccfg(1M) to
   restore the contents of an archive generated by the existing svccfg(1M)
   archive subcommand.  This case seeks Micro/Patch Release binding.

2. Discussion

   When Greenline was originally approved and integrated, it was
   possible to archive the entire contents of the SCF repository, but no
   provision was made for restoring such archives in an automated fashion.
   Presumably, the only use for these archives was as a last-ditch fallback
   in the case that all repository backups were lost and one wished to have
   a record for restoring manually.

   This case introduces an automated mechanism to restore these
   archives, as noted by RFE 6546699.  This change is made in support of
   the requirement imposed by the ARC for integration of PSARC/2007/177.

3. Documentation Changes

   The svccfg(1M) man page will be updated to reflect the presence of
   this subcommand, and svccfg(1M) help will also expose the existence of
   the subcommand.

+     restore
+
+         Restores the contents of the repository from a full XML
+         service description previously created by the archive
+         subcommand.  If the archive was generated without the use
+         of the -a option, the contents of the repository following
+         completion of the restore will not include the values of
+         any read-protected properties (see smf_security(5)); these
+         must be restored manually if required.
+
+

4. Interfaces Imported

   SCF Archive XML DTD                  Committed

5. Interfaces Exported

   svccfg restore                       Uncommitted

-- 
Mike Shapiro, Solaris Kernel Development. blogs.sun.com/mws/