1. Introduction 1.1. Project/Component Working Name: Virtual Domain Service MD nodes and misc. properties 1.2. Name of Document Author/Supplier: Michael Christensen 1.3. Date of This Document: 09/03/2008 1.4. Name of Major Document Customer(s)/Consumer(s): 1.4.1. The PAC or CPT you expect to review your project: HS PAC 1.4.2. The ARC(s) you expect to review your project: FWARC 1.4.3. The Director/VP who is "Sponsoring" this project: Jerri-Ann Meyer 1.4.4. The name of your business unit: Software 1.5. Email Aliases: 1.5.1. Responsible Manager: Jay.Jayachandra@sun.com 1.5.2. Responsible Engineer: Michael.Christensen@sun.com 1.5.3. Marketing Manager: Trefor.Jones@sun.com 1.5.4. Interest List: ldoms-internal@sun.com 2. Project Summary 2.1. Project Description: This case is an extension of FWARC/2005/633 "LDoms: Project Q Logical Domaining Umbrella (sun4v/hypervisor/LDoms)" that is required to support User Domain Service (RFE 6689118). This case describes misc additions to the machine description data for Logical Domains (LDoms). It proposes that a new virtual-device class be created called "virtual-domain-service" under the "virtual-devices" node. Additional miscellaneous properties for the virtual-device and virtual-device-port are also defined by this case. 2.2. Risks and Assumptions: See FWARC/2005/633 3. Business Summary 3.1. Problem Area: See FWARC/2005/633 3.2. Market/Requester: See FWARC/2005/633 3.3. Business Justification: See FWARC/2005/633 3.4. Competitive Analysis: See FWARC/2005/633 3.5. Opportunity Window/Exposure: See FWARC/2005/633 3.6. How will you know when you are done?: See FWARC/2005/633 4. Technical Description: 4.1 Overview 4.1.1 Virtual Domain Service nodes Following nodes will be added to Machine Description to represent Virtual Domain Service ports. Virtual Device node ------------------- New Properties: Name Tag Req'd? Description -------------------------------------------------------------------- vlds-domain-handle PROP_VAL No A 64-bit unsigned integer uniquely identifying the domain containing the virtual-domain-service device. Virtual Domain Service node ---------------------------- Name: virtual-domain-service Category: optionally required by virtual-devices Required subordinates: - Optional subordinates: vlds-port Description: This node node represents an instance of a domain service connection. The virtual-domain-service node will have zero or more vlds-port nodes. Virtual Domain Service port node --------------------------------- Name: vlds-port Category: optionally required by virtual-domain-service Required subordinates: - Optional subordinates: channel-endpoint Description: This node uniquely represents an instance of a virtual domain service port. The virtual-domain-service node will have zero or more vlds-port nodes. Properties: Name Tag Req'd? Description ----------------------------------------------------------- id PROP_VAL Yes A 64-bit unsigned integer uniquely identifying this domain service port within the domain-service node. vlds-remote-domain- PROP_VAL No A 64-bit unsigned integer handle uniquely identifying the domain to which a vlds-port is associated. 4.1.2 Miscellaneous Virtual Device node properties Additional properties added to virtual-device nodes as described below. Name Tag Req'd? Description ----------------------------------------------------------- vcc-min-tcp-port PROP_VAL No A 64-bit unsigned integer identifying the smallest TCP port assignable to a console group in a SUNW,sun4v-console- concentrator device. vcc-max-tcp-port PROP_VAL No A 64-bit unsigned integer identifying the largest TCP port assignable to a console group in a SUNW,sun4v-console- concentrator device. 4.1.3 Miscellaneous Virtual Device Port node properties Additional properties added to virtual-device-port nodes as described below. Name Tag Req'd? Description ----------------------------------------------------------- vds-block-device-name PROP_STR No A string name identifying the canonical name assigned to the block device used by a port in SUNW,sun4v-disk-server device. vds-mpgroup-name PROP_STR No A string name identifying the multi-path group a port belongs to in a SUNW,sun4v-disk-server device. 4.2 Imported Interfaces : Interface Classification Comments ==================================================================== sun4v Machine Sun Private MD nodes definitions as Description nodes defined by FWARC/2005/633 sun4v virtual devices Sun Private MD nodes definitions as machine description defined by FWARC/2006/072 data 4.3 Exported Interfaces: Interface Classification Comments ==================================================================== virtual domain service Sun Private MD nodes describing virtual nodes in MD domain service ports vcc-min-tcp-port Sun Private A MD virtual-device node property to define the smallest TCP port assignable to a console group. vcc-max-tcp-port Sun Private A MD virtual-device node property to define the largest TCP port assignable to a console group. vds-block-device-name Sun Private A MD virtual-device-port node property to assign a canonical name to th block device used by a port in SUNW,sun4v-disk-server device. vds-mpgroup-name Sun Private A MD virtual-device-port node property to identify the multi-path group a port belongs to in a SUNW,sun4v-disk-server device. 5. Reference Documents: None 6. Resources and Schedule: 6.1. Projected Availability: See FWARC/2005/633 6.2. Cost of Effort: See FWARC/2005/633 6.3. Cost of Capital Resources: Capital resources are subsumed as part of overall product development. 6.4. Product Approval Committee requested information: 6.4.1. Consolidation Name: Delivery of firmware will be platform teams Delivery of sun4v OS will be platform teams (ON) 6.4.2. Contributing OpCo/BU/Division Name: Software 6.4.3. Type of PAC Review and Approval expected: Fast-track 6.4.4. Project Boundary Conditions: N/A 6.4.5. Is this a necessary project for OEM agreements: No. 6.4.6. Notes/Dependencies: SUN SPARC CPU specification 6.4.7. Target RTI Date/Release: N/A - Not a separate deliverable. 6.4.8. Target Code Design Review Date: Q3CY08 6.4.9. Update approval addition: N/A 6.5. ARC review type: Fast-track 7. Prototype Availability: 7.1. Prototype Availability: Q3CY08 7.2. Prototype Cost: Done using existing resources.