From sacadmin Thu May 29 14:41:32 2008 Received: from coupe.sfbay.sun.com (coupe.SFBay.Sun.COM [129.146.177.41]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m4TLfWEk021759; Thu, 29 May 2008 14:41:32 -0700 (PDT) Received: from coupe.sfbay.sun.com (localhost [127.0.0.1]) by coupe.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m4TLdtWo011014; Thu, 29 May 2008 14:39:55 -0700 (PDT) Received: (from lianep@localhost) by coupe.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m4TLdtIe011010; Thu, 29 May 2008 14:39:55 -0700 (PDT) Date: Thu, 29 May 2008 14:39:55 -0700 (PDT) From: Liane Praza Message-Id: <200805292139.m4TLdtIe011010@coupe.sfbay.sun.com> To: PSARC-record@sac.sfbay.sun.com Subject: SMF Template Extensions [PSARC/2008/350 FastTrack timeout 06/05/2008] Status: RO Content-Length: 554 Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: SMF Template Extensions 1.2. Name of Document Author/Supplier: Author: Liane Praza 1.3 Date of This Document: 29 May, 2008 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: ON 6.5. ARC review type: FastTrack 6.6. ARC Exposure: open From lianep@coupe.sfbay.sun.com Thu May 29 14:56:53 2008 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m4TLurJK022908 for ; Thu, 29 May 2008 14:56:53 -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 m4TLunqT006692; Thu, 29 May 2008 14:56:52 -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 <0K1N00217GYSBL00@brm-avmta-1.central.sun.com>; Thu, 29 May 2008 15:56:52 -0600 (MDT) Received: from coupe.sfbay.sun.com ([129.146.177.41]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1N0063UGYRT7E0@brm-avmta-1.central.sun.com>; Thu, 29 May 2008 15:56:51 -0600 (MDT) Received: from coupe.sfbay.sun.com (localhost [127.0.0.1]) by coupe.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m4TLtD4g011089; Thu, 29 May 2008 14:55:13 -0700 (PDT) Received: (from lianep@localhost) by coupe.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m4TLtDs6011088; Thu, 29 May 2008 14:55:13 -0700 (PDT) Date: Thu, 29 May 2008 14:55:13 -0700 From: Liane Praza Subject: 2008/350 SMF Template Extensions To: psarc-ext@sun.com Cc: thomas.whitten@sun.com, Antonello.Cruz@sun.com, dep@eng.sun.com Message-id: <20080529215513.GA11082@coupe.sfbay.sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 14967 I'm submitting this fasttrack on my own behalf. It seeks Patch binding, and is set to time out on June 5, 2008. liane --- SMF Template Extensions Liane Praza 2008/05/28 1. Summary This case extends existing SMF templates to provide a general mechanism for describing service configuration metadata. It includes DTD extensions for service manifests, libscf calls, and command extensions. It seeks Patch binding, as no incompatible interfaces are introduced. (There are no current plans to backport this work to Solaris 10.) Additional materials mentioned throughout this document are in the materials subdirectory. 2. Details In an smf(5) service manifest, we have carved out a region for holding service metadata called the "template". It currently only holds things like man/web page references and a localizable service name. We've long hoped to grow this section to encompass more information. This project extends the template metadata significantly, and modifies a number of existing services, and a few existing commands to take advantage of this metadata. These template extensions let us do things like specify human-readable names and descriptions for properties and values, let us indicate when a property isn't something a user should see or modify, let us put some basic constraints on the values a property can take on, and do so in a way that can be wildcarded across classes of property groups, services, or instances. 2.1 DTD extensions Templates are defined through a set of DTD extensions for service manifests. An updated DTD and diffs are provided in the case directory. In addition, smf_template(5) (provided also in the case directory) extensively describes the new tags available to service authors and offers guidelines for their use. A quick overview is offered here for the options available, though the provided smf_template(5) is more descriptive and detailed. Property group patterns describe a property group, allowing wildcarding on name and type (through omission in the definition), and scoping to instance, service, restarter, or global. short name A longer description of the property group. pg_patterns elements may also describe specific properties. short name units, if appropriate A longer description of the property. , prop_patterns may describe constraints and choices for the individual values, as well as descriptions of those values. blue The color between green and indigo. 2.2 libscf calls Two new sets of new libscf calls provide composed access to the template data. One set allows access to the extended template descriptions and metadata. The other validates that configuration meets the constraints defined by templates (allowing exploration of any constraint violations encountered). Additionally, we document and stabilize convenience functions to convert from property type to a string, and string to property type. Full manpages for these functions are included in the case materials, and a list of functions introduced is included in the interface table below. No changes to existing libscf(3lib) calls are currently proposed. Auditing is handled normally by configd. 2.3 Command updates While there are a number of modifications and additions to the existing SMF commands possible using the templates data, we've explored a few basic changes as part of this project. We expect more in the future, though are not pursuing them as part of this case. 2.3.1 svccfg import and validation The existing svccfg validate subcommand is enhanced to validate property groups and properties either in the repository or in a manifest file against template data in the manifest itself, as well as applicable data already in the repository. Template validation confirms that required property groups and properties are present, property groups and properties match their templated definitions, and that any defined constraints on those properties have been satisfied. The existing svccfg import subcommand will now import template information defined in the service manifest. It is also extended to validate against templates during import. It emits warnings during normal operation, and we introduce an optional -V option to fail import if template validation fails. 2.3.2 Displaying templates We wish to allow display of templates data both as extended information about existing settings, as well as to provide information about potential settings. The -l option to svcs is extended to allow combination with the existing -v option. In this mode, property groups of type "application" that are not templated as 'hidden' are displayed along with 'basic' template data. e.g. the information added for "svcs -lv console-login" would be: ttymon (application) ttymon/device (astring) = /dev/console The terminal device to be used for the console login prompt. ttymon/label (astring) = console The appropriate entry from /etc/ttydefs. ttymon/modules (astring) = ldterm,ttcompat Modules to be pushed on the terminal. ttymon/nohangup (boolean) = true Force hangup by temporarily setting line speed to 0. ttymon/prompt (astring) = "`uname -n` console login:" Prompt to be printed on console. ttymon/terminal_type (astring) = "" The initial value of the TERM environment variable. ttymon/timeout (count) = 0 Delay after printing prompt before ttymon should exit. In addition, we introduce a "describe" subcommand to svccfg to allow exploration of template data. describe [-v] [-t] [propertygroup/property] It allows display of either the template data which applies to the existing settings (by default), or of the template data only (with the -t option). 2.4 Guidance update The SMF ARC policy will be updated to recommend service authors define template metadata for service-specific property groups and properties. 2.5 Manifest updates As part of the initial integration of the Templates project, we will provide a set of updated manifests, including updated manifests to describe the global and restarter generic properties. The svc:/system/svc/global service is newly introduced to define SMF-wide templates and settings. 2.6 Repository representation Template data is stored in the repository in an extension to the existing templates data, which is simply modelled as a set of property groups and properties on the service. All template repository representation is private. Property groups are less indented than the properties contained in them in the next few sections. 2.6.1 Existing Template Definitions For reference, the repository representation for the templates elements supported in Solaris 10 is as follows. tm_common_name template C ustring US-ENG ustring UK-ENG ustring tm_description template C ustring tm_man_ template manpath astring section astring title astring 2.6.2 Property Layout For New Template Information tm_pg_pattern_nt_<name> template_pg_pattern tm_pg_pattern_n_<name> template_pg_pattern tm_pg_pattern_t_<type> template_pg_pattern tm_pg_pattern_ template_pg_pattern name astring optional: default wildcard property group's name type astring optional: default wildcard property group's type (remember that property group types may be service-author defined.) required boolean optional: default 'false' target astring optional: default 'this' this|instance|delegate|all common_name_<lang> ustring optional short, localized, human readable name description_<lang> ustring optional localized, longer description tm_prop_pattern_<pg_pattern_name>_<name> template_prop_pattern pg_pattern astring required name of property group for pg_pattern name astring required name of property required boolean optional: default 'false' type astring optional: default wildcard type is optional only if required is false. property group's type, list of types common_name_<lang> ustring optional short, localized, human readable name units_<lang> ustring optional localized, human-readable units description_<lang> ustring optional localized, longer description visibility astring optional hidden|readonly|readwrite cardinality_min astring count non-negative integers cardinality_max astring count non-negative integers internal_separators astring[] optional list of separator characters for values constraint_name astring[] optional possible prop value or list of values constraint_range astring optional min,max choices_range astring optional min,max choices_name astring[] optional possible prop value or list of values choices_include_values astring optional [constraints|values] value_<BASE32 name>_common_name_<lang> ustring optional short, localized A BASE32 encoding of the value name is required because the value name may not be suitable for property-name inclusion. value_<BASE32 name>_description_<lang> ustring optional localized, longer description A BASE32 encoding of the value name is required because the value name may not be suitable for property-name inclusion. 3. Interface Table template DTD extensions Committed templates repository representation Private svc:/system/svc/global Uncommitted svccfg validate Committed svccfg import -V Committed svccfg describe (invocation) Committed svccfg describe (output) Not-an-interface svcs -lv (invocation) Committed svcs -lv (output) Not-an-interface scf_type_to_string() Committed scf_string_to_type() Committed scf_tmpl_pg_create() Committed scf_tmpl_pg_reset() Committed scf_tmpl_pg_destroy() Committed scf_tmpl_get_by_pg_name() Committed scf_tmpl_get_by_pg() Committed scf_tmpl_iter_pgs() Committed scf_tmpl_prop_create() Committed scf_tmpl_prop_reset() Committed scf_tmpl_get_by_prop() Committed scf_tmpl_prop_destroy() Committed scf_tmpl_iter_props() Committed scf_tmpl_pg_name() Committed scf_tmpl_pg_type() Committed scf_tmpl_pg_required() Committed scf_tmpl_pg_common_name() Committed scf_tmpl_pg_description() Committed scf_tmpl_prop_name() Committed scf_tmpl_prop_type() Committed scf_tmpl_prop_required() Committed scf_tmpl_prop_common_name() Committed scf_tmpl_prop_description() Committed scf_tmpl_prop_units() Committed scf_tmpl_prop_visibility() Committed scf_tmpl_visibility_to_string() Committed scf_tmpl_prop_cardinality() Committed scf_tmpl_prop_internal_seps() Committed scf_tmpl_value_name_constraints() Committed scf_count_ranges_destroy() Committed scf_int_ranges_destroy() Committed scf_tmpl_value_count_range_constraints() Committed scf_tmpl_value_int_range_contraints() Committed scf_tmpl_value_name_choices() Committed scf_values_destroy() Committed scf_tmpl_value_count_range_choices() Committed scf_tmpl_value_int_range_choices() Committed scf_tmpl_value_common_name() Committed scf_tmpl_value_description() Committed scf_tmpl_value_in_constraint() Committed scf_tmpl_validate_fmri() Committed scf_tmpl_errors_destroy() Committed scf_tmpl_next_error() Committed scf_tmpl_reset_errors() Committed scf_tmpl_strerror() Committed scf_tmpl_error_type() Committed scf_tmpl_error_source_fmri() Committed scf_tmpl_error_pg_tmpl() Committed scf_tmpl_error_pg() Committed scf_tmpl_error_prop_tmpl() Committed scf_tmpl_error_prop() Committed scf_tmpl_error_value() Committed 4. References PSARC/2002/547 Greenline PSARC/2004/524 smf(5) clarifications 5. Additional Materials New manpages and diffs for existing manpages are available in the case directory under the 'materials' subdirectory. From Darren.Reed@sun.com Thu May 29 20:50:03 2008 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 m4U3o2XP003871 for <psarc-ext@sac.sfbay.sun.com>; Thu, 29 May 2008 20:50:03 -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.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m4U3ndvq008760 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Fri, 30 May 2008 04:50:01 +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 <0K1N00601XBC0400@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu, 29 May 2008 20:50:00 -0700 (PDT) Received: from sineb-mail-2.sun.com ([192.18.19.7]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1N00DZ5XBA9SC0@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu, 29 May 2008 20:49:59 -0700 (PDT) Received: from fe-apac-06.sun.com (fe-apac-06.sun.com [192.18.19.177] (may be forged)) by sineb-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m4U3okMH011677 for <psarc-ext@sun.com>; Fri, 30 May 2008 03:50:46 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0K1N00501X8B4X00@mail-apac.sun.com> (original mail from Darren.Reed@Sun.COM) for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Fri, 30 May 2008 11:48:32 +0800 (SGT) Received: from [129.146.106.55] by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0K1N009NAX8U8FR9@mail-apac.sun.com>; Fri, 30 May 2008 11:48:32 +0800 (SGT) Date: Thu, 29 May 2008 20:49:55 -0700 From: Darren Reed <Darren.Reed@sun.com> Subject: Re: 2008/350 SMF Template Extensions In-reply-to: <20080529215513.GA11082@coupe.sfbay.sun.com> Sender: Darren.Reed@sun.com To: Liane Praza <lianep@coupe.sfbay.sun.com> Cc: psarc-ext@sun.com, Thomas.Whitten@sun.com, Antonello.Cruz@sun.com, dep@eng.sun.com Message-id: <483F7963.3050006@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=us-ascii Content-transfer-encoding: 7BIT X-Accept-Language: en-au, en X-PMX-Version: 5.4.1.325704 References: <20080529215513.GA11082@coupe.sfbay.sun.com> User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.7) Gecko/20060120 Status: RO Content-Length: 542 Liane Praza wrote: >... >2.5 Manifest updates > > As part of the initial integration of the Templates project, we will > provide a set of updated manifests, including updated manifests to > describe the global and restarter generic properties. > > The svc:/system/svc/global service is newly introduced to define > SMF-wide templates and settings. > > Can you please expand on the behaviour of this service? Will a man page (or other documentation) be delivered? (There doesn't appear to be anything in the materials dir.?) Darren From liane.praza@sun.com Fri May 30 09:42:04 2008 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 m4UGg3x1029413 for <psarc-ext@sac.sfbay.sun.com>; Fri, 30 May 2008 09:42:04 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m4UGfcbg009851; Fri, 30 May 2008 17:41:58 +0100 (BST) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K1O00G03X1VVM00@nwk-avmta-1.sfbay.Sun.COM>; Fri, 30 May 2008 09:41:55 -0700 (PDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.59]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1O008TXX1VKX70@nwk-avmta-1.sfbay.Sun.COM>; Fri, 30 May 2008 09:41:55 -0700 (PDT) Received: from [129.146.228.161] (nihil.SFBay.Sun.COM [129.146.228.161]) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id m4UGft4Y196358; Fri, 30 May 2008 09:41:55 -0700 (PDT) Date: Fri, 30 May 2008 09:42:16 -0700 From: Liane Praza <liane.praza@sun.com> Subject: Re: 2008/350 SMF Template Extensions In-reply-to: <483F7963.3050006@Sun.COM> To: Darren Reed <Darren.Reed@sun.com> Cc: Liane Praza <lianep@eng.sun.com>, psarc-ext@sun.com, Thomas.Whitten@sun.com, Antonello.Cruz@sun.com, dep@eng.sun.com Message-id: <48402E68.2030907@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080529215513.GA11082@coupe.sfbay.sun.com> <483F7963.3050006@Sun.COM> User-Agent: Thunderbird 2.0.0.12 (X11/20080310) Status: RO Content-Length: 943 Darren Reed wrote: > Liane Praza wrote: > >> ... >> 2.5 Manifest updates >> >> As part of the initial integration of the Templates project, we will >> provide a set of updated manifests, including updated manifests to >> describe the global and restarter generic properties. >> >> The svc:/system/svc/global service is newly introduced to define >> SMF-wide templates and settings. >> >> > > Can you please expand on the behaviour of this service? > Will a man page (or other documentation) be delivered? > (There doesn't appear to be anything in the materials dir.?) It's mentioned in smf_template(5), which is the current subsystem which utilizes the service. It'll be a transient service. No start method is necessary for now (it's defined as :true), but of course we would reserve the ability to change that in future ARC cases if necessary/appropriate. There are no new Committed properties on the service itself. liane From Nicolas.Williams@sun.com Fri May 30 10:19:12 2008 Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m4UHJC7h001472 for <psarc-ext@sac.sfbay.sun.com>; Fri, 30 May 2008 10:19:12 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m4UHJBR6026855; Fri, 30 May 2008 10:19:11 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K1O00K0NYRZOQ00@nwk-avmta-1.sfbay.Sun.COM>; Fri, 30 May 2008 10:19:11 -0700 (PDT) Received: from binky.Central.Sun.COM ([129.153.128.104]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1O008XEYRZL3C0@nwk-avmta-1.sfbay.Sun.COM>; Fri, 30 May 2008 10:19:11 -0700 (PDT) Received: from binky.Central.Sun.COM (localhost [127.0.0.1]) by binky.Central.Sun.COM (8.14.1+Sun/8.14.1) with ESMTP id m4UHI9DE003607; Fri, 30 May 2008 12:18:34 -0500 (CDT) Received: (from nw141292@localhost) by binky.Central.Sun.COM (8.14.1+Sun/8.14.1/Submit) id m4UHHVLb003606; Fri, 30 May 2008 12:17:31 -0500 (CDT) Date: Fri, 30 May 2008 12:17:20 -0500 From: Nicolas Williams <Nicolas.Williams@sun.com> Subject: Re: 2008/350 SMF Template Extensions In-reply-to: <20080529215513.GA11082@coupe.sfbay.sun.com> To: Liane Praza <lianep@coupe.sfbay.sun.com> Cc: psarc-ext@sun.com, Thomas.Whitten@sun.com, Antonello.Cruz@sun.com, dep@eng.sun.com Mail-followup-to: Liane Praza <lianep@coupe.sfbay.sun.com>, psarc-ext@sun.com, Thomas.Whitten@sun.com, Antonello.Cruz@sun.com, dep@eng.sun.com Message-id: <20080530171720.GY2735@Sun.COM> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080529215513.GA11082@coupe.sfbay.sun.com> X-Authentication-warning: binky.Central.Sun.COM: nw141292 set sender to Nicolas.Williams@sun.com using -f User-Agent: Mutt/1.5.7i Status: RO Content-Length: 390 + import [-V] file ... + If the -V option is specified, manifests which violate + the defined templates will fail to import. In interactive + invocations of svccfg, -V is the default behaviour. So, no way to import a manifest interactively without this option? (I don't mind -- users can always use svccfg(1M) non-interactively to get beyond this.) Nico -- From liane.praza@Sun.COM Fri May 30 10:39:23 2008 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 m4UHdMRX002580 for <psarc-ext@sac.sfbay.sun.com>; Fri, 30 May 2008 10:39:22 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m4UHd3FK006477; Fri, 30 May 2008 18:39:18 +0100 (BST) 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 <0K1O0020HZPHPO00@brm-avmta-1.central.sun.com>; Fri, 30 May 2008 11:39:17 -0600 (MDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1O009PIZPGN9D0@brm-avmta-1.central.sun.com>; Fri, 30 May 2008 11:39:17 -0600 (MDT) Received: from [129.146.228.161] (nihil.SFBay.Sun.COM [129.146.228.161]) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id m4UHdFAt205862; Fri, 30 May 2008 10:39:16 -0700 (PDT) Date: Fri, 30 May 2008 10:39:37 -0700 From: Liane Praza <liane.praza@Sun.COM> Subject: Re: 2008/350 SMF Template Extensions In-reply-to: <20080530171720.GY2735@Sun.COM> To: Liane Praza <lianep@eng.sun.com>, psarc-ext@Sun.COM, Thomas.Whitten@Sun.COM, Antonello.Cruz@Sun.COM, dep@eng.sun.com Message-id: <48403BD9.7020508@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080529215513.GA11082@coupe.sfbay.sun.com> <20080530171720.GY2735@Sun.COM> User-Agent: Thunderbird 2.0.0.12 (X11/20080310) Status: RO Content-Length: 448 Nicolas Williams wrote: > + import [-V] file > ... > + If the -V option is specified, manifests which violate > + the defined templates will fail to import. In interactive > + invocations of svccfg, -V is the default behaviour. > > So, no way to import a manifest interactively without this option? > > (I don't mind -- users can always use svccfg(1M) non-interactively to > get beyond this.) That's correct. liane From Darren.Reed@sun.com Fri May 30 14:42:01 2008 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 m4ULg0VW016833 for <psarc-ext@sac.sfbay.Sun.COM>; Fri, 30 May 2008 14:42:00 -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 m4ULfpC0023599 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Sat, 31 May 2008 05:41:59 +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 <0K1P00601AXXWB00@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Fri, 30 May 2008 14:41:57 -0700 (PDT) Received: from sineb-mail-2.sun.com ([192.18.19.7]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1P00K8IAXWV2C0@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Fri, 30 May 2008 14:41:57 -0700 (PDT) Received: from fe-apac-05.sun.com (fe-apac-05.sun.com [192.18.19.176] (may be forged)) by sineb-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m4ULghm6023980 for <psarc-ext@sun.com>; Fri, 30 May 2008 21:42:43 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0K1P00401AUHXH00@mail-apac.sun.com> (original mail from Darren.Reed@Sun.COM) for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Sat, 31 May 2008 05:41:36 +0800 (SGT) Received: from [129.146.106.55] by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0K1P00MG2AXA9U7Q@mail-apac.sun.com>; Sat, 31 May 2008 05:41:36 +0800 (SGT) Date: Fri, 30 May 2008 14:41:52 -0700 From: Darren Reed <Darren.Reed@sun.com> Subject: Re: 2008/350 SMF Template Extensions In-reply-to: <48402E68.2030907@sun.com> Sender: Darren.Reed@sun.com To: Liane Praza <Liane.Praza@sun.com> Cc: Liane Praza <lianep@eng.sun.com>, psarc-ext@sun.com, Thomas.Whitten@sun.com, Antonello.Cruz@sun.com, dep@eng.sun.com Message-id: <484074A0.9080108@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-Accept-Language: en-au, en X-PMX-Version: 5.4.1.325704 References: <20080529215513.GA11082@coupe.sfbay.sun.com> <483F7963.3050006@Sun.COM> <48402E68.2030907@sun.com> User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.7) Gecko/20060120 Status: RO Content-Length: 996 Liane Praza wrote: > Darren Reed wrote: > >> Liane Praza wrote: >> >>> ... >>> 2.5 Manifest updates >>> >>> As part of the initial integration of the Templates project, we will >>> provide a set of updated manifests, including updated manifests to >>> describe the global and restarter generic properties. >>> >>> The svc:/system/svc/global service is newly introduced to define >>> SMF-wide templates and settings. >>> >>> >> >> Can you please expand on the behaviour of this service? >> Will a man page (or other documentation) be delivered? >> (There doesn't appear to be anything in the materials dir.?) > > > It's mentioned in smf_template(5), which is the current subsystem > which utilizes the service. > Hmmm... If a property is now defined first in a template and has previously been defined in a service, is it now necessary to use "override='true'"? And/or are there any consequences/requirements of using this attribute now that templates may be imported earlier? Darren From liane.praza@sun.com Fri May 30 14:54:22 2008 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 m4ULsLRB017763 for <psarc-ext@sac.sfbay.Sun.COM>; Fri, 30 May 2008 14:54:22 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m4ULsGu9027998; Sat, 31 May 2008 05:54:17 +0800 (SGT) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K1P00403BIGDR00@nwk-avmta-1.sfbay.Sun.COM>; Fri, 30 May 2008 14:54:16 -0700 (PDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.59]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1P00IO7BIFLQE0@nwk-avmta-1.sfbay.Sun.COM>; Fri, 30 May 2008 14:54:15 -0700 (PDT) Received: from [129.146.228.161] (nihil.SFBay.Sun.COM [129.146.228.161]) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id m4ULsF9L245478; Fri, 30 May 2008 14:54:15 -0700 (PDT) Date: Fri, 30 May 2008 14:54:40 -0700 From: Liane Praza <liane.praza@sun.com> Subject: Re: 2008/350 SMF Template Extensions In-reply-to: <484074A0.9080108@Sun.COM> To: Darren Reed <Darren.Reed@sun.com> Cc: Liane Praza <lianep@eng.sun.com>, psarc-ext@sun.com, Thomas.Whitten@sun.com, Antonello.Cruz@sun.com, dep@eng.sun.com Message-id: <484077A0.9000909@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080529215513.GA11082@coupe.sfbay.sun.com> <483F7963.3050006@Sun.COM> <48402E68.2030907@sun.com> <484074A0.9080108@Sun.COM> User-Agent: Thunderbird 2.0.0.12 (X11/20080310) Status: RO Content-Length: 1258 Darren Reed wrote: > Liane Praza wrote: > >> Darren Reed wrote: >> >>> Liane Praza wrote: >>> >>>> ... >>>> 2.5 Manifest updates >>>> >>>> As part of the initial integration of the Templates project, we will >>>> provide a set of updated manifests, including updated manifests to >>>> describe the global and restarter generic properties. >>>> >>>> The svc:/system/svc/global service is newly introduced to define >>>> SMF-wide templates and settings. >>>> >>>> >>> >>> Can you please expand on the behaviour of this service? >>> Will a man page (or other documentation) be delivered? >>> (There doesn't appear to be anything in the materials dir.?) >> >> >> It's mentioned in smf_template(5), which is the current subsystem >> which utilizes the service. >> > > Hmmm... > > If a property is now defined first in a template and has previously > been defined in a service, is it now necessary to use "override='true'"? > And/or are there any consequences/requirements of using this attribute > now that templates may be imported earlier? Sorry, I'm not sure I understand your question. Templates are metadata about configuration. Metadata has no impact on whether a property is defined on a service, it only may describe that property. liane From Darren.Reed@sun.com Fri May 30 15:42:12 2008 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 m4UMgBhj020305 for <psarc-ext@sac.sfbay.sun.com>; Fri, 30 May 2008 15:42:12 -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.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m4UMg8Qr002919 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Fri, 30 May 2008 23:42:11 +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 <0K1P00909DQ8RL00@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@Sun.COM); Fri, 30 May 2008 15:42:08 -0700 (PDT) Received: from sineb-mail-1.sun.com ([192.18.19.6]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1P008XTDQ74A30@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@Sun.COM); Fri, 30 May 2008 15:42:08 -0700 (PDT) Received: from fe-apac-06.sun.com (fe-apac-06.sun.com [192.18.19.177] (may be forged)) by sineb-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m4UMgRHo021589 for <psarc-ext@Sun.COM>; Fri, 30 May 2008 22:42:27 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0K1P00901DESQR00@mail-apac.sun.com> (original mail from Darren.Reed@Sun.COM) for psarc-ext@Sun.COM (ORCPT psarc-ext@Sun.COM); Sat, 31 May 2008 06:40:39 +0800 (SGT) Received: from [129.146.106.55] by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0K1P0099LDNP8AU6@mail-apac.sun.com>; Sat, 31 May 2008 06:40:39 +0800 (SGT) Date: Fri, 30 May 2008 15:42:04 -0700 From: Darren Reed <Darren.Reed@sun.com> Subject: Re: 2008/350 SMF Template Extensions In-reply-to: <484077A0.9000909@sun.com> Sender: Darren.Reed@sun.com To: Liane Praza <Liane.Praza@sun.com> Cc: Liane Praza <lianep@eng.sun.com>, PSARC-ext@sun.com, Thomas.Whitten@sun.com, Antonello.Cruz@sun.com, dep@eng.sun.com Message-id: <484082BC.5060505@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-Accept-Language: en-au, en X-PMX-Version: 5.4.1.325704 References: <20080529215513.GA11082@coupe.sfbay.sun.com> <483F7963.3050006@Sun.COM> <48402E68.2030907@sun.com> <484074A0.9080108@Sun.COM> <484077A0.9000909@sun.com> User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.7) Gecko/20060120 Status: RO Content-Length: 1464 Liane Praza wrote: > Darren Reed wrote: > >> Liane Praza wrote: >> >>> Darren Reed wrote: >>> >>>> Liane Praza wrote: >>>> >>>>> ... >>>>> 2.5 Manifest updates >>>>> >>>>> As part of the initial integration of the Templates project, we will >>>>> provide a set of updated manifests, including updated manifests to >>>>> describe the global and restarter generic properties. >>>>> >>>>> The svc:/system/svc/global service is newly introduced to define >>>>> SMF-wide templates and settings. >>>>> >>>>> >>>> >>>> Can you please expand on the behaviour of this service? >>>> Will a man page (or other documentation) be delivered? >>>> (There doesn't appear to be anything in the materials dir.?) >>> >>> >>> >>> It's mentioned in smf_template(5), which is the current subsystem >>> which utilizes the service. >>> >> >> Hmmm... >> >> If a property is now defined first in a template and has previously >> been defined in a service, is it now necessary to use "override='true'"? >> And/or are there any consequences/requirements of using this attribute >> now that templates may be imported earlier? > > > Sorry, I'm not sure I understand your question. > > Templates are metadata about configuration. Metadata has no impact on > whether a property is defined on a service, it only may describe that > property. Ah, ok. Because they are using the same XML schema, I had the impression they could contain data too. Thanks for clearing that up. Darren From liane.praza@sun.com Wed Jun 4 11:09:55 2008 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m54I9tnt007740 for <psarc-ext@sac.sfbay.sun.com>; Wed, 4 Jun 2008 11:09:55 -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 m54I9tNl012359 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Wed, 4 Jun 2008 11:09:55 -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 <0K1Y0060DAGIUU00@brm-avmta-1.central.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Wed, 04 Jun 2008 12:09:54 -0600 (MDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.59]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K1Y001M1AGIR550@brm-avmta-1.central.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Wed, 04 Jun 2008 12:09:54 -0600 (MDT) Received: from [129.146.228.161] (nihil.SFBay.Sun.COM [129.146.228.161]) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id m54I9siD448926 for <psarc-ext@sun.com>; Wed, 04 Jun 2008 11:09:54 -0700 (PDT) Date: Wed, 04 Jun 2008 11:10:19 -0700 From: Liane Praza <liane.praza@sun.com> Subject: 2008/350 SMF Template Extensions To: psarc-ext@sun.com Message-id: <4846DA8B.30204@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.12 (X11/20080310) Status: RO Content-Length: 57 This case was approved during ARC business today. liane From liane.praza@sun.com Thu Oct 9 18:08:22 2008 Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m9A18MxB029651 for <psarc-ext@sac.sfbay.sun.com>; Thu, 9 Oct 2008 18:08:22 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m9A18KDs011206 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Thu, 9 Oct 2008 18:08:22 -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 <0K8I00B010HXOM00@brm-avmta-1.central.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu, 09 Oct 2008 19:08:21 -0600 (MDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K8I00GGD0HX7KB0@brm-avmta-1.central.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu, 09 Oct 2008 19:08:21 -0600 (MDT) Received: from [129.146.228.161] (nihil.SFBay.Sun.COM [129.146.228.161]) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id m9A183F8894222 for <psarc-ext@sun.com>; Thu, 09 Oct 2008 18:08:09 -0700 (PDT) Date: Thu, 09 Oct 2008 18:09:08 -0700 From: Liane Praza <liane.praza@sun.com> Subject: 2008/350 SMF Template Extensions To: psarc-ext@sun.com Message-id: <48EEAB34.4030707@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.16 (X11/20080825) Status: RO Content-Length: 952 This work has not integrated into ON yet. During the course of testing and review, we discovered a small number of changes that were appropriate for this case. The extent of the changes made are: - introducing the scf_tmpl_pg_target() function as Committed, - making a few minor naming changes to the Private templates repository representation, and - making some minor changes to error codes for the libscf interfaces. I expect these changes do not require a new case, as the function is in-line with other similar functions already introduced by this case, and the other changes are reasonably minor. If this case needs to be re-opened due to these changes, or I need to file a separate fasttrack, please let me know. I've deposited new case materials in the case directory under materials-final. The manpages show non-trivial differences against the original files as clarifications were also made due to review comments. liane