<?xml version="1.0" encoding="us-ascii"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd"[
<!ENTITY RFC6256 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.6256.xml">
<!ENTITY RFC4838 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4838.xml">
<!ENTITY RFC2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml">
<!ENTITY RFC5050 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.5050.xml">
<!ENTITY RFC6257 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.6257.xml">
<!ENTITY RFC5326 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.5326.xml">
]>
<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
<?rfc strict="yes" ?>
<?rfc toc="yes"?>
<?rfc tocdep"4"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes" ?>
<?rfc compact="no" ?>
<?rfc subcompact="no" ?>

<rfc category="exp" ipr="trust200902" docName="draft-birrane-dtn-adm-ion-ltpadmin-01" obsoletes="" updates="" submissionType="IETF" xml:lang="en">

   <!-- ***** FRONT MATTER ***** -->
   <front> 
      <title abbrev="ION LTP Admin ADM">ION Licklider Transmission Protocol Admin Application Data Model</title>
      <author fullname="Edward J. Birrane" initials="E.B." surname="Birrane">
         <organization> Johns Hopkins Applied Physics Laboratory </organization>
         <address>
            <email>Edward.Birrane@jhuapl.edu</email>
         </address>
      </author>
      <author fullname="Evana DiPietro" initials="E.D." surname="DiPietro">
         <organization> Johns Hopkins Applied Physics Laboratory </organization>
         <address>
            <email>Evana.DiPietro@jhuapl.edu</email>
         </address>
      </author>
      <author fullname="David Linko" initials="D.L." surname="Linko">
         <organization> Johns Hopkins Applied Physics Laboratory </organization>
         <address>
            <email>David.Linko@jhuapl.edu</email>
         </address>
      </author>
      <date year="2019" />
      
       <!-- Meta-data Declarations -->
      <area>General</area>
      <workgroup>Delay-Tolerant Networking</workgroup>
      <keyword>DTN</keyword>
      <keyword>Network Management</keyword>

      <abstract>
         <t>
            This document describes the Application Data Model (ADM) for the
            configuration of licklider transmission protocol (LTP) in ION in compliance with the template provided by <xref target="I-D.birrane-dtn-adm"/>.
         </t>
      </abstract>
   </front>
  
   <middle>
      <section title="Introduction" toc="default">
         <t>
            An Application Data Model (ADM) provides a guaranteed 
            interface for the management of an application or 
            protocol in accordance with the Asynchronous Management 
            Architecture (AMA) defined in <xref target="I-D.birrane-dtn-ama"/>. 
            The ADM described in this document complies with the 
            ADM Template provided in <xref target="I-D.birrane-dtn-adm"/> 
            as encoded using the JSON syntax.
         </t>
         <t>
            The ION Licklider Transmission Protocol (LTP) Administration ADM contains all of the functionality that is required to properly configure LTP in ION in accordance with <xref target="RFC5326"/>. LTP is a convergence layer protocol. There is no flow control or congestion control in LTP. LTP must run either over UDP or directly over a link layer protocol. Because of this, LTP cannot be used in every situation. This LTP Admin ADM provides the set of information necessary to provide retransmission based reliability on challenged networks, focusing on the information that are needed to manage LTP properly on the network. 

         </t>
             
         <section title="Technical Notes" toc="default">
            <t>
               <list style="symbols">
                  <t>
                     This document describes Version 0.0 of the ION LTP Admin ADM.
                  </t>
                  <t>
                     The AMM Resource Identifier (ARI) for this ADM is 
                     NOT correctly set. A sample ARI is used in this version of the
                     specification and MAY change in future versions of this ADM
                     until an ARI registry is established. This notice will be removed
                     at that time.
                  </t>
                  <t>
                     Agent applications MAY choose to ignore the name, description,
                     or other annotative information associated with the component definitions within this ADM where such items are only used to provide human-readable information or are otherwise not necessary to manage a device.                     
                  </t>              
               </list>
            </t>
         </section>
      
         <section title="Scope" toc="default">
            <t>
               This ADM specifies those components of the Asynchronous 
               Management Model (AMM) common to the configuration of LTP in ION. 
            </t>
            <t>
               Any Manager software implementing this ADM MUST perform the responsibilities of an AMA Manager as outlined in <xref target="I-D.birrane-dtn-adm"/> as they relate to the objects included in this document.
            </t>
            <t>
               Any Agent software implementing this ADM MUST perform the responsibilities
               of an AMA Agent as outlined in <xref target="I-D.birrane-dtn-adm"/> as they relate to the objects included in this document.
            </t>
         </section>
         
         <section title="Requirements Language" toc="default">
            <t>
               The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
               "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
               document are to be interpreted as described in 
               <xref target="RFC2119" pageno="false" format="default">RFC 2119</xref>.
            </t>
         </section>   
                 
      </section>
      <section title="Structure and Design of this ADM">
        <t>
          The LTP Admin ADM's structure is in accordance to <xref target="I-D.birrane-dtn-adm"/>. This ADM contains metadata, table templates, and controls. Table Templates are column templates that will be followed by any instance of this table available in the network. They may not be created dynamically within the network by Managers. Controls are predefined and sometimes parameterized opcodes that can be run on an Agent. Controls are preconfigured in Agents and Managers as part of ADM support.There are no variables, report templates, macros, edd, constants, or operators in this ADM at this time. The contents of this ADM are derived from the main functions and data that are needed to manage LTP <xref target="RFC5326" pageno="false" format="default">RFC 5326</xref>. 
        </t>
        <t>
          All ADMs have metadata that includes the name, namespace, and version of the ADM as well as the name of the organization that is issuing that particular ADM. This is important for identification purposes of the ADMs and to ensure version control.
        </t>
          <t>
          The main idea identified in LTP that is present in this ADM is a span of potential LTP data interchange between engines(nodes on a network that use LTP). 
        </t>
      </section>
      <section title="Naming and Identification">
         <t>
            This section outlines the namespaces used to uniquely identify
            ADM objects in this specification.
         </t>

          <section title="Namespace and Nicknames">
            <t>
               In accordance with <xref target="I-D.birrane-dtn-adm"/>, every ADM
               is assigned a moderated Namespace. In accordance with 
               <xref target="I-D.birrane-dtn-amp"/>, these namespaces may be
               enumerated for compactness. The namespace and ADM identification
               for these objects is defined as follows.
            </t>
            <texttable anchor="agent_ns" title="Namespace Information" align="center">
               <ttcol align="center">Identifier</ttcol>
               <ttcol align="center">Value</ttcol>
               
               <c>Namespace</c>
               <c>DTN/ION/ltpadmin</c>

               <c>ADM Enumeration</c>
               <c>9</c>
            </texttable>

            <t>
              Given the above ADM enumeration, in accordance with 
              <xref target="I-D.birrane-dtn-amp"/>, the following AMP
              nicknames are defined.
            </t>

            
            <texttable anchor="ionltp_nn" title="ION BP ADM Nicknames" align="center" style="full">
               <ttcol width="10%" align="center">Nickname</ttcol>
               <ttcol width="45%" align="center">Collection</ttcol>
               
               <c>180</c>
               <c>DTN/ION/ltpadmin//Const</c>

               <c>181</c>
               <c>DTN/ION/ltpadmin//Ctrl</c>

               <c>182</c>
               <c>DTN/ION/ltpadmin//Edd</c>

               <c>183</c>
               <c>DTN/ION/ltpadmin//Mac</c>

               <c>184</c>
               <c>DTN/ION/ltpadmin//Oper</c>

               <c>185</c>
               <c>DTN/ION/ltpadmin//Rptt</c>

               <c>187</c>
               <c>DTN/ION/ltpadmin//Tblt</c>

               <c>189</c>
               <c>DTN/ION/ltpadmin//Var</c>

               <c>190</c>
               <c>DTN/ION/ltpadmin//Mdat</c>

               <c>191-199</c>
               <c>DTN/ION/ltpadmin//Reserved</c>

            </texttable>
         
         </section>
      </section>

      <section title="ION LTP Admin ADM JSON Encoding">
        <t>
          <figure>
            <artwork>

