From sacadmin Thu Sep 6 19:02:25 2007 Received: from zion.eng.sun.com (zion [129.146.17.75]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l8722P5Q013703; Thu, 6 Sep 2007 19:02:25 -0700 (PDT) Received: from zion.eng.sun.com (localhost [127.0.0.1]) by zion.eng.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l871xdg0015549; Thu, 6 Sep 2007 18:59:39 -0700 (PDT) Received: (from mws@localhost) by zion.eng.sun.com (8.14.1+Sun/8.14.1/Submit) id l871xdZh015546; Thu, 6 Sep 2007 18:59:39 -0700 (PDT) Date: Thu, 6 Sep 2007 18:59:39 -0700 (PDT) From: Michael Shapiro Message-Id: <200709070159.l871xdZh015546@zion.eng.sun.com> To: PSARC-record@sac.sfbay.sun.com Subject: svccfg restore [PSARC/2007/519 FastTrack timeout 09/07/2007] Status: RO Content-Length: 560 Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI This information is Copyright 2007 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: svccfg restore 1.2. Name of Document Author/Supplier: Author: Keith Wesolowski 1.3 Date of This Document: 06 September, 2007 4. Technical Description See the case directory for more detail 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: OS/Net 6.5. ARC review type: FastTrack 6.6. ARC Exposure: open From mws@zion.eng.sun.com Thu Sep 6 19:09:16 2007 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l8729GTh013718 for ; Thu, 6 Sep 2007 19:09:16 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l8726TwZ006177; Thu, 6 Sep 2007 19:06:30 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JNZ00K0576UZ600@nwk-avmta-2.sfbay.sun.com>; Thu, 06 Sep 2007 19:06:30 -0700 (PDT) Received: from zion.eng.sun.com ([129.146.17.75]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JNZ00F4776TFQE0@nwk-avmta-2.sfbay.sun.com>; Thu, 06 Sep 2007 19:06:29 -0700 (PDT) Received: from zion.eng.sun.com (localhost [127.0.0.1]) by zion.eng.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l8726TaJ015616; Thu, 06 Sep 2007 19:06:29 -0700 (PDT) Received: (from mws@localhost) by zion.eng.sun.com (8.14.1+Sun/8.14.1/Submit) id l8726TO2015615; Thu, 06 Sep 2007 19:06:29 -0700 (PDT) Date: Thu, 06 Sep 2007 19:06:29 -0700 (PDT) From: Michael Shapiro Subject: PSARC 2007/519 svccfg restore To: psarc-ext@sun.com Cc: mws@sun.com, keith.wesolowski@sun.com Message-id: <200709070206.l8726TO2015615@zion.eng.sun.com> MIME-version: 1.0 X-Mailer: ELM [version 2.4ME+ PL31H (25)] Content-type: text/plain; charset=US-ASCII Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 Status: RO Content-Length: 2083 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/ From carlsonj@phorcys.east.sun.com Fri Sep 7 04:01:51 2007 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l87B1p8e021417 for ; Fri, 7 Sep 2007 04:01:51 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l87Ax18B028615; Fri, 7 Sep 2007 03:59:04 -0700 (PDT) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JNZ00715VUEYN00@brm-avmta-1.central.sun.com>; Fri, 07 Sep 2007 04:59:02 -0600 (MDT) Received: from phorcys.east.sun.com ([129.148.174.143]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JNZ00LZEVUDQG70@brm-avmta-1.central.sun.com>; Fri, 07 Sep 2007 04:59:01 -0600 (MDT) Received: from phorcys.east.sun.com (localhost [127.0.0.1]) by phorcys.east.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l87Ax0CE134654; Fri, 07 Sep 2007 06:59:00 -0400 (EDT) Received: (from carlsonj@localhost) by phorcys.east.sun.com (8.14.1+Sun/8.14.1/Submit) id l87Ax071134651; Fri, 07 Sep 2007 06:59:00 -0400 (EDT) Date: Fri, 07 Sep 2007 06:59:00 -0400 From: James Carlson Subject: Re: PSARC 2007/519 svccfg restore In-reply-to: <200709070206.l8726TO2015615@zion.eng.sun.com> To: Michael Shapiro Cc: psarc-ext@sun.com, Keith.Wesolowski@sun.com Message-id: <18145.12020.871777.760651@gargle.gargle.HOWL> MIME-version: 1.0 X-Mailer: VM 7.01 under Emacs 21.3.1 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200709070206.l8726TO2015615@zion.eng.sun.com> Status: RO Content-Length: 836 Michael Shapiro writes: > 4. Interfaces Imported > > SCF Archive XML DTD Committed Is this case actually asserting that the DTD is Committed? What happens when an archive produced with an older version of Solaris is restored on a newer version? Won't some services have changed names, others deleted, and still other new ones have been created? It seems to me that correct operation of this feature depends on more than just the DTD itself. It depends on the inventory of named services, but some of those actually represent implementation details of Solaris and not stable interfaces. -- James Carlson, Solaris Networking Sun Microsystems / 1 Network Drive 71.232W Vox +1 781 442 2084 MS UBUR02-212 / Burlington MA 01803-2757 42.496N Fax +1 781 442 1677 From mws@zion.eng.sun.com Sun Sep 9 21:08:22 2007 Received: from sunmail4.Singapore.Sun.COM (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l8A48LkK010550 for ; Sun, 9 Sep 2007 21:08:22 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail4.Singapore.Sun.COM (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id l8A45FAJ019169; Mon, 10 Sep 2007 12:05:28 +0800 (SGT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JO400203WP3ZH00@nwk-avmta-2.sfbay.sun.com>; Sun, 09 Sep 2007 21:05:27 -0700 (PDT) Received: from zion.eng.sun.com ([129.146.17.75]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JO4002F3WP3R500@nwk-avmta-2.sfbay.sun.com>; Sun, 09 Sep 2007 21:05:27 -0700 (PDT) Received: from zion.eng.sun.com (localhost [127.0.0.1]) by zion.eng.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l8A45RcJ011620; Sun, 09 Sep 2007 21:05:27 -0700 (PDT) Received: (from mws@localhost) by zion.eng.sun.com (8.14.1+Sun/8.14.1/Submit) id l8A45RdD011619; Sun, 09 Sep 2007 21:05:27 -0700 (PDT) Date: Sun, 09 Sep 2007 21:05:27 -0700 (PDT) From: Michael Shapiro Subject: Re: PSARC 2007/519 svccfg restore In-reply-to: <18145.12020.871777.760651@gargle.gargle.HOWL> To: james.d.carlson@sun.com (James Carlson) Cc: psarc-ext@sun.com, Keith.Wesolowski@sun.com Message-id: <200709100405.l8A45RdD011619@zion.eng.sun.com> MIME-version: 1.0 X-Mailer: ELM [version 2.4ME+ PL31H (25)] Content-type: text/plain; charset=US-ASCII Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 Status: RO Content-Length: 2040 > Michael Shapiro writes: > > 4. Interfaces Imported > > > > SCF Archive XML DTD Committed > > Is this case actually asserting that the DTD is Committed? The DTD for SMF is already a committed interface, as per the original SMF case. > What happens when an archive produced with an older version of Solaris > is restored on a newer version? Won't some services have changed > names, others deleted, and still other new ones have been created? The purpose of the backup is to restore the repository to the same state: it obviously has no effect on the rest of the system. > It seems to me that correct operation of this feature depends on more > than just the DTD itself. It depends on the inventory of named > services, but some of those actually represent implementation details > of Solaris and not stable interfaces. This command manipulates the repository: nothing else. Consider this analogy: I make a copy of /etc/apache2/httpd.conf. If I restore that file by cp'ing it back into place, or writing some script to install a particular set of settings by copying that file into place, that either is a perfectly sane and reasonable thing to do that achieves a desired result, or it is an operation that causes a failure if (a) apache2 has been upgraded incompatibly, or (b) my configuration file refers to say apache2 modules that don't exist anymore on the system, or were never installed. So whether this makes sense to do or not depends on my intent, and the relationship between this action and whatever else I'm doing (e.g. upgrade script, system-wide restore, etc.) The existing smf archive command is the equivalent of saving a copy of the file, the new command is the equivalent of restoring it. Depending on what else is going on, that either has meaning or it doesn't. The new command enables various useful activities that weren't previously possible. But it isn't some kind of system-wide backup/restore facility. -Mike -- Mike Shapiro, Solaris Kernel Development. blogs.sun.com/mws/ From carlsonj@phorcys.east.sun.com Mon Sep 10 04:07:02 2007 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l8AB72kC022019 for ; Mon, 10 Sep 2007 04:07:02 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail5.uk.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l8AB3ujp022572; Mon, 10 Sep 2007 12:04:10 +0100 (BST) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JO50020DG2W4Q00@nwk-avmta-2.sfbay.sun.com>; Mon, 10 Sep 2007 04:04:08 -0700 (PDT) Received: from phorcys.east.sun.com ([129.148.174.143]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JO500GWAG2V9JE0@nwk-avmta-2.sfbay.sun.com>; Mon, 10 Sep 2007 04:04:07 -0700 (PDT) Received: from phorcys.east.sun.com (localhost [127.0.0.1]) by phorcys.east.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l8AB47hB101362; Mon, 10 Sep 2007 07:04:07 -0400 (EDT) Received: (from carlsonj@localhost) by phorcys.east.sun.com (8.14.1+Sun/8.14.1/Submit) id l8AB47vG101359; Mon, 10 Sep 2007 07:04:07 -0400 (EDT) Date: Mon, 10 Sep 2007 07:04:06 -0400 From: James Carlson Subject: Re: PSARC 2007/519 svccfg restore In-reply-to: <200709100405.l8A45RdD011619@zion.eng.sun.com> To: Michael Shapiro Cc: psarc-ext@sun.com, Keith.Wesolowski@sun.com Message-id: <18149.9382.972660.235275@gargle.gargle.HOWL> MIME-version: 1.0 X-Mailer: VM 7.01 under Emacs 21.3.1 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <18145.12020.871777.760651@gargle.gargle.HOWL> <200709100405.l8A45RdD011619@zion.eng.sun.com> Status: RO Content-Length: 814 Michael Shapiro writes: > The existing smf archive command is the equivalent of saving a copy of the > file, the new command is the equivalent of restoring it. Depending on what > else is going on, that either has meaning or it doesn't. The new command > enables various useful activities that weren't previously possible. > But it isn't some kind of system-wide backup/restore facility. Given that, should it come with some sort of usage warning? Users may not be able to recover system state successfully after installing a patch, let alone with an upgrade of some system components. -- James Carlson, Solaris Networking Sun Microsystems / 1 Network Drive 71.232W Vox +1 781 442 2084 MS UBUR02-212 / Burlington MA 01803-2757 42.496N Fax +1 781 442 1677 From mws@zion.eng.sun.com Mon Sep 10 15:23:48 2007 Received: from sunmail4.Singapore.Sun.COM (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l8AMNm02007856 for ; Mon, 10 Sep 2007 15:23:48 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail4.Singapore.Sun.COM (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id l8AMKr2h000756; Tue, 11 Sep 2007 06:20:54 +0800 (SGT) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JO600D0HBES8100@brm-avmta-1.central.sun.com>; Mon, 10 Sep 2007 16:20:52 -0600 (MDT) Received: from zion.eng.sun.com ([129.146.17.75]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JO600CFLBEREP00@brm-avmta-1.central.sun.com>; Mon, 10 Sep 2007 16:20:51 -0600 (MDT) Received: from zion.eng.sun.com (localhost [127.0.0.1]) by zion.eng.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l8AMKpWB025261; Mon, 10 Sep 2007 15:20:51 -0700 (PDT) Received: (from mws@localhost) by zion.eng.sun.com (8.14.1+Sun/8.14.1/Submit) id l8AMKpqw025260; Mon, 10 Sep 2007 15:20:51 -0700 (PDT) Date: Mon, 10 Sep 2007 15:20:51 -0700 (PDT) From: Michael Shapiro Subject: Re: PSARC 2007/519 svccfg restore In-reply-to: <18149.9382.972660.235275@gargle.gargle.HOWL> To: james.d.carlson@sun.com (James Carlson) Cc: psarc-ext@sun.com, Keith.Wesolowski@sun.com Message-id: <200709102220.l8AMKpqw025260@zion.eng.sun.com> MIME-version: 1.0 X-Mailer: ELM [version 2.4ME+ PL31H (25)] Content-type: text/plain; charset=US-ASCII Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 Status: RO Content-Length: 878 > Michael Shapiro writes: > > The existing smf archive command is the equivalent of saving a copy of the > > file, the new command is the equivalent of restoring it. Depending on what > > else is going on, that either has meaning or it doesn't. The new command > > enables various useful activities that weren't previously possible. > > But it isn't some kind of system-wide backup/restore facility. > > Given that, should it come with some sort of usage warning? Users may > not be able to recover system state successfully after installing a > patch, let alone with an upgrade of some system components. Yeah, I see your point: we'll address this via a Note in the new man page description. Keith will put you on the interest list for the man page bug and you can help us review the wording here. -Mike -- Mike Shapiro, Solaris Kernel Development. blogs.sun.com/mws/