From sacadmin Tue May 13 13:44:02 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 m4DKi24P005664;
	Tue, 13 May 2008 13:44:02 -0700 (PDT)
Received: (from rm129958@localhost)
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m4DKi2m5005660;
	Tue, 13 May 2008 13:44:02 -0700 (PDT)
Date: Tue, 13 May 2008 13:44:02 -0700 (PDT)
From: Richard Jr Matthews <rm129958@sac.sfbay.sun.com>
Message-Id: <200805132044.m4DKi2m5005660@sac.sfbay.sun.com>
To: PSARC-record@sac.sfbay.sun.com
Cc: samqfs-psarc-interest@sun.COM
Subject: SAM-QFS 5.0 Host on/off [PSARC/2008/319 FastTrack timeout 05/21/2008]
Status: RO
Content-Length: 562


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:
	 SAM-QFS 5.0 Host on/off
    1.2. Name of Document Author/Supplier:
	 Author:  Brad Blasing
    1.3  Date of This Document:
	13 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:
		unbundled
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open


From sacadmin Tue May 13 13:57:25 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 m4DKvPNh006146
	for <psarc@sac.eng.sun.com>; Tue, 13 May 2008 13:57:25 -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 m4DKvOEx001925
	for <@sunmail2sca.sfbay.sun.com:PSARC@sun.com>; Tue, 13 May 2008 13:57:25 -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 <0K0T00F0ZRJO2300@nwk-avmta-1.sfbay.Sun.COM> for PSARC@sun.com
 (ORCPT PSARC@sun.com); Tue, 13 May 2008 13:57:24 -0700 (PDT)
Received: from brmea-mail-3.sun.com ([192.18.98.34])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K0T006KZRJKUX50@nwk-avmta-1.sfbay.Sun.COM> for PSARC@sun.com
 (ORCPT PSARC@sun.com); Tue, 13 May 2008 13:57:20 -0700 (PDT)
Received: from fe-amer-09.sun.com ([192.18.109.79])
	by brmea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m4DKvKDF002700	for
 <PSARC@sun.com>; Tue, 13 May 2008 20:57:20 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0K0T00401QQTDA00@mail-amer.sun.com>
 (original mail from Richard.Matthews@Sun.COM)
 for PSARC@sun.com (ORCPT PSARC@sun.com); Tue, 13 May 2008 14:57:20 -0600 (MDT)
Received: from [129.152.9.14] by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K0T00966RJ6RO20@mail-amer.sun.com> for PSARC@sun.com
 (ORCPT PSARC@sun.com); Tue, 13 May 2008 14:57:06 -0600 (MDT)
Date: Tue, 13 May 2008 15:57:06 -0500
From: Rick Matthews <Richard.Matthews@sun.com>
Subject: PSARC/2008/319 - SAM-QFS 5.0 Host on/off [FastTrack timeout 05/21/2009]
Sender: Richard.Matthews@sun.com
To: PSARC@sun.com
Reply-to: Richard.Matthews@sun.com
Message-id: <482A00A2.8020601@Sun.COM>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
User-Agent: Thunderbird 2.0.0.6 (X11/20070802)
Status: RO
Content-Length: 8226

I am sponsoring the attached fast track for Brad Blasing. Release 
binding is minor.

--