{
  "Mdat": [{
      "name": "name",
      "type": "STR",
      "value": "ion_ltp_admin",
      "description": "The human-readable name of the ADM."
    },
    {
      "name": "namespace",
      "type": "STR",
      "value": "DTN/ION/ltpadmin",
      "description": "The namespace of the ADM."
    },
    {
      "name": "version",
      "type": "STR",
      "value": "v0.0",
      "description": "The version of the ADM."
    },
    {
      "name": "organization",
      "type": "STR",
      "value": "JHUAPL",
      "description": "The name of the issuing organization of the 
                      ADM."
    }
  ],
  "Edd": [{
    "name": "ion_version",
    "type": "STR",
    "description": "This is the version of ION that is currently 
                    installed."
  }],
  "Tblt": [{
    "name": "spans",
    "columns": [{
      "type": "UVAST",
      "name": "peer_engine_nbr"
    }, {
      "type": "UINT",
      "name": "max_export_sessions"
    }, {
      "type": "UINT",
      "name": "max_import_sessions"
    }, {
      "type": "UINT",
      "name": "max_segment_size"
    }, {
      "type": "UINT",
      "name": "aggregation_size_limit"
    }, {
      "type": "UINT",
      "name": "aggregation_time_limit"
    }, {
      "type": "STR",
      "name": "lso_control"
    }, {
      "type": "UINT",
      "name": "queueing_latency"
    }],
    "description": "This table lists all spans of potential LTP data 
                    interchange that exists between the local LTP 
                    engine and the indicated (neighboring) LTP engine."
  }],
  "Ctrl": [{
      "name": "manage_heap",
      "parmspec": [{
        "type": "UINT",
        "name": "max_database_heap_per_block"
      }],
      "description": "This control declares the maximum number of 
                      bytes of SDR heap space that will be occupied by 
                      the acquisition of any single LTP block. All 
                      data acquired in excess of this limit will be 
                      written to a temporary file pending extraction 
                      and dispatching of the acquired block. Default 
                      is the minimum allowed value (560 bytes), which 
                      is the approximate size of a ZCO file reference 
                      object; this is the minimum SDR heap space 
                      occupancy in the event that all acquisition is 
                      into a file."
    },
    {
      "name": "manage_max_ber",
      "parmspec": [{
        "type": "REAL32",
        "name": "max_expected_bit_error_rate"
      }],
      "description": "This control sets the expected maximum bit error 
                      rate(BER) that LTP should provide for in 
                      computing the maximum number of transmission 
                      efforts to initiate in the transmission of a 
                      given block.(Note that this computation is also 
                      sensitive to data segment size and to the size 
                      of the block that is to be transmitted.) The 
                      default value is .0001 (10^-4)."
    },
    {
      "name": "manage_own_queue_time",
      "parmspec": [{
        "type": "UINT",
        "name": "own_queing_latency"
      }],
      "description": "This control sets the number of seconds of 
                      predicted additional latency attributable to 
                      processing delay within the local engine itself 
                      that should be included whenever LTP computes 
                      the nominal round-trip time for an exchange of 
                      data with any remote engine.The default value 
                      is 1."
    },
    {
      "name": "manage_screening",
      "parmspec": [{
        "type": "UINT",
        "name": "new_state"
      }],
      "description": "This control enables or disables the screening 
                      of received LTP segments per the periods of 
                      scheduled reception in the node's contact graph.
                      By default, screening is disabled. When 
                      screening is enabled, such segments are silently 
                      discarded. Note that when screening is enabled 
                      the ranges declared in the contact graph must 
                      be accurate and clocks must be synchronized; 
                      otherwise, segments will be arriving at times 
                      other than the scheduled contact intervals and 
                      will be discarded."
    },
    {
      "name": "span_add",
      "parmspec": [{
        "type": "UVAST",
        "name": "peer_engine_number"
      }, {
        "type": "UINT",
        "name": "max_export_sessions"
      }, {
        "type": "UINT",
        "name": "max_import_sessions"
      }, {
        "type": "UINT",
        "name": "max_segment_size"
      }, {
        "type": "UINT",
        "name": "aggregtion_size_limit"
      }, {
        "type": "UINT",
        "name": "aggregation_time_limit"
      }, {
        "type": "STR",
        "name": "lso_control"
      }, {
        "type": "UINT",
        "name": "queuing_latency"
      }],
      "description": "This control declares that a span of potential 
                      LTP data interchange exists between the local 
                      LTP engine and the indicated (neighboring) LTP 
                      engine."
    },
    {
      "name": "span_change",
      "parmspec": [{
        "type": "UVAST",
        "name": "peer_engine_number"
      }, {
        "type": "UINT",
        "name": "max_export_sessions"
      }, {
        "type": "UINT",
        "name": "max_import_sessions"
      }, {
        "type": "UINT",
        "name": "max_segment_size"
      }, {
        "type": "UINT",
        "name": "aggregtion_size_limit"
      }, {
        "type": "UINT",
        "name": "aggregation_time_limit"
      }, {
        "type": "STR",
        "name": "lso_control"
      }, {
        "type": "UINT",
        "name": "queuing_latency"
      }],
      "description": "This control sets the indicated span's 
                      configuration parameters to the values provided 
                      as arguments"
    },
    {
      "name": "span_del",
      "parmspec": [{
        "type": "UVAST",
        "name": "peer_engine_number"
      }],
      "description": "This control deletes the span identified by 
                      peerEngineNumber. The control will fail if any 
                      outbound segments for this span are pending 
                      transmission or any inbound blocks from the 
                      peer engine are incomplete."
    },
    {
      "name": "stop",
      "description": "This control stops all link service input and 
                      output tasks for the local LTP engine."
    },
    {
      "name": "watch_set",
      "parmspec": [{
        "type": "STR",
        "name": "activity"
      }],
      "description": "This control enables and disables production of 
      a continuous stream of user- selected LTP activity indication 
      characters. Activity parameter of 1 selects all LTP activity 
      indication characters; 0 de-selects all LTP activity indication 
      characters; any other activitySpec such as df{] selects all 
      activity indication characters in the string, de-selecting all 
      others. LTP will print each selected activity indication 
      character to stdout every time a processing event of the 
      associated type occurs: d bundle appended to block for next 
      session, e segment of block is queued for transmission, f 
      block has been fully segmented for transmission, g segment 
      popped from transmission queue, h positive ACK received for 
      block and session ended, s segment received, t block has been 
      fully received, @ negative ACK received for block and segments 
      retransmitted, = unacknowledged checkpoint was retransmitted, 
      + unacknowledged report segment was retransmitted, { export 
      session canceled locally (by sender), } import session canceled 
      by remote sender, [ import session canceled locally (by 
      receiver), ] export session canceled by remote receiver"
    }
  ]
}
      </artwork>
    </figure>
  </t>
      </section>

				    
    <section anchor="IANA" title="IANA Considerations" toc="default">
      <t>
		At this time, this protocol has no fields registered by IANA.
	  </t>
    </section>
  </middle>

   <!--  *****BACK MATTER ***** -->
   <back>
      <references title="Informative References">
               
         <?rfc include="reference.I-D.draft-birrane-dtn-ama-07"?>
                    
      </references>
      
      <references title="Normative References">
         &RFC2119;     
         &RFC5326;
         
 <?rfc include="reference.I-D.draft-birrane-dtn-adm-02"?>
 <?rfc include="reference.I-D.draft-birrane-dtn-amp-04"?>         
      </references>
    
  </back>
</rfc>