iSCSI Initiator SMF Service [PSARC/2009/011 FastTrack timeout 01/15/2009]

[Mark Carlson]

I am sponsoring this case for Jack Meng. It requests minor binding and 
times out on 01/15/2009.

-- mark

Template Version: @(#)sac_nextcase %I% %G% SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 iSCSI Initiator SMF Service
    1.2. Name of Document Author/Supplier:
	 Author:  Jack Meng
    1.3  Date of This Document:
	08 January, 2009

2. Project Summary
   2.1. Project Description
        This project makes the existing iSCSI initiator feature in Solaris
	a standard SMF service.
    
4. Technical Description
    4.1. Details:
	Currently iSCSI initiator feature does not exist as an SMF service
	in Solaris. The existing service
	svc:/network/iscsi_initiator:default
	only represents the name resolutions service for the iSCSI kernel module.
	This is always confusing since the enable/disable of that service doesn't
	affect the behavior of iSCSI initiator.

        iSCSI module starts the kernel daemon in its attach routine, which is a
	behavior blind of the status of the OS and causing defects/limitation
	that can not be fixed win thin present architecture, few examples are listed
	below:

	1. 'Unable to login to xxxxxxxxxxx' during system startup
	2. Inconsistent connections may happen after system rebooted as the login
	   failed during startup
	3. Unable to add customized dependency for special usage, e.g., iSCSI disk
	   is used as shared device in cluster, so iSCSI initiator should try to login
	   after iSCSI target online. 
	
	This project provides a new service, named
	svc:/network/iscsi/initiator:default to replace the existing service. the new
	service will provide following benefits,

	1. Users are able to explicitly enable/disable iSCSI initiator feature in Solaris.
	2. Avoid the blindly starting up by specifying dependencies.
	3. iSCSI initiator will be more flexible to serve special requirements.

	The existing functionality in svc:/network/iscsi_initiator:default will be
	inherited.

    4.5 Interfaces:

    Exported Interface                    | Stability    |    Description
    --------------------------------------|--------------|-------------------
    svc:/network/iscsi/initiator:default  | Committed    | iSCSI initiator service,
                                          |              | renamed from iscsi_initiator:default
                                          |              | with new functions

    Imported Interface                    | Stability    |    Description
    --------------------------------------|--------------|-------------------
    usr/share/man/man7d/iscsi.7d          | Committed    | manpage of iSCSI initiator
    usr/share/man/man1m/iscsiadm.1m       | Committed    | manpage of iSCSI initiator CLI
    usr/sbin/iscsiadm                     | Committed    | iSCSI initiator CLI

    Removed Interface                     | Stability    |    Description
    --------------------------------------|--------------|-------------------
    svc:/network/iscsi_initiator:default  | Committed    | service for iSCSI name resolution

    Other documents:
    System  Administration  Guide:  Devices  and  File  Systems,
    Chapter 14
	 

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