Template Version: @(#)onepager.txt 1.35 07/11/07 SMI
Copyright 2007 Sun Microsystems

1. Introduction
   1.1. Project/Component Working Name:
        SAM-QFS Host On/Off

   1.2. Name of Document Author/Supplier:
        Brad.Blasing@sun.com

   1.3. Date of This Document:
        03/10/2008

        1.3.1. Date this project was conceived:
                08/07/2007

   1.4. Name of Major Document Customer(s)/Consumer(s):
        1.4.1. The PAC or CPT you expect to review your project:
                NWS PAC
        1.4.2. The ARC(s) you expect to review your project:
                PSARC
        1.4.3. The Director/VP who is "Sponsoring" this project:
                Karen.Jourdenais@sun.com
        1.4.4. The name of your business unit:
                SDASH

   1.5. Email Aliases:
        1.5.1. Responsible Manager:
                Ted.Pogue@sun.com
        1.5.2. Responsible Engineer:
                Brad.Blasing@sun.com
        1.5.3. Marketing Manager:
                Margaret.Hamburger@sun.com
        1.5.4. Interest List:
                samqfs-psarc-interest@sun.com

2. Project Summary
   2.1. Project Description:

        See supplied functional specification document 
"hostonoff.6479428.txt"
        section "FEATURE DESCRIPTION".

   2.2. Risks and Assumptions:
        None.

3. Business Summary

   3.1. Problem Area:
        Customers require the ability to dynamically remove a shared QFS 
node.

   3.2. Market/Requester:
        The SAM-QFS HPC initiative.

   3.3. Business Justification:
        The SAM-QFS HPC initiative requires the ability to dynamically 
remove
        a shared QFS node.

   3.4. Competitive Analysis:
        The SAM-QFS HPC initiative requires the ability to dynamically 
remove
        a shared QFS node.

   3.5. Opportunity Window/Exposure:
        FY 2009

   3.6. How will you know when you are done?:
        When an administrator can dynamically remove a shared QFS node
        successfully.

4. Technical Description:
    4.1. Details:

        See supplied functional specification document 
"hostonoff.6479428.txt"
        section "FUNCTIONAL REQUIREMENTS".

    4.2. Bug/RFE Number(s):

        6479428: RFE: Functionality needed for Dynamic removal of a
                 Shared QFS node

        This RFE is currently targeted for the next release of SAM-QFS 
(FY09).
        All documentation references to release "x.x" should be interpreted
        as that release.

    4.3. In Scope:

        See supplied functional specification document 
"hostonoff.6479428.txt"
        section "SCOPE OF THE PROJECT".

    4.4. Out of Scope:

        See supplied functional specification document 
"hostonoff.6479428.txt"
        section "SCOPE OF THE PROJECT".

    4.5. Interfaces:
        See supplied functional specification document 
"hostonoff.6479428.txt"
        section "FUNCTIONAL REQUIREMENTS".

    4.6. Doc Impact:
        Update the SAM-QFS administration guide to describe the ability to,
        and rationale for being able to, configure a host on/off.

    4.7. Admin/Config Impact:
        An administrator will be able to change the on/off state of a host.

    4.8. HA Impact:
        Increases reliability by supporting the ability to change the state
        of a problematic host to "off."

        Increases availability by being able to dynamically manage a 
host and
        its associated storage.

    4.9. I18N/L10N Impact:
        Messages related to host configuration need to be investigated.

    4.10. Packaging & Delivery:
        No impact.

    4.11. Security Impact:
        None.

    4.12. Dependencies:
        This feature requires that voluntary and involuntary failover be
        reliable prior to release.

5. Reference Documents:
        See supplied functional specification document 
"hostonoff.6479428.txt".
        Also reference the full SAM-QFS 5.0 PSARC case 2007/588 at:
                http://sac.eng/arc/PSARC/2007/588

6. Resources and Schedule:
   6.1. Projected Availability:
        Available with the first release of the SAM-QFS HPC product.

   6.2. Cost of Effort:
        Unspecified.

   6.3. Cost of Capital Resources:
        Unspecified.

   6.4. Product Approval Committee requested information:
        6.4.1. Consolidation or Component Name:
                Available with the first release of the SAM-QFS HPC product.
        6.4.3. Type of CPT Review and Approval expected:
                FastTrack
        6.4.4. Project Boundary Conditions:
                Unknown.
        6.4.5. Is this a necessary project for OEM agreements:
                No.
        6.4.6. Notes:
                Intentionally left blank.
        6.4.7. Target RTI Date/Release:
                RTI in time for the first release of the SAM-QFS HPC 
product.
        6.4.8. Target Code Design Review Date:
                Review in time for the first release of the SAM-QFS HPC 
product.
        6.4.9. Update approval addition:
                No.

   6.5. ARC review type:
                FastTrack
   6.6. ARC Exposure:
                open
       6.6.1. Rationale:
                N/A

7. Prototype Availability:
   7.1. Prototype Availability:
        Q4 2008

   7.2. Prototype Cost:
        Unspecified.

----
        SAM-QFS x.x Planning - Functional Specification Document
        ========================================================
                        Updated: 03/27/2008


FEATURE DESCRIPTION:
-------------------

Add  the ability to mark a SAM-QFS client on or off in the QFS
file system client host table.  Clients that are marked as off
will only be able to unmount QFS file systems.  The purpose of
this feature is to enable the removal of a client from the HPC
SAM-QFS environment for repair or reconfiguration from a
central administrative point (the metadata server).

6479428: RFE: Functionality needed for Dynamic removal of a Shared QFS node


SCOPE OF THE PROJECT:
--------------------

- Update commands and daemons that process the client host table.
- Modify the in-core client host table.
- Modify the samfs module so that it knows about and correctly handles
  the on/off state in the in-core client host table.
- Make the metadata server (MDS) allow only unmount-related messages
  from a client that has been marked "off."
- Make the MDS attempt to inform the client that has been marked "off"
  of this change if the client still has the file system mounted.
- Make the client that has been marked down attempt to unmount the
  file systems from that MDS that marked it down.

All other aspects of client host table management are outside the scope
of this feature.


FUNCTIONAL REQUIREMENTS:
-----------------------

A configuration file exists already per file system.  This file
contains a line per host and describes several parameters per
client host.  This file is in /etc/opt/SUNWsamfs/hosts.{fsname}.
Changes to this file are made effective by issuing the
"samsharefs" administrative command.  This existing interface
will be used to add an on/off flag per client host.  The 4th
column in this file is currently unused and will be used to
indicate host on/off status.

The host file is kept in memory once read via the samsharefs
command.  This host table will also have to change to accomodate
a new on/off flag per client.

The default status for a client will be "on".  If a client is
changed to "off" status, the following actions will be taken.
The metadata server (MDS) will accept no further commands from
that client other than "unmount".  The client will attempt to
flush and unmount all file systems from that metadata server.

Interfaces:

No interfaces are introduced or deleted by this proposal.  The
existing /etc/opt/SUNWsamfs/hosts.{fsname} configuration file
is modified to add the client on/off field.  The existing
samsharefs command will reread this file after changes.  This
interface is public/volatile.


DELIVERABLES:
------------

- Restructure the in core and on disk host tables.

FUNCTIONAL DEPENDENCIES:
-----------------------

This requires that voluntary and involuntary failover be reliable prior to
integration of this feature.


From sacadmin Wed May 21 16:55:59 2008
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m4LNtxCA004656
	for <psarc@sac.eng.sun.com>; Wed, 21 May 2008 16:55:59 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m4LNtwn9026398
	for <@sunmail2sca.sfbay.sun.com:PSARC@sun.com>; Wed, 21 May 2008 17:55:58 -0600 (MDT)
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 <0K1800701T5AYJ00@brm-avmta-1.central.sun.com> for PSARC@sun.com
 (ORCPT PSARC@sun.com); Wed, 21 May 2008 17:55:58 -0600 (MDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K1800CEVT55RTF0@brm-avmta-1.central.sun.com> for PSARC@sun.com
 (ORCPT PSARC@sun.com); Wed, 21 May 2008 17:55:53 -0600 (MDT)
Received: from fe-amer-10.sun.com ([192.18.109.80])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m4LNtrD3001278	for
 <PSARC@sun.com>; Wed, 21 May 2008 23:55:53 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0K1800301T3VAE00@mail-amer.sun.com>
 (original mail from Richard.Matthews@Sun.COM)
 for PSARC@sun.com (ORCPT PSARC@sun.com); Wed, 21 May 2008 17:55:53 -0600 (MDT)
Received: from [129.152.9.14] by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K1800N02T540UA0@mail-amer.sun.com> for PSARC@sun.com
 (ORCPT PSARC@sun.com); Wed, 21 May 2008 17:55:53 -0600 (MDT)
Date: Wed, 21 May 2008 18:55:52 -0500
From: Rick Matthews <Richard.Matthews@sun.com>
Subject: PSARC/2008/319 - SAM-QFS 5.0 Host on/off
Sender: Richard.Matthews@sun.com
To: PSARC@sun.com
Reply-to: Richard.Matthews@sun.com
Message-id: <4834B688.2050806@Sun.COM>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
User-Agent: Thunderbird 2.0.0.6 (X11/20070802)
Status: RO
Content-Length: 522

This case was approved during today's PSARC meeting.

-- 
---------------------------------------------------------------------
Rick Matthews                           email: Rick.Matthews@sun.com
Sun Microsystems, Inc.                  phone:+1(651) 554-1518
1270 Eagan Industrial Road              phone(internal): 54418
Suite 160                               fax:  +1(651) 554-1540
Eagan, MN 55121-1231 USA                main: +1(651) 554-1500		
---------------------------------------------------------------------


