From sacadmin Fri Jul 18 15:05:05 2008
Received: from sac.sfbay.sun.com (localhost [127.0.0.1])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m6IM54cp004665;
	Fri, 18 Jul 2008 15:05:04 -0700 (PDT)
Received: (from cindi@localhost)
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m6IM54Gr004661;
	Fri, 18 Jul 2008 15:05:04 -0700 (PDT)
Date: Fri, 18 Jul 2008 15:05:04 -0700 (PDT)
From: Cynthia McGuire <cindi@sac.sfbay.sun.com>
Message-Id: <200807182205.m6IM54Gr004661@sac.sfbay.sun.com>
To: PSARC-record@sac.sfbay.sun.com
Cc: robert.johnston@sun.com
Subject: Extending HC FMRI scheme to represent sensors/indicators [PSARC/2008/463 Self Review]
Status: RO
Content-Length: 2663


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:
	 Extending HC FMRI scheme to represent sensors/indicators
    1.2. Name of Document Author/Supplier:
	 Author:  Robert Johnston
    1.3  Date of This Document:
	18 July, 2008
4. Technical Description

This case updates PSARC/2002/412 to include the following additions to the
hardware component (hc) FMRI scheme:

The existing hc FMRI scheme allows for a heirarchial representation of hardware
resources, according to their physical connection properties.  However, this
is not a very useful way to represent sensors and indicators in the topology
because it does not allow for consumers to programmatically determine the
association of sensors/indicators to the hardware resource that they're
monitoring.

Therefore this case seeks to extend the hc FMRI scheme to allow for this
association to be represented using a new type of node in the topology: a
facility node.

A facility node is a special leaf node in the hc-scheme topology that
represents either a sensor or an indicator.  A fault managed resource may have
one or more child facility nodes that represent sensors or indicators that are
associated with it.  The hc-scheme will be extended as shown below to
allow for an addition facility node member:

Name         Data Type         Description
----         ---------       -----------
scheme       string          scheme used for FMRI
version      uint32          version of scheme specification
authority    nvlist          optional authority of FMRI
payload                      resource path
facility     nvlist          facility component of FMRI

The facility nvlist will have two members:

Name           Data Type     Description
----           ---------     -----------
facility-type  string        type of facility: "sensor" or "indicator"
facility-name  string        name of the facility

The string representation of an hc scheme FMRI will also be extended, as
shown below:

 <scheme>://[authority]/<resource-path>[?<fac-type>=<fac-name>]

  where fac-type can be either "sensor" or "indicator" and fac-name is the
  name of the facility.

for example:


hc://:product-id=Sun-Fire-X4500:chassis-id=00-14-4F-20-E4-B0:server-id=lollipop/chassis=0/fanmodule=0/fan=0?sensor=speed

hc://:product-id=Sun-Fire-X4500:chassis-id=00-14-4F-20-E4-B0:server-id=lollipop/chassis=0/bay=47?indicator=ok2rm

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		ON
    6.5. ARC review type: Automatic
    6.6. ARC Exposure: open


