home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / iscsiprj.zip / draft-ietf-ips-iscsi-slp-03.txt < prev    next >
Text File  |  2002-06-02  |  41KB  |  1,179 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Internet Draft                                                Mark Bakke
  8. <draft-ietf-ips-iscsi-slp-03.txt>                                  Cisco
  9. Expires September 2002
  10.                                                                 Joe Czap
  11.                                                               Jim Hafner
  12.                                                             John Hufferd
  13.                                                       Kaladhar Voruganti
  14.                                                                      IBM
  15.                                                              Howard Hall
  16.                                                                    Pirus
  17.                                                             Jack Harwood
  18.                                                                      EMC
  19.                                                              Yaron Klein
  20.                                                                   Sanrad
  21.                                                         Marjorie Krueger
  22.                                                                       HP
  23.                                                          Lawrence Lamers
  24.                                                       San Valley Systems
  25.                                                              Todd Sperry
  26.                                                                  Adaptec
  27.                                                             Joshua Tseng
  28.                                                                   Nishan
  29.  
  30.                                                               March 2002
  31.  
  32.  
  33.             Finding iSCSI Targets and Name Servers Using SLP
  34.  
  35.  
  36.  
  37. Status of this Memo
  38.  
  39.    This document is an Internet-Draft and is in full conformance with
  40.    all provisions of Section 10 of RFC2026.
  41.  
  42.    Internet-Drafts are working documents of the Internet Engineering
  43.    Task Force (IETF), its areas, and its working groups.  Note that
  44.    other groups may also distribute working documents as Internet-
  45.    Drafts.
  46.  
  47.    Internet-Drafts are draft documents valid for a maximum of six months
  48.    and may be updated, replaced, or obsoleted by other documents at any
  49.    time.  It is inappropriate to use Internet- Drafts as reference
  50.    material or to cite them other than as "work in progress."
  51.  
  52.    The list of current Internet-Drafts can be accessed at
  53.    http://www.ietf.org/ietf/1id-abstracts.txt
  54.  
  55.  
  56.  
  57.  
  58. Bakke                    Expires September 2002                 [Page 1]
  59.  
  60. Internet Draft                iSCSI and SLP                   March 2002
  61.  
  62.  
  63.    The list of Internet-Draft Shadow Directories can be accessed at
  64.    http://www.ietf.org/shadow.html.
  65.  
  66. Copyright Notice
  67.  
  68.    Copyright (C) The Internet Society (2001).  All Rights Reserved.
  69.  
  70. Abstract
  71.  
  72.    The iSCSI protocol provides a way for hosts to access SCSI devices
  73.    over an IP network.  This document defines the use of the Service
  74.    Location Protocol (SLP) by iSCSI hosts, devices, and management
  75.    services, along with the SLP service type templates that describe the
  76.    services they provide.
  77.  
  78.  
  79. 1.  Acknowledgements
  80.  
  81.    This draft was produced by the iSCSI Naming and Discovery team,
  82.    including Joe Czap, Jim Hafner, John Hufferd, and Kaladhar Voruganti
  83.    (IBM), Howard Hall (Pirus), Jack Harwood (EMC), Yaron Klein (Sanrad),
  84.    Marjorie Krueger (HP), Lawrence Lamers (San Valley), Todd Sperry
  85.    (Adaptec), and Joshua Tseng (Nishan).  Thanks also to Julian Satran
  86.    (IBM) for suggesting the use of SLP for iSCSI discovery, and to Matt
  87.    Peterson (Caldera) and James Kempf (Sun) for reviewing the document
  88.    from an SLP perspective.
  89.  
  90.  
  91. 2.  Introduction
  92.  
  93.    iSCSI [iSCSI] is a protocol used to transport SCSI [SAM2] commands,
  94.    data, and status across an IP network.  This protocol is connection-
  95.    oriented, and is currently defined over TCP.  iSCSI uses a client-
  96.    server relationship.  The client end of the connection is an
  97.    initiator, and sends SCSI commands; the server end of the connection
  98.    is called a target, and receives and executes the commands.
  99.  
  100.    There are several methods an iSCSI initiator can use to find the
  101.    targets to which it should connect.  Two of these methods can be
  102.    accomplished without the use of SLP:
  103.  
  104.  
  105.    - Each target and its address can be statically configured on the
  106.      initiator.
  107.  
  108.    - Each address providing targets can be configured on the initiator;
  109.      iSCSI provides a mechanism by which the initiator can query the
  110.      address for a list of targets.
  111.  
  112.  
  113.  
  114. Bakke                    Expires September 2002                 [Page 2]
  115.  
  116. Internet Draft                iSCSI and SLP                   March 2002
  117.  
  118.  
  119.    The above methods are further defined in "iSCSI Naming and Discovery
  120.    Requirements" [NDT].
  121.  
  122.    Each of the above methods requires a small amount of configuration to
  123.    be done on each initiator.  The ability to discover targets and name
  124.    services without having to configure initiators is a desirable
  125.    feature.  The Service Location Protocol (SLP) [SLP] is an IETF
  126.    standards track protocol that provides several features that will
  127.    simplify locating iSCSI services.  This document describes how SLP
  128.    can be used in iSCSI environments to discover targets, addresses
  129.    providing targets, and storage management servers.
  130.  
  131.    This draft is a work in progress.  Searching for the string "WORK" in
  132.    this document should find anything that is not considered to be
  133.    complete.  The following items are still open:
  134.  
  135.    - Should look into Erik Guttman's serviceid scheme [SVCID] as a
  136.      slight variation to our SLP template, and see what it would take to
  137.      implement it, and whether it would change APIs.
  138.  
  139.    - Need to add RFC 3082 interaction.  An initiator that is already up
  140.      and running must be notified within a reasonable amount of time
  141.      when a new target becomes available to it.  This may be due to a
  142.      storage device booting, a network interface being added to the
  143.      device, a new target being created on the device, or the initiator
  144.      being added to the access-list of an existing device.  Work is
  145.      under way to determine the best way to do this, either using the
  146.      experimental RFC 3082 or some modification thereof.  Note that it
  147.      is a non-goal for SLP to notify an initiator when a target or one
  148.      of its service URLs is no longer accessible; the initiator will
  149.      find this out soon enough if it cares to attempt access to the
  150.      target.  Note that RFC 3082 takes care of a device booting, adding
  151.      a new interface or target (and hence, a service URL), but not the
  152.      access-list change.
  153.  
  154.    - Add comments about lifetime of URLs and how it is used.  URLs are
  155.      registered with a finite lifetime.  If the lifetime is too long, a
  156.      lot of stale URLs may hang around; if it is too short, SLP
  157.      participants will spend too much time re-registering the same old
  158.      URLs.  There is a definite recommendation by the SLP folks to stick
  159.      with the default; I have to go look it up to see what it is.
  160.  
  161.    - SLP can be set up to use either Unicast or Multicast.  Add a
  162.      discussion on when to use each.
  163.  
  164.    The following modifications have been made in draft-02:
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Bakke                    Expires September 2002                 [Page 3]
  171.  
  172. Internet Draft                iSCSI and SLP                   March 2002
  173.  
  174.  
  175.    - Removed the mgmt-ipaddress attribute from the template; if FQDN is
  176.      not available, the IP address may be returned in its place as a
  177.      dotted-decimal string.
  178.  
  179.    - Added example for finding targets that will allow access to any
  180.      initiator.
  181.  
  182.    - Updated Security Considerations to reference the IP storage
  183.      security draft.
  184.    The following modifications were made in draft-03:
  185.  
  186.    - Updated non-multicast usage text in section 5.1.
  187.  
  188.    - Updated references.
  189.  
  190.  
  191. 3.  Notation Conventions
  192.  
  193.    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  194.    "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
  195.    document are to be interpreted as described in [RFC2119].
  196.  
  197.  
  198. 4.  Terminology
  199.  
  200.    Here are some definitions that may aid readers that are unfamiliar
  201.    with either SLP, SCSI, or iSCSI.  Some of these definitions have been
  202.    reproduced from [RFC2608] and "Finding an RSIP Server with SLP"
  203.    [RSIP].
  204.  
  205.    User Agent (UA)            A process working on the client's behalf
  206.                               to establish contact with some service.
  207.                               The UA retrieves service information from
  208.                               the Service Agents or Directory Agents.
  209.  
  210.    Service Agent (SA)         A process working on behalf of one or more
  211.                               services to advertise the services and
  212.                               their capabilites.
  213.  
  214.    Directory Agent (DA)       A process which collects service
  215.                               advertisements.  There can only be one DA
  216.                               present per given host.
  217.  
  218.    Scope                      A named set of services, typically making
  219.                               up a logical administrative group.
  220.  
  221.    Service Advertisement      A URL, attributes, and a lifetime
  222.                               (indicating how long the advertisement is
  223.  
  224.  
  225.  
  226. Bakke                    Expires September 2002                 [Page 4]
  227.  
  228. Internet Draft                iSCSI and SLP                   March 2002
  229.  
  230.  
  231.                               valid), providing service access
  232.                               information and capabilities description
  233.                               for a particular service.
  234.  
  235.    Initiator                  A logical entity, typically within a host,
  236.                               that sends SCSI commands to targets to be
  237.                               executed.  An initiator is usually present
  238.                               in the form of a device driver.
  239.  
  240.    Target                     A logical entity, typically within a
  241.                               storage controller or gateway, that
  242.                               receives SCSI commands from an initiator
  243.                               and executes them.  A target includes one
  244.                               or more Logical Units (LUs); each LU is a
  245.                               SCSI device, such as a disk or tape drive.
  246.  
  247.    iSCSI Name                 A UTF-8 character string which serves as a
  248.                               unique identifier for iSCSI initiators and
  249.                               targets.  Its format and usage is further
  250.                               defined in [NDT].
  251.  
  252.    iSCSI Client               A logical entity, typically a host, which
  253.                               includes at least one iSCSI Initiator.
  254.  
  255.    iSCSI Server               A logical entity, typically a storage
  256.                               controller or gateway, which includes at
  257.                               least one iSCSI Target.
  258.  
  259.    Storage Management Server  An addressible entity that provides
  260.                               management services that benefit an iSCSI
  261.                               environment.  "Storage management server"
  262.                               is used as a generic term, rather than a
  263.                               specific protocol or service.
  264.  
  265.  
  266. 5.  Using SLP for iSCSI Service Discovery
  267.  
  268.    Two entities are involved in iSCSI discovery.  The end result is that
  269.    an iSCSI initiator (e.g. a host) discovers iSCSI targets, usually
  270.    provided by storage controllers or gateways.
  271.  
  272.    iSCSI targets are registered with SLP as a set of service URLs, one
  273.    for each address on which the target may be accessed.  Initiators
  274.    discover these targets using SLP service requests.  Targets that do
  275.    not directly support SLP, or are under the control of a management
  276.    service, may be registered by a proxy service agent as part of the
  277.    software providing this service.
  278.  
  279.  
  280.  
  281.  
  282. Bakke                    Expires September 2002                 [Page 5]
  283.  
  284. Internet Draft                iSCSI and SLP                   March 2002
  285.  
  286.  
  287.    iSCSI entities may also use SLP to discover higher-level management
  288.    services where needed.
  289.  
  290.    This section first describes the use of SLP for discovery of targets
  291.    by iSCSI initiators, and then describes the use of SLP to discover
  292.    storage management servers.
  293.  
  294.    This document assumes that SLPv2 will be used when discovering iSCSI-
  295.    related services; no attempt is made to include support for SLPv1.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. Bakke                    Expires September 2002                 [Page 6]
  339.  
  340. Internet Draft                iSCSI and SLP                   March 2002
  341.  
  342.  
  343. 5.1.  Discovering iSCSI Targets using SLP
  344.  
  345.    The following diagram shows the relationship between iSCSI clients,
  346.    servers, initiators, and targets.  An iSCSI client includes at least
  347.    one iSCSI initiator, and an SLP user agent (UA).  An iSCSI server
  348.    includes at least one iSCSI target, and an SLP service agent (SA).
  349.    Some entities, such as extended copy engines, include both initiators
  350.    and targets.  These include both an SA, for its targets to be
  351.    discovered, and a UA, for its intiator(s) to discover other targets.
  352.  
  353.               +---------------------------------+
  354.               |          iSCSI Client           |
  355.               |         +-----------+           |
  356.               |         | iSCSI     |           |
  357.               |         | initiator |           |
  358.               |         | "myhost"  |           |
  359.               |         +-----------+           |
  360.               |                                 |
  361.               +--------------------------+------+
  362.               | iSCSI Driver             |  UA  |
  363.               +--------------------------+------+
  364.               |           TCP/UDP/IP            |
  365.               +----------------+----------------+
  366.               |  Interface 1   |   Interface 2  |
  367.               +----------------+----------------+
  368.                        |               |
  369.      +------------+    |               |    +------------+
  370.      |   SLP DA   |    |               |    |  SLP DA    |
  371.      | (optional) |----+  IP Networks  +----| (optional) |
  372.      +------------+    |               |    +------------+
  373.                        |               |
  374.               +-----------------+-----------------|
  375.               |   Interface 1   |   Interface 2   |
  376.               |   10.1.30.21    |    10.1.40.3    |
  377.               +-----------------+-----------------+
  378.               |            TCP/UDP/IP             |
  379.               +---------------------------+-------+
  380.               |       iSCSI Driver        |  SA   |
  381.               +---------------------------+-------|
  382.               |                                   |
  383.               | +--------+ +--------+ +---------+ |
  384.               | | iSCSI  | | iSCSI  | |  iSCSI  | |
  385.               | | target | | target | |  target | |
  386.               | | "one"  | | "two"  | | "three" | |
  387.               | +--------+ +--------+ +---------+ |
  388.               |            iSCSI Server           |
  389.               +-----------------------------------+
  390.  
  391.  
  392.  
  393.  
  394. Bakke                    Expires September 2002                 [Page 7]
  395.  
  396. Internet Draft                iSCSI and SLP                   March 2002
  397.  
  398.  
  399.    In the above drawing, the iSCSI server has three iSCSI targets that
  400.    the client could discover, named "one", "two" and "three".  The iSCSI
  401.    client has an iSCSI initiator with the name "myhost".  The iSCSI
  402.    client may use the initiator name in its SLP Service Requests as a
  403.    filter to discover only targets that are configured to accept iSCSI
  404.    connections from "myhost".
  405.  
  406.    Each iSCSI target and initiator has a unique name, called an iSCSI
  407.    Name.  This identifier is the same regardless of the network path
  408.    (through adapter cards, networks, interfaces on the storage device)
  409.    over which the target is discovered and accessed.  For this example,
  410.    the iSCSI names "one" and "two", and "three" are used for the
  411.    targets; the initiator uses the name "myhost".  An actual iSCSI name
  412.    would incorporate more structure, including a naming authority, and
  413.    is not described here.
  414.  
  415.    Each of the iSCSI targets in the drawing can appear at two addresses,
  416.    since two network interfaces are present.  Each target, would have
  417.    two service URLs.
  418.  
  419.    An iSCSI target URL consists of its fully qualified host name or IP
  420.    address, the TCP port on which it is listening, and its iSCSI name.
  421.    An iSCSI server must register each of its individual targets at each
  422.    of its network addresses.
  423.  
  424.    The iSCSI server constructs a service advertisement of the type
  425.    "service:iscsi:target" for each of the service URLs it wishes to
  426.    register.  The advertisement contains a lifetime, along with other
  427.    attributes which are defined in the service template.
  428.  
  429.    If the server in the above drawing is listening at TCP port 5003 for
  430.    both network addresses, the service URLs registered would be:
  431.  
  432.    - 10.1.30.21:5003/one
  433.  
  434.    - 10.1.30.21:5003/two
  435.  
  436.    - 10.1.30.21:5003/three
  437.  
  438.    - 10.1.40.3:5003/one
  439.  
  440.    - 10.1.40.3:5003/two
  441.  
  442.    - 10.1.40.3:5003/three
  443.  
  444.    The remainder of the discovery procedure is identical to that used by
  445.    any client/server pair implementing SLP:
  446.  
  447.  
  448.  
  449.  
  450. Bakke                    Expires September 2002                 [Page 8]
  451.  
  452. Internet Draft                iSCSI and SLP                   March 2002
  453.  
  454.  
  455.    1. If an SLP DA is found, the SA contacts the DA and registers
  456.       the advertisement.  If no DA is found, the SA maintains the
  457.       advertisement itself, answering multicast UA queries
  458.       directly.
  459.  
  460.    2. When the iSCSI initiator requires contact information for an
  461.       iSCSI target, the UA either contacts the DA using unicast or
  462.       the SA using multicast.  If a UA is configured with the address
  463.       of the SA, it may avoid multicast and contact an SA using
  464.       unicast.  The UA includes a query based on
  465.       the attributes to indicate the characteristics of the
  466.       target(s) it requires.
  467.  
  468.    3. Once the UA has the host name or address of the iSCSI server
  469.       as well as the port number and iSCSI Target Name, it can begin the
  470.       normal iSCSI login to the target.
  471.  
  472.    As information contained in the iSCSI target template may exceed
  473.    common network datagram sizes, the SLP implementation for both UAs
  474.    and SAs supporting this template MUST implement SLP over TCP.
  475.  
  476.  
  477.  
  478. 5.1.1.  Using SLP in a Non-Multicast Environment
  479.  
  480.    In some networks, the use of multicast for discovery purposes is
  481.    either unavailable or not allowed.  Such networks include public or
  482.    service-provider networks that are placed in between an iSCSI client
  483.    and server; these are probably most common between two iSCSI
  484.    gateways, one at a storage service provider site, and one at a
  485.    customer site.
  486.  
  487.    In these networks, an initiator may, instead or in addition to its DA
  488.    configuration, allow the addresses of one or more SAs to be
  489.    configured.  The initiator would then make unicast SLP service
  490.    requests directly to these SAs, without the use of multicast to first
  491.    discover them.
  492.  
  493.    This functionality is well within the scope of the current SLP
  494.    protocol.  However, it does have two consequences for implementors:
  495.  
  496.    - A service-agent responding to requests for iSCSI targets MUST
  497.      implement SLP over TCP; UDP only is not enough.  This is not
  498.      an issue, since TCP is a requirement for iSCSI implementations
  499.      that use SLP for other reasons.
  500.  
  501.    - An initiator configured to make direct, unicast requests to an
  502.      SA will have to add this to the SLP API, if it is following the
  503.  
  504.  
  505.  
  506. Bakke                    Expires September 2002                 [Page 9]
  507.  
  508. Internet Draft                iSCSI and SLP                   March 2002
  509.  
  510.  
  511.      service location API defined in [RFC2614].  This capability
  512.      is being added to the next revision of the API, in [2614BIS].
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562. Bakke                    Expires September 2002                [Page 10]
  563.  
  564. Internet Draft                iSCSI and SLP                   March 2002
  565.  
  566.  
  567. 5.2.  Discovering Storage Management Services using SLP
  568.  
  569.    Storage management servers can be built to manage and control access
  570.    to targets in a variety of ways.  They can also provide extended
  571.    services beyond discovery, which could include storage allocation and
  572.    management.  None of these services are defined here; the intent of
  573.    this document is to allow these services to be discovered by both
  574.    clients and servers, in addition to the target discovery already
  575.    being performed.
  576.  
  577.    The following drawing shows an iSCSI client, an iSCSI server, and a
  578.    storage management server.  To simplify the drawing, the second IP
  579.    network is not shown, but is assumed to exist.  The storage
  580.    management server would use its own protocol (smsp) to provide
  581.    capabilities to iSCSI clients and servers; these clients and servers
  582.    can both use SLP to discover the storage management server.
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618. Bakke                    Expires September 2002                [Page 11]
  619.  
  620. Internet Draft                iSCSI and SLP                   March 2002
  621.  
  622.  
  623.       +---------------------------+
  624.       |         iSCSI Client      |
  625.       |                           |
  626.       |       +-----------+       |
  627.       |       | iSCSI     |       |
  628.       |       | initiator |       |
  629.       |       +-----------+       |
  630.       |                           |
  631.       +---------------+------+----+      +------------+
  632.       | iSCSI Driver  | smsp | UA |      |  SLP DA    |
  633.       +---------------+------+----+      |            |
  634.       |        TCP/UDP/IP         |      | (optional) |
  635.       +---------------+------+----+      +------------+
  636.                |                               |
  637.                |   IP Network                  |
  638.            ------------------------------------------
  639.                |                          |
  640.                |                          |
  641.       +---------------+-----------+     +---------------------+
  642.       |        TCP/UDP/IP         |     | TCP/UDP/IP          |
  643.       +---------------+------+----+     +---------------------+
  644.       | iSCSI Driver  | smsp | UA |     |   SA    |   smsp    |
  645.       +---------------+------+----+     +---------------------+
  646.       |                           |     |                     |
  647.       | +--------+ +--------+     |     | storage mgmt server |
  648.       | | iSCSI  | | iSCSI  |     |     |                     |
  649.       | | target | | target |     |     +---------------------+
  650.       | |   1    | |   2    |     |
  651.       | +--------+ +--------+     |
  652.       |                           |
  653.       |     iSCSI Server          |
  654.       +---------------------------+
  655.  
  656.    Note the difference between the storage management server model and
  657.    the previously-defined target discovery model.  When target discovery
  658.    was used, the iSCSI Server implemented an SA, to be discovered by the
  659.    initiator's UA.  In the storage management server model, the iSCSI
  660.    clients and servers both implement UAs, and the management server
  661.    implements the SA.
  662.  
  663.    A storage management server's URL contains the domain name or IP
  664.    address and TCP port.  No other information is required.
  665.  
  666.    The storage management server constructs a service advertisement of
  667.    the type "service:iscsi:sms" for each of the addresses at which it
  668.    appears.  The advertisement contains the URL, a lifetime, along with
  669.    other attributes which are defined in the service template.
  670.  
  671.  
  672.  
  673.  
  674. Bakke                    Expires September 2002                [Page 12]
  675.  
  676. Internet Draft                iSCSI and SLP                   March 2002
  677.  
  678.  
  679.    The remainder of the discovery procedure is identical to that used to
  680.    discover iSCSI targets, except that both initiators and targets would
  681.    normally be "clients" of the storage management service.
  682.  
  683.    Targets that support a storage management service implement a UA in
  684.    addition to the SA.  A target may alternatively just implement the
  685.    UA, and allow the storage management service to advertise its targets
  686.    appropriately by providing an SA and registering the appropriate
  687.    service:iscsi:target registrations on the target's behalf; the target
  688.    device would not have to advertise its own targets.  This has no
  689.    impact on the initiator.
  690.  
  691.    This allows the initiators' discovery of targets to be completely
  692.    interoperable regardless of which storage management service is used,
  693.    or whether one is used at all, or whether the target registrations
  694.    are provided directly by the target or by the management service.
  695.  
  696.  
  697. 5.3.  NAT and NAPT Considerations
  698.  
  699.    Since SLP provides IP address and TCP port information within its
  700.    payload, the addresses an SA or DA advertise may not be the same as
  701.    those a UA must use if a Network Address(/Port) Translation
  702.    (NAT/NAPT) device is present between the UA and the SA.  This may
  703.    result in the UA discovering address information that is unusable.
  704.    Here are a few recommendations to handle this:
  705.  
  706.  
  707.    - Use a fully-qualified domain name instead of IP address in service
  708.      URLs and in the mgmt-entity attribute.
  709.  
  710.    - Stick with the default, IANA-assigned iSCSI TCP port number in
  711.      service URLs, wherever possible.
  712.  
  713.    - If advertising service URLs through a NAT/NAPT device, and the
  714.      FQDN, IP address, or TCP port will be translated, the NAT/NAPT
  715.      device can provide an SLP proxy capability to do the translation.
  716.  
  717.  
  718. 5.4.  Implementation Considerations
  719.  
  720.    This section will answer common questions for those who are not too
  721.    familiar with SLP.
  722.  
  723.    Where are the templates used?  By the implementor; don't need to be
  724.    installed in a DA (not like a MIB).
  725.  
  726.    Who makes use of the templates?
  727.  
  728.  
  729.  
  730. Bakke                    Expires September 2002                [Page 13]
  731.  
  732. Internet Draft                iSCSI and SLP                   March 2002
  733.  
  734.  
  735.    - Implementor of iSCSI host drivers / adapters / devices
  736.    - Network Administrator (DHCP and DA)
  737.    - Storage Administrator (DA and SA)
  738.  
  739.    WORK - Integrating SLP DA or SA within a storage management server
  740.  
  741.    WORK - When to use multicast and/or unicast
  742.  
  743.    WORK - Using DHCP to bootstrap SLP discovery
  744.  
  745.  
  746. 6.  iSCSI SLP Templates
  747.  
  748.    Three templates are provided: an iSCSI target template, a management
  749.    service template, and an abstract template to encapsulate the two.
  750.  
  751.  
  752. 6.1.  The iSCSI Abstract Service Type Template
  753.  
  754.    This template defines the abstract service "service:iscsi".  It is
  755.    used as a top-level service to encapsulate all other iSCSI-related
  756.    services.
  757.  
  758.    Name of submitter: Mark Bakke
  759.    Language of service template: en
  760.    Security Considerations:
  761.      See the security considerations of the concrete service types.
  762.  
  763.    Template Text:
  764.    -------------------------template begins here-----------------------
  765.    template-type=iscsi
  766.  
  767.    template-version=0.1
  768.  
  769.    template-description=
  770.      This is an abstract service type.  The purpose of the iscsi
  771.      service type is to encompass all of the services used to support
  772.      the iSCSI protocol.
  773.  
  774.    template-url-syntax=
  775.      url-path=  ;  Depends on the concrete service type.
  776.  
  777.    --------------------------template ends here------------------------
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786. Bakke                    Expires September 2002                [Page 14]
  787.  
  788. Internet Draft                iSCSI and SLP                   March 2002
  789.  
  790.  
  791. 6.2.  The iSCSI Target Concrete Service Type Template
  792.  
  793.    This template defines the service "service:iscsi:target".  An entity
  794.    containing iSCSI targets that wishes them discovered via SLP would
  795.    register each of them, with each of their addresses, as this service
  796.    type.
  797.  
  798.    Initiators (and perhaps management services) wishing to discover
  799.    targets in this way will generally use one of the following queries:
  800.  
  801.    1. Find a specific target, given its iSCSI Target Name:
  802.  
  803.         Service: service:iscsi:target
  804.         Scope:   initiator-scope-list
  805.         Query:   (iscsi-name=iqn.2001-04.com.acme.sn.456)
  806.  
  807.    2. Find all of the iSCSI Target Names that may allow access to a
  808.       given initiator:
  809.  
  810.         Service: service:iscsi:target
  811.         Scope:   initiator-scope-list
  812.         Query:   (access-list=iqn.1998-03.com.os.hostid.045A7B)
  813.  
  814.    3. Find all of the iSCSI Target Names that may allow access to
  815.       any initiator:
  816.  
  817.         Service: service:iscsi:target
  818.         Scope:   initiator-scope-list
  819.         Query:   (access-list=iscsi)
  820.  
  821.    4. Find the iSCSI Target Names from which the given initiator is
  822.       allowed to boot:
  823.  
  824.         Service: service:iscsi:target
  825.         Scope:   initiator-scope-list
  826.         Query:   (boot-list=iqn.1998-03.com.os.hostid.045A7B)
  827.  
  828.    5. In addition, a management service may wish to discover all
  829.       targets:
  830.  
  831.         Service: service:iscsi:target
  832.         Scope:   management-server-scope-list
  833.         Query:   <empty-string>
  834.  
  835.    More details on booting from an iSCSI target are defined in [BOOT].
  836.  
  837.    Name of submitter: Mark Bakke
  838.    Language of service template: en
  839.  
  840.  
  841.  
  842. Bakke                    Expires September 2002                [Page 15]
  843.  
  844. Internet Draft                iSCSI and SLP                   March 2002
  845.  
  846.  
  847.    Security Considerations:
  848.      See later section.
  849.  
  850.    Template Text:
  851.    -------------------------template begins here-----------------------
  852.    template-type=iscsi:target
  853.  
  854.    template-version=0.1
  855.  
  856.    template-description=
  857.      This is concrete service type.  The iscsi:target service type is used
  858.      to register individual target addresses to be discovered by others.
  859.      UAs will generally search for these by including one of the following:
  860.      - the iSCSI target name
  861.      - the iSCSI initiator name (must be in the access-list of the target)
  862.      - the service URL
  863.  
  864.    template-url-syntax=
  865.      url-path   =  ipaddr [ : tcpport ] / iscsi-name
  866.      ipaddr     =  DNS host name or ip address
  867.      tcpport    =  decimal tcp port number
  868.      iscsi-name =  iSCSI target name
  869.      ; The iscsi-name part of the URL is required and must be the iSCSI
  870.      ; name of the target being registered.
  871.      ; A device representing multiple targets must individually
  872.      ; register each target/address combination with SLP.
  873.      ;
  874.      ; Example:
  875.      ;   service:iscsi:target://10.1.3.40:5003/iqn.2001-04.com.acme.sn.45678
  876.  
  877.    iscsi-name = string
  878.    # The iSCSI Name of this target.
  879.    # This must match the iscsi-name in the url-path.
  880.  
  881.    portal-group = integer
  882.    # The iSCSI portal group tag for this address.  Addresses sharing
  883.    # the same iscsi-name and portal-group tag can be used within the
  884.    # same iSCSI session.  Portal groups are described in [ISCSI].
  885.  
  886.    transports = string M L
  887.    tcp
  888.      # This is a list of transport protocols that the registered
  889.      # entity supports.  iSCSI is currently supported over TCP,
  890.      # but it is anticipated that it could be supported over other
  891.      # transports, such as SCTP, in the future.
  892.    tcp
  893.  
  894.    mgmt-entity = string O
  895.  
  896.  
  897.  
  898. Bakke                    Expires September 2002                [Page 16]
  899.  
  900. Internet Draft                iSCSI and SLP                   March 2002
  901.  
  902.  
  903.    # The fully qualified domain name, or IP address in dotted-decimal
  904.    # notation, of the management interface of the entity containing
  905.    # this target.
  906.    #
  907.  
  908.    alias = string O
  909.    # The alias string contains a descriptive name of the target.
  910.  
  911.    access-list = string M
  912.    # A list of iSCSI Initiator Names that can access this target.
  913.    # Normal iSCSI names will be 50 characters or less; max length is 255.
  914.    # Normally, only one or a few values will be in the list.
  915.    # Using the equivalence search on this will evaluate to "true"
  916.    # if any one of the items in this list matches the query.
  917.    # If this list contains the default name "iscsi", any initiator
  918.    # is allowed to access this target.
  919.  
  920.    boot-list = string M O
  921.    # A list of iSCSI Initiator Names that can boot from this target.
  922.    # This list works precisely like the access-list attribute.  A name appearing
  923.    # in this list must either appear in the access-list, or the
  924.    # access-list must contain the initiator name "iscsi".  Otherwise, an
  925.    # initiator will be unable to find its boot target.
  926.    # If boot-list contains the name "iscsi", any host can boot from it,
  927.    # but I am not sure if this is useful to anyone.
  928.    # If this attribute is not registered, this target is not "bootable".
  929.    #
  930.    # Note that the LUN the host boots from is not specified here; a
  931.    # host will generally attempt to boot from LUN 0.
  932.    #
  933.    # It is quite possible that other attributes will need to be defined
  934.    # here for booting as well.
  935.  
  936.    --------------------------template ends here------------------------
  937.  
  938.  
  939. 6.3.  iSCSI Storage Management Service Templates
  940.  
  941.    This template defines the service "service:iscsi:sms".  An entity
  942.    supporting one or more iSCSI management service protocols may
  943.    register itself with SLP as this service type.
  944.  
  945.    iSCSI clients and servers wishing to discover storage management
  946.    services using SLP will usually search for them by the protocol(s)
  947.    they support:
  948.  
  949.         Service: service:iscsi:sms
  950.         Scope:   initiator-scope-list
  951.  
  952.  
  953.  
  954. Bakke                    Expires September 2002                [Page 17]
  955.  
  956. Internet Draft                iSCSI and SLP                   March 2002
  957.  
  958.  
  959.         Query:   (protocols=isns)
  960.  
  961.    Name of submitter: Mark Bakke
  962.    Language of service template: en
  963.    Security Considerations:
  964.      See later section.
  965.  
  966.    Template Text:
  967.    -------------------------template begins here-----------------------
  968.    template-type=iscsi:sms
  969.  
  970.    template-version=0.1
  971.  
  972.    template-description=
  973.      This is a concrete service type.  The iscsi:sms service type
  974.      provides the capability for entities supporting iSCSI to discover
  975.      appropriate management services.
  976.  
  977.    template-url-syntax=
  978.      url-path   = ; The URL of the management service.  Defined in RFC 2608.
  979.  
  980.    protocols = string M L
  981.    # The list of protocols supported by this name service.  This
  982.    # list may be expanded in the future.  There is no default.
  983.    #
  984.    # "isns"  - This management service supports the use of the iSNS
  985.    #           protocol for access management, health monitoring, and
  986.    #           discovery management services.  This protocol is defined
  987.    #           in [ISNS].
  988.    isns
  989.  
  990.    --------------------------template ends here------------------------
  991.  
  992.  
  993. 7.  Security Considerations
  994.  
  995.    Service type templates provide information that is used to interpret
  996.    information obtained by clients through SLP. If the iSCSI templates
  997.    are modified or if false templates are distributed, iSCSI targets and
  998.    name servers may not correctly register themselves, or iSCSI clients
  999.    may not be able to interpret service information.
  1000.  
  1001.    SLP provides an authentication mechanism for UAs to assure that
  1002.    service advertisments only come from trusted SAs [RFC2608].  If trust
  1003.    is an issue then SLP authentication should be enabled in the network.
  1004.  
  1005.    Once a target or management server is discovered, authentication and
  1006.    authorization are handled by the iSCSI protocol, or by the management
  1007.  
  1008.  
  1009.  
  1010. Bakke                    Expires September 2002                [Page 18]
  1011.  
  1012. Internet Draft                iSCSI and SLP                   March 2002
  1013.  
  1014.  
  1015.    server's protocol.  It is the responsibility of the providers of
  1016.    these services to ensure that an inappropriately advertised or
  1017.    discovered service does not compromise their security.
  1018.  
  1019.  
  1020. 7.1.  IPsec Integration
  1021.  
  1022.    Although SLPv2 security provides authentication, it does not provide
  1023.    confidentiality.  In many environments, confidentiality of discovery
  1024.    information is important.  For instance, the existence of a
  1025.    particular iSCSI target name within a building can indicate that
  1026.    there is an expensive/important piece of equipment in there, and its
  1027.    discovery information.  This may provide enough information for an
  1028.    attacker to attempt a denial-of-service or other attacks on the iSCSI
  1029.    device.
  1030.  
  1031.    SLPv2 authentication does not provide confidentiality of discovery
  1032.    information.  When this is a concern, in particular when SLPv2 is
  1033.    used to distribute security policy information, IPsec MUST be used
  1034.    with SLPv2 when discovering iSCSI targets.  When this is not a
  1035.    concern, SLPv2 security MAY be implemented and used.
  1036.  
  1037.    The use of IPsec and IKE for SLPv2 is described in [IPS-SEC], and is
  1038.    a work in progress.
  1039.  
  1040.  
  1041. 8.  Summary
  1042.  
  1043.    This document describes how SLP can be used by iSCSI initiators to
  1044.    find iSCSI targets and storage management servers.  Service type
  1045.    templates for iSCSI targets and storage management servers are
  1046.    presented.
  1047.  
  1048.  
  1049. 9.  References
  1050.  
  1051.  
  1052. [RFC2608]   E. Guttman, C. Perkins, J. Veizades, M. Day.  "Service
  1053.             Location Protocol, version 2", RFC 2608, July 1999.
  1054.  
  1055. [RFC2609]   E. Guttman, C. Perkins, J. Kempf.  "Service Templates and
  1056.             service: Schemes", RFC 2609, July 1999.
  1057.  
  1058. [RFC2614]   J. Kempf, E. Guttman.  "An API for Service Location", RFC
  1059.             2614, June 1999.
  1060.  
  1061. [2614BIS]   J. Kempf, E. Guttman.  "An API for Service Location", draft-
  1062.             kempf-svrloc-rfc2614bis-00.txt, February 2002.
  1063.  
  1064.  
  1065.  
  1066. Bakke                    Expires September 2002                [Page 19]
  1067.  
  1068. Internet Draft                iSCSI and SLP                   March 2002
  1069.  
  1070.  
  1071. [RFC2119]   S. Bradner.  "Key Words for Use in RFCs to Indicate
  1072.             Requirement Levels", RFC 2119, March 1997.
  1073.  
  1074. [RFC3082]   J. Kempf, J Goldschmidt. "Notification and Subscription for
  1075.             SLP", RFC 3082, March 2001.
  1076.  
  1077. [ISCSI]     J. Satran, et. al.  "iSCSI", draft-ietf-ips-iscsi-10.txt,
  1078.             January 2002.
  1079.  
  1080. [SAM2]      ANSI T10.  "SCSI Architectural Model 2", March 2000.
  1081.  
  1082. [NDT]       K. Voruganti, et. al.  "iSCSI Naming and Discovery", draft-
  1083.             ietf-ips-iscsi-name-disc-05, March 2002.
  1084.  
  1085. [ISNS]      J. Tseng, et. al.  "Internet Storage Name Service",
  1086.             draft-ietf-ips-isns-05, November 2001.
  1087.  
  1088. [BOOT]      P. Sarkar, D. Missimer, C. Sapuntzakis.  "A Standard for
  1089.             Bootstrapping Clients using the iSCSI Protocol",
  1090.             draft-ietf-ips-iscsi-boot-04, November 2001.
  1091.  
  1092. [RSIP]      Kempf, J., Montenegro, G., "Finding an RSIP Server with
  1093.             SLP", draft-ietf-nat-rsip-slp-00, February 2000.
  1094.  
  1095. [IPS-SEC]   B. Aboba, et. al., "Securing iSCSI, iFCP, and FCIP",
  1096.             draft-ietf-ips-security-10, February 2002.
  1097.  
  1098. [SVCID]     E. Guttman, "The serviceid: URL Scheme for Service
  1099.             Location",
  1100.             draft-guttman-svrloc-serviceid-01, January 2002.
  1101.  
  1102. Author's  Address:
  1103.  
  1104.        Mark Bakke
  1105.        Cisco Systems, Inc.
  1106.        6450 Wedgwood Road
  1107.        Maple Grove, MN
  1108.        USA 55311
  1109.  
  1110.        Voice:  +1 763-398-1000
  1111.        E-Mail: mbakke@cisco.com
  1112.  
  1113. Full Copyright Statement
  1114.  
  1115.    Copyright (C) The Internet Society (2001).  All Rights Reserved.
  1116.  
  1117.    This document and translations of it may be copied and furnished to
  1118.    others, and derivative works that comment on or otherwise explain it
  1119.  
  1120.  
  1121.  
  1122. Bakke                    Expires September 2002                [Page 20]
  1123.  
  1124. Internet Draft                iSCSI and SLP                   March 2002
  1125.  
  1126.  
  1127.    or assist in its implementation may be prepared, copied, published
  1128.    and distributed, in whole or in part, without restriction of any
  1129.    kind, provided that the above copyright notice and this paragraph are
  1130.    included on all such copies and derivative works.  However, this
  1131.    document itself may not be modified in any way, such as by removing
  1132.    the copyright notice or references to the Internet Society or other
  1133.    Internet organizations, except as needed for the purpose of
  1134.    developing Internet standards in which case the procedures for
  1135.    copyrights defined in the Internet Standards process must be
  1136.    followed, or as required to translate it into languages other than
  1137.    English.
  1138.  
  1139.    The limited permissions granted above are perpetual and will not be
  1140.    revoked by the Internet Society or its successors or assigns.
  1141.  
  1142.    This document and the information contained herein is provided on an
  1143.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  1144.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  1145.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  1146.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  1147.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  1148.  
  1149. Acknowledgement
  1150.  
  1151.    Funding for the RFC Editor function is currently provided by the
  1152.    Internet Society.
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Bakke                    Expires September 2002                [Page 21]
  1179.