<?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 RFC7228 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.7228.xml">
<!ENTITY RFC2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml">
<!ENTITY RFC3416 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.3416.xml">
<!ENTITY RFC6241 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.6241.xml">
<!ENTITY RFC6020 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.6020.xml">
<!ENTITY RFC8040 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.8040.xml">
]>
<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
<?rfc strict="yes" ?>
<?rfc toc="yes"?>
<!-- generate a ToC -->
<?rfc symrefs="yes"?>
<!-- use symbolic references tags, i.e, [RFC2119] instead of [1] -->
<?rfc sortrefs="yes" ?>
<!-- sort the reference entries alphabetically -->
<?rfc compact="no" ?>
<!-- do not start each main section on a new page -->
<?rfc subcompact="no" ?>

<rfc category="info" ipr="trust200902" docName="draft-ietf-dtn-ama-02" submissionType="IETF" xml:lang="en">

<!-- ***** FRONT MATTER ***** -->
<front>
   <!-- The abbreviated title is used in the page header - it is only necessary if the
        full title is longer than 39 characters -->
   <title abbrev="AMA">Asynchronous Management Architecture</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="Emery Annis" initials="E." surname="Annis">
      <organization>Johns Hopkins Applied Physics Laboratory</organization>
      <address>
        <email>Emery.Annis@jhuapl.edu</email>
      </address>
   </author>

   <author fullname="Sarah E. Heiner" initials="S.E." surname="Heiner">
      <organization>Johns Hopkins Applied Physics Laboratory</organization>
      <address>
        <email>Sarah.Heiner@jhuapl.edu</email>
      </address>
   </author>

   <date month="October" year="2021"/>
   <!-- Meta-data Declarations -->
   <area>General</area>
   <workgroup>Delay-Tolerant Networking</workgroup>
   <keyword>DTN</keyword>
   <keyword>Network Management</keyword>

   <abstract>
      <t>
        This document describes a management architecture suitable for 
        deployment in challenged networking environments for the configuration,
        monitoring, and local control of application services. Challenged 
        networking environments
        exhibit interruptions in end-to-end connectivity and communications
        delays that are both long-lived and unpredictable. Even in these
        challenging conditions, such networks must provide some type of
        end-to-end information transport and fault protection while also 
        supporting configuration and performance reporting. This management
        may need to operate without human- or system-in-the-loop synchronous
        interactivity and without the preservation of transport-layer sessions.
        In such a context, challenged networks must exhibit behavior that is 
        both determinable and autonomous while maintaining as much 
        compatibility with non-challenged-network operational concepts as
        possible. 
      </t>
      <t>
        The architecture described in this document is termed the Asynchronous
        Management Architecture (AMA). The AMA supported two types of 
        asynchronous behavior. First, the AMA does not presuppose any 
        synchronized transport behavior between managed and managing devices.
        Second, the AMA does not support any query-response semantics. In
        this way, the AMA allows for operation in extremely challenging
        conditions, to include over uni-directional links and cases where
        delays/disruptions would otherwise prevent operation over traditional
        transport layers, such as when exceeding the Maximum Segment Lifetime
        (MSL) of the Transmission Control Protocol (TCP). 
      </t>
   </abstract>
</front>
 
<middle>
   <section title="Introduction" toc="default">
      <t>
        The Asynchronous Management Architecture (AMA) provides a novel 
        approach for the configuration, monitoring, and local control of
        application services on a managed device over a challenged network. The
        unique properties of a challenged network are as defined in 
        <xref target="RFC7228"/> and include cases where an end-to-end transport 
        path may not be feasible at any moment in time and delivery delays may 
        prevent timely communications between a network operator and a managed 
        device. These delays may be caused by long signal propagations or 
        frequent link disruptions (such as described in 
        <xref target="RFC4838"/>) or by non-environmental factors such as 
        quality-of-service prioritizations and service-level agreements.
      </t>
	  
	    <t>
        Importantly, the management approach for a challenged network must be
        one which remains operational in the most restrictive environments in
        which such networks might be instantiated. The AMA approach should be
        functional in a variety of potential management scenarios, to include
        the following. 

        <list style="symbols">
          <t>
            Managed devices that are only accessible via a uni-directional
            link, or via a link whose duration is shorter than a single
            round-trip propagation time. 
          </t>
          <t>
            Links that may be significantly constrained by capacity or
            reliability, but at (predictable or unpredictable) times may offer 
            significant throughput. 
          </t>
          <t>
            Multi-hop challenged networks that interconnect two or more 
            unchallenged networks such that managed and managing devices exist
            in different networks.             
          </t>
        </list>
      </t>

      <t>
        In these and related scenarios, managed devices need to operate with 
        a certain level of local autonomy because managing devices may not be
        available within operationally-relevant timeframes. Managing devices
        deliver instruction sets that govern the local, autonomous behavior
        of the managed device. These behaviors include, but are not limited
        to, collecting performance data, state, and error conditions, and 
        applying pre-determined responses to pre-determined events.
      </t>
                
      <t>
        The AMA is a novel approach to management that can leverage transport,
		    network, and security solutions designed for challenged networks, but 
        is not bound to any single solution. The goal is asynchronous 
        communication between the device being managed and the manager, at 
        times never expecting a reply, and with knowledge that commands and 
        queries may be delivered much later than the initial request.
	    </t>
    
      <t>  
        More generally, the AMA approach is designed such that it can be 
        deployed in all environments in which the 
        Delay/Disruption-Tolerant (DTN) Bundle Protocol (BPv7) 
        <xref target="I-D.ietf-dtn-bpbis"/> may be deployed.
      </t>

      <section title="Scope" toc="default">
         <t>
            This document describes the motivation, service definitions, 
            desirable properties, roles/responsibilities, system model, and 
            logical data model that form the AMA. These descriptions comprise a
            concept of operations for management in challenged networks with 
            sufficient specificity that implementations conformant with this
            architecture will operate successfully in a challenged networking
            environment. 
          </t>
 
          <t>
            The AMA described herein is strictly a framework for application
			      management over a challenged network. The document is not a
            prescriptive standardization of a physical data model or any
            protocol. Instead, it serves as informative guidance to authors
            and users of such models and protocols.
          </t>

          <t>
            The AMA is independent of transport and network layers. It does not,
            for example, require the use of TCP or UDP. Similarly, the AMA does
            not pre-suppose the use of IPv4 or IPv6.
          </t>

          <t>
            The AMA is not bound to a particular security solution. It is 
            assumed that any network using this architecture supports those
            services such as naming, addressing, integrity, confidentiality, and 
            authentication required to communicate AMA messages. Therefore, the
            transport of these messages is outside of the scope of the AMA.
         </t>
         
         <t>
            While possible that a challenged network may interface with an 
            unchallenged network, this document does not address the concept of 
            compatibility with other management approaches.     
         </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"/>.
         </t>
      </section>
      
      <section title="Organization" toc="default">
         <t>
            The remainder of this document is organized into seven sections 
            that, together, describe an AMA suitable for management of 
            challenged networks. 
              
            The description of each section is as follows.
               
            <list hangIndent="8" style="symbols">
              <t>
                Terminology - This section identifies those terms critical to 
                understanding the proper operation of the AMA. Whenever 
                possible, these terms align in both word selection and meaning 
                with their analogs from other management protocols.
              </t>
              <t>
                Motivation - This section provides an overall motivation for 
                this work as providing a novel and useful alternative to 
                other network management approaches.
              </t>

              <t>
                Service Definitions - This section identifies and defines those
                management services characteristic of managed and managing
                devices that are unique to operating in a challenged 
                environment. 
              </t>
       
              <t> 
                Desirable Properties - This section identifies those properties 
                of a challenged network management system required to 
                effectively implement needed services. These properties guide 
                the subsequent definition of the system and logical models that 
                comprise the AMA.
              </t>

              <t> 
                Roles and Responsibilities - This section identifies roles in 
                the AMA and their associated responsibilities. It provides the 
                context for discussing how management services interact.   
              </t>
                
              <t>
               	Logical Data Model - This section describes the kinds of data, 
                procedures, autonomy, and associated hierarchal structure 
                inherent to the AMA. 
              </t>

              <t> 
                System Model - This section describes data flows amongst 
                various defined AMA roles. These flows capture how the AMA 
                system works to manage devices across a challenged network. 
              </t>
            </list>
         </t>    
      </section>
   </section>
 
   <section title="Terminology" toc="default">
      <t>
        
        <list hangIndent="8" style="symbols">
          <t>
            Actor - A software service running on either managed or managing 
            devices for the purpose of implementing management protocols between 
            such devices. Actors may implement the "Manager" role, "Agent" role, 
            or both.
          </t>

          <t>
            Agent Role (or Agent) - A role associated with a managed device, 
            responsible for reporting performance data, accepting/performing 
            controls, error handling and validation, and executing any 
            autonomous behaviors. AMA Agents exchange information with 
            AMA Managers operating either on the same device or on a remote 
            managing device.
          </t>
			    
          <t>
			      Asynchronous Management - Management that does not depend on 
            stateful connections or real time delivery of management messages. 
            Allows for delivery of management messages and instruction sets for 
            autonomous behavior that governs the expected actions, rules 
            associated with those actions, and expected reporting procedures. 
            Asynchronous management does not depend on underlying transport or 
            network protocols for reliability or addressing of source and 
            destination.
			    </t>
			    
          <t>
			      Asynchronous Management Model (AMM) - data types and data structures 
            needed to manage applications in asynchronous networks.
			    </t>
          
          <t>
            Externally Defined Data (EDD) - Information made available to an 
            AMA Agent by a managed device, but not computed directly by the 
            AMA Agent itself. 
          </t>

          <t>
            Variables (VARs) - Typed information that is computed by an AMA 
            Agent, typically as a function of EDD values and/or other variables.
          </t>

          <t> 
            Constants (CONST) - A constant represents a typed, immutable value 
            that is referred to by a semantic name. Constants are used in 
            situations where substituting a name for a fixed value provides 
            useful semantic information. For example, using the named 
            constant PI rather than the literal value 3.14.
          </t>

          <t>
            Controls (CTRLs) - Procedures run by an AMA Actor to change the 
            behavior, configuration, or state of an application or protocol 
            being asynchronously managed. Controls may also be used to request 
            data from an agent and define the rules associated with generation 
            and delivery.
          </t>

          <t>
            Literals (LITs) - A literal represents a typed value without a 
            semantic name. Literals are used in cases where adding a semantic 
            name to a fixed value provides no useful semantic information. For 
            example, the number 4 is a literal value. 
          </t>

          <t>
            Macros (MACs) - A named, ordered collection of Controls and/or other
            macros. 
          </t>
                       
          <t>
            Manager Role (or Manager) - A role associated with a managing device 
            responsible for configuring the behavior of, and eventually receiving 
            information from, AMA Agents. AMA Managers interact with one or 
            more AMA Agents located on the same device and/or on remote devices 
            in the network.
          </t>

          <t>
            Operator (OP) - The enumeration and specification of a mathematical 
            function used to calculate variable values and construct 
            expressions to evaluate AMA Agent state.
          </t>

          <t>
            Report (RPT) - A typed, ordered collection of data values gathered 
            by one or more AMA Agents and provided to one or more AMA Managers. 
            Reports only contain typed data values and the identity of the 
            Report Template (RPTT) to which they conform.
          </t>

          <t>
            Report Template (RPTT) - A named, typed, ordered collection of data 
            types that represent the structure of a report (RPT). This is the 
            schema for a report, generated by an AMA Manager and communicated 
            to one or more AMA Agents.
          </t>

          <t>
            Rule - A unit of autonomous specification that provides a 
            stimulus-response relationship between time or state on an AMA Agent 
            and the actions or operations to be run as a result of that time or 
            state. A rule might trigger updating a variable, populating a 
				    report, executing a control, or initiating the transmission of a 
            report.
          </t>

          <t>
            State-Based Rule (SBR) - A state-based rule is any rule in which the 
            rule stimulus is triggered by the calculable internal state of data 
            model associated with the AMA Agent. 
          </t>

			    <t>
			      Synchronous Management - Management that assumes messages will be 
            delivered and acted upon in real or near-real-time. Synchronous 
            management often involves immediate replies of acknowledgment or 
            error status. Synchronous management is often bound to underlying 
            transport protocols and network protocols to ensure reliability or 
            source and sender identification.
			    </t>

          <t>
            Table (TBL) - A typed collection of data values organized in a 
            tabular way in which columns represent homogeneous types of data 
            and rows represent unique sets of data values conforming to
            column types. Tables only contain typed data values and the 
            identity of the Table Template (TBLT) to which they conform.  
          </t>

          <t>
            Table Template (TBLT) - A named, typed, ordered collection of 
            columns that comprise the structure for representing tabular data 
            values. This template forms the structure of a table (TBL).
          </t>

          <t>
            Time-Based Rule (TBR) - A time-based rule is a specialization, and 
            simplification, of a state-based rule in which the rule stimulus is 
            triggered by the relative time as it is known on the Agent as a 
            function of either matched value or frequency.
          </t>
        </list>
      </t>
   </section>
    
   <section title="Motivation" toc="default">

    <t>
      Early work into the rationale and motivation for specialized management
      for challenged networks was captured in <xref target="BIRRANE1"/>,
      <xref target="BIRRANE2"/>, and <xref target="BIRRANE3"/>. Some of the 
      properties and feasibility of such a management system were adopted
      from prototyping work done in accordance with the DTN Research Group 
      within the IRTF as documented in <xref target="I-D.irtf-dtnrg-dtnmp"/>. 
    </t>

    <t>
      The unique nature of challenged networks requires new network
      capabilities to deliver expected network functions. For example, the
      unique nature of DTNs required the development of the Bundle Protocol
      for transport functions and the Bundle Protocol Security 
      Protocol (BPSec) is required to secure bundles in certain types of DTNs. 
      Similarly, new management capabilities are needed to implement 
      management in challenged environments, such as those defined as DTNs. 
    </t>

    <t>   
      The AMA provides a method of configuring AMA Agents with local, 
      autonomous management functions to achieve expected behavior when 
      managed devices exist over a challenged network. This architecture 
      makes very few assumptions on the nature of the network and allow for
      continuous operation through periods of connectivity and lack of
      connectivity. The AMA deviates from synchronous management approaches 
      because it never requires periods of bi-directional connectivity. 
    </t>

    <t>
      To understand the unique motivations for the architecture, this section
      discusses motivating characteristics of challenged networks, current
      network management approaches, and how they might behave in a challenged
      environment.
    </t>
    
    <section title="Challenged Networks" toc="default">
      <t>  
        A challenged network is one that "has serious trouble maintaining what
        an application would today expect of the end-to-end IP model" (
        <xref target="RFC7228"/>). This includes cases where there is never 
        simultaneous end-to-end connectivity, when such connectivity is 
        interrupted at planned or unplanned intervals, or when delays exceed
        those that could be accommodated by IP-based transport. Links in such
        networks are often unavailable due to attenuations, propagation delays, 
        mobility, occultation, and other limitations imposed by energy and mass 
        considerations. 
      </t>

      <t>
        Challenged networks exhibit the following properties that impact the
        way in which the function of network management is considered. 

        <list style="symbols">
          <t>No end-to-end path is guaranteed to exist at any given time 
             between any two nodes.</t>
          <t>Round-trip communications between any two nodes within any given 
             time window may be impossible.</t>
          <t>Latencies on the order of seconds, hours, or days may be must be 
             tolerated.</t>
          <t>Links may be uni-directional.</t>
          <t>Bi-directional links may have asymmetric data rates.</t>
        </list>
      </t>

      <t>
        One way in which constrained networks differ from challenged networks
        is the way in which the topology and, otherwise, roles and 
        responsibilities of the network may evolve over time. From the time
        at which data is generated on a source node to the time at which the data
        is received at a destination node, the topology of the network may have
        changed. In certain circumstances, the physical node receiving
        messages for a given node identifier may also have changed. 
      </t>

      <t>
        When this topological change impacts the transport of messages, then
        transports must wait for the incremental connectivity necessary to 
        advance messages along their expected route. Therefore, these networks 
        cannot guarantee that there exist timely data exchange between managing 
        and managed devices. For example, the Bundle Protocol transport
        protocol for use in DTNs implements this type of store-and-forward
        operation. 
      </t>

      <t>
        When topological change impacts the semantic roles and responsibilities
        of nodes in the network, then local configuration and autonomy at nodes
        must be present to determine time-variant changes. For example, the
        BPSec protocol does not encode security destinations and, instead,
        requires nodes in a network to identify as verifiers or acceptors when
        receiving secured messages. 
      </t>

      <t>
        When applied to network management, the semantic roles of Agent and 
        Manager may also change with the changing topology of the network. 
        Individual nodes must implement desirable behavior without reliance on 
        a single oracle of configuration or other coordinating function
        such as an operator-in-the-loop. This implies that there MUST NOT be 
        a defined relationship between a particular manager and agent in 
        a network. 
      </t> 

    </section>
      
    <section title="Current Approaches and Their Limitations" toc="default">
         <t>
            Network management solutions have been prevalent for many years in both local-area
			and wide-area networks. These range from the simplistic ability to configure settings
			of operational devices or report on state and operational conditions; to the more
			more complex modeling of an entire managed device setting, state, and behavior, pushing
			and receiving large sets of configuration data between the manager and the agent.
			Autonomy has more recently been applied to network management but is focused more on
			well resourced, unchallenged networks where devices self-configure, self-heal, and 
			self-optimize with other nodes within their vicinity. This section describes some
			of the well known standardized protocols for network management as well as various 
			proposed solutions and aims to differentiate their purpose with the needs of 
			challenged network management solutions.
         </t>
		 
		
			<section title="Simple Network Management Protocol (SNMP)" toc="default">	
			 <t>
				Historically, network management tools in unchallenged networks provide mechanisms for 
				communicating locally-collected data from devices to operators and managing
				applications, typically using a "pull" mechanism where data must be explicitly 
				requested by a Manager in order to be transmitted by an Agent.   
				A legacy method for management in unchallenged networks today is the 
				Simple Network Management Protocol (SNMP) <xref target="RFC3416"/>.
				SNMP utilizes a 
				request/response model to set and retrieve data values such as host 
				identifiers, link utilizations, error rates, and counters 
				between application software on Agents and Managers.  Data may be directly 
				sampled or consolidated into representative statistics.  
				Additionally, SNMP supports a model for asynchronous notification 
				messages, called traps, based on predefined triggering events.  
				Thus, Managers can query Agents for status information, 
				send new configurations, and be informed when 
				specific events have occurred.  Traps and 
				queryable data are defined in one or more Managed Information 
				Bases (MIBs) which define the information for a particular data 
				standard, protocol, device, or application.
			 </t>

			 <t> 
				While there is a large installation base for SNMP there are several aspects of
				the protocol that make in inappropriate for use in a challenged networking
				environment. SNMP relies on sessions with low round-trip latency to support its "pull"
				model. Complex management can be achieved but only through craftful orchestration 
				using a series of real-time manager generated query and response logic not possible
				in challenged networks.
				The SNMP trap model provides some Agent-side processing, however because the processing
				has very low fidelity and traps are typically "fire and forget."
				Adaptive modifications to SNMP to support challenged networks and more complex
				application-level management, would alter the basic
				function of the protocol (data models, control flows, and syntax)
				so as to be functionally incompatible with existing SNMP 
				installations. Therefore, this approach is not suitable for an asynchronous network management
				system.  
			  </t> 
			</section>

			<section title="YANG, NETCONF, and RESTCONF" toc="default">
				 <t>
					Yet Another Next Generation (YANG) <xref target="RFC6020"/> is a data modeling 
					language used to model configuration and state data of managed devices and applications.
					The YANG model defines a schema for organizing and accessing a device's configuration
					or operational information. Once a model is developed, it is loaded to both the client
					(manager) and server (agent) and serves as a contract between the two. A YANG model can
					be complex, describing many containers of managed elements, each with many configuration
					or operational state data nodes. It can further define lists of like elements. YANG allows 
					for	the definition of parameterized Remote Procedure Calls (RPCs) to be executed on 
					managed	nodes as well as the definition of asynchronous notifications within the model.
				 </t>
				 
				 <t>
					YANG by itself serves no purpose other than to organize data and describe the allowed
					configuration parameters on the managed device. The Network Configuration
					Protocol (NETCONF) <xref target="RFC6241"/>  and the RESTCONF protocol <xref target="RFC8040"/>
					provide the mechanisms to install, manipulate,
					and delete the configuration of network devices, using the YANG modules.
					NETCONF is a stateful, XML-based protocol that provides the RPC syntax to retrieve, 
					edit, copy, or delete any data nodes or exposed functionality on the server. NETCONF
					connections are required to provide authentication, data integreity, confidentiality, 
					and replay protection through secure transport protocols such as SSH or TLS.
					RESTCONF is	a stateless RESTful protocol based on HTTP that uses JSON encoding to GET,
					POST, PUT, PATCH, or DELETE data nodes within the YANG modules similar to NETCONF.
					RESTCONF, while stateless, still requires secure transport such as TLS.
					Both NETCONF and RESTCONF place no specific 
					functional requirements or constraints on the capabilities of the server, which makes it 
					a very flexible tool for configuring a homogeneous network of devices, however they 
					are limting in challenged networks due to their requirements of underlying transport and 
					dependence on the YANG data models.
				 </t>
			   
				  <t>  
					NETCONF places specific constraints on any underlying transport 
					protocol: a long-lived, reliable, low-latency sequenced 
					data delivery session.  This is a fundamental requirement given 
					the RPC-nature of the operating concept, and it is unsustainable 
					in a challenged network. Aspects of the data modeling associated with NETCONF may
					apply to an asynchronous network management system, such that some modeling
					tools may be used, even if the network control plane cannot. 
				 </t>
			 </section>
			 
			<section title="Constrained RESTful Network Management" toc="default">
				<t>
					To talk about COAP and COMI (CoreConf)
				</t>
			</section>
			
			<section title="Autonomous Network Management" toc="default">
				<t>
					To talk about work in anima and nmrg
				</t>
			</section>
		</section>
   
   </section>     
      
   <section title="Desirable Properties of Challenged Network Management" toc="default">     
      <t>
         This section describes those design properties that are desirable when defining
         an architecture that must operate across challenged links in a network. These properties 
         ensure that network management capabilities are retained even as delays and disruptions
         in the network scale. Ultimately, these properties are the driving
         design principles for the AMA.   
      </t>
      
      <section title="Intelligent Push of Information" toc="default">
         <t> 
            Pull management mechanisms require that a Manager send a query 
            to an Agent and then wait for the response to that query. This
            practice implies a control-session between entities and increases
            the overall message traffic in the network. Challenged networks cannot
            guarantee that the roundtrip data-exchange will occur in a timely fashion. In extreme cases, networks
            may be comprised of solely uni-directional links which drastically increases the 
            amount of time needed for a roundtrip data exchange. Therefore, pull mechanisms
            must be avoided in favor of push mechanisms.
           </t>
         <t>
            Push mechanisms, in this context, refer to the ability of Agents to make their own
            determinations in relation to the information that should be sent to 
            Managers. Such mechanisms do not require round-trip communications
            as Managers do not request each reporting instance;
            Managers need only request once, in advance, that information be produced
            in accordance with a predetermined schedule or in response to a predefined
            state on the Agent. In this way information is "pushed" from Agents to 
            Managers and the push is "intelligent" because it is based on some
            internal evaluation performed by the Agent.   
         </t>                  
      </section>
      
      <section title="Minimize Message Size Not Node Processing" toc="default">
         <t> 
            Protocol designers must balance message size versus message processing time at
            sending and receiving nodes. Verbose representations of data simplify node
            processing whereas compact representations require additional activities 
            to generate/parse the compacted message. There is no asynchronous management 
            advantage to minimizing node processing time in a challenged network. 
            However, there is a significant advantage to smaller message sizes in such networks.    
            Compact messages require smaller periods of viable transmission for 
            communication, incur less re-transmission cost, and consume less 
            resources when persistently stored en-route in the network. AMPs
            should minimize PDUs whenever practical,
            to include packing and unpacking binary data, variable-length fields,
            and pre-configured data definitions.    
         </t>         
      </section>
      
      <section title="Absolute Data Identification" toc="default">
         <t>
            Elements within the management system must be uniquely identifiable so
            that they can be individually manipulated. Identification schemes that
            are relative to system configuration make data exchange between
            Agents and Managers difficult as system configurations may change faster 
            than nodes can communicate. 
         </t>
         <t>   
            Consider the following common technique for approximating an associative array 
            lookup. A manager wishing to do an associative lookup for some key K1 will 
            (1) query a list of array keys from the agent, (2) find the key that matches
            K1 and infer the index of K1 from the returned key list, and (3) query the 
            discovered index on the agent to retrieve the desired data. 
         </t>
         <t>
            Ignoring the inefficiency of two pull requests, this 
            mechanism fails when the Agent changes its key-index mapping
            between the first and second query. Rather than constructing an artificial
            mapping from K1 to an index, an AMP must provide an absolute mechanism to
            lookup the value K1 without an abstraction between the Agent and Manager.
         </t>             
      </section>
      
      <section title="Custom Data Definition" toc="default">
         <t>
            Custom definition of new data from existing data (such as through
            data fusion, averaging, sampling, or other mechanisms) provides the
            ability to communicate desired information in as compact a form as
            possible. Specifically, an Agent should not be required to
            transmit a large data set for a Manager that only wishes to
            calculate a smaller, inferred data set. The Agent should calculate
            the smaller data set on its own and transmit that instead. Since 
            the identification of custom data sets is likely to occur in the context 
            of a specific network deployment, AMPs must provide a mechanism for their definition. 
         </t>            
      </section>
      
      <section title="Autonomous Operation" toc="default">
         <t> 
            AMA network functions must be achievable using only knowledge local to 
            the Agent. Rather than directly controlling an Agent, a Manager configures an
            engine of the Agent to take its own action under the
            appropriate conditions in accordance with the Agent's notion of
            local state and time.     
         </t>            
         <t>     
           Such an engine may be used for simple automation of predefined tasks or
           to support semi-autonomous behavior in determining when to run tasks
           and how to configure or parameterize tasks when they are run. Wholly autonomous
           operations MAY be supported where required. Generally,
           autonomous operations should provide the following benefits.
                 
               <list hangIndent="8" style="symbols">
                  <t>
                     Distributed Operation - The concept of pre-configuration 
                     allows the Agent to operate without regular contact with
                     Managers in the system. The initial configuration (and periodic update) of the
                     system remains difficult in a challenged network, but an
                     initial synchronization on stimuli and responses drastically
                     reduces needs for centralized operations. 
                    </t>
                    <t>
                       Deterministic Behavior - Such behavior is
                       necessary in critical operational systems where the actions 
                       of a platform must be well understood even in the absence of
                       an operator in the loop. Depending on the types of
                       stimuli and responses, these systems may be considered
                       to be maintaining simple automation or semi-autonomous behavior.
                       In either case, this preserves the ability of a frequently-out-of-contact Manager to 
                       predict the state of an Agent with more reliability than 
                       cases where Agents implement independent and fully autonomous systems.
                    </t>
                    <t>
                       Engine-Based Behavior - Several operational systems are unable
                       to deploy "mobile code" based solutions due to network
                       bandwidth, memory or processor loading, or security concerns.
                       Engine-based approaches provide configurable behavior without 
                       incurring these types of concerns associated with mobile code.
                    </t>
                 </list>
                 </t>
      </section>
   </section>
  
   <section title="Roles and Responsibilities" toc="default"> 
      <t>
         By definition, Agents reside on managed devices and Managers reside on 
         managing devices. This section describes
         how these roles participate in the network management
         functions outlined in the prior section. 
      </t>
 
      <section title="Agent Responsibilities" toc="default">
         <t hangText="Agent Responsibilities">
            <list hangIndent="8" style="hanging">
               <t hangText="Application Support"> <vspace blankLines="0" />
                  Agents MUST collect all data, execute all procedures, populate
                  all reports and run operations required by each application which the Agent 
                  manages. Agents MUST report supported applications so that Managers in 
                  a network understands what information is understood by what Agent.
               </t>
               
               <t hangText="Local Data Collection"><vspace blankLines="0" />
                  Agents MUST collect from local firmware (or other on-board mechanisms)
                  and report all data defined for the management of applications 
                  for which they have been configured. 
               </t>
                                 
               <t hangText="Autonomous Control"><vspace blankLines="0" />
                  Agents MUST determine, without Manager intervention, whether 
                  a procedure should be invoked. Agents MAY also invoke procedures on other devices for which
                  they act as proxy.
               </t>
              
               <t hangText="User Data Definition"><vspace blankLines="0" />
                  Agents MUST provide mechanisms for operators in the network to
                  use configuration services to create customized data definitions in the context 
                  of a specific network or network
                  use-case. Agents MUST allow for the creation, listing, and
                  removal of such definitions in accordance with whatever
                  security models are deployed within the particular network.
                  <vspace blankLines="1" />
                  Where applicable, Agents MUST verify the validity of these definitions 
                  when they are configured and respond in
                  a way consistent with the logging/error-handling policies
                  of the Agent and the network.
               </t>
             
               <t hangText="Autonomous Reporting"><vspace blankLines="0" /> 
                  Agents MUST determine, without real-time Manager intervention, whether and
                  when to populate and transmit a given report targeted to
                  one or more Managers in the network. 
               </t>
            
               <t hangText="Consolidate Messages"><vspace blankLines="0" />
                  Agents SHOULD produce as few messages as possible when sending information.
                  For example, rather than sending multiple messages, each with one report to a
                  Manager, an Agent SHOULD prefer to send a single message
                  containing multiple reports.
               </t>
         
               <t hangText="Regional Proxy"><vspace blankLines="0" />
                  Agents MAY perform any of their responsibilities on behalf of other network nodes
                  that, themselves, do not have an Agent.  In such a
                  configuration, the Agent acts as a proxy for these
                  other network nodes.
               </t>
            </list>
         </t>
      
      </section>
      
      <section title="Manager Responsibilities" toc="default">
         <t hangText="Manager Responsibilities">
            <list hangIndent="8" style="hanging">
               <t hangText="Agent Capabilities Mapping"><vspace blankLines="0" />
                  Managers MUST understand what applications are managed by the various Agents with
                  which they communicate. Managers should not attempt to
                  request, invoke, or refer to application information for applications
                  not managed by an Agent.
               </t>
        
               <t hangText="Data Collection"><vspace blankLines="0" />
                  Managers MUST receive
                  information from Agents by asynchronously configuring the
                  production of reports and then waiting for, and
                  collecting, responses from Agents over time. Managers MAY
                  try to detect conditions where Agent information has not 
                  been received within operationally relevant time spans and
                  react in accordance with network policy.
               </t>
               
               <t hangText="Custom Definitions"><vspace blankLines="0" /> 
                  Managers should provide the ability to define custom 
                  data definitions. Any custom definitions MUST be
                  transmitted to appropriate Agents and these definitions MUST
                  be remembered to interpret the reporting of these custom
                  values from Agents in the future.
               </t>
               
               <t hangText="Data Translation"><vspace blankLines="0" /> 
                  Managers should
                  provide some interface to other network management
                  protocols. Managers MAY accomplish this by
                  accumulating a repository of push-data from high-latency parts
                  of the network from which data may be pulled by low-latency
                  parts of the network.
               </t>
               
               <t hangText="Data Fusion"><vspace blankLines="0" /> 
                  Managers MAY support the
                  fusion of data from multiple Agents with the purpose of
                  transmitting fused data results to other Managers within the
                  network. Managers MAY receive fused reports from other
                  Managers pursuant to appropriate security and administrative
                  configurations.
               </t>
            </list>
         </t>            
      </section> 

   </section>
    
   <section title="Service Definitions" toc="default">
      <t>
         This section identifies the services that must exist between
         Managers and Agents within an AMA. These services include configuration, 
         reporting, parameterized control, and administration. 
      </t>
      <section title="Configuration" toc="default">
         <t> 
            Configuration services update Agent data associated with managed 
            applications and protocols. Some configuration data might be defined
            in the context of an application or protocol, such that any network
            using that application or protocol would understand that data. Other
            configuration data may be defined tactically for use in a specific 
            network deployment and not available to other networks even if they use
            the same applications or protocols.  
         </t>      
         <t>            
            New configurations received by an Agent must be validated to 
            ensure that they do not conflict with other configurations or would
            otherwise prevent the Agent from effectively working with 
            other Actors in its region. With no guarantee of round-trip data exchange,
            Agents cannot rely on remote Managers to correct erroneous or stale
            configurations from harming the flow of data through a challenged network.
         </t>
         <t>
            Examples of configuration service behavior include the following.
            <list style="symbols">
               <t>Creating a new datum as a function of other well-known data: <vspace /> C = A + B.</t>
               <t>Creating a new report as a unique, ordered collection of known data: <vspace /> RPT = {A, B, C}.</t>
               <t>Storing predefined, parameterized responses to potential future conditions: <vspace /> IF (X > 3) THEN RUN CMD(PARM).</t>
            </list>
         </t>        
      </section>   
        
      <section title="Reporting" toc="default">
         
         <t> 
            Reporting services populate report templates with values
            collected or computed by an Agent. The resultant reports are sent
            to one or more Managers by the Agent. The term "reporting" is used in place of the 
            term "monitoring", as monitoring implies a timeliness and regularity that cannot be
            guaranteed by a challenged network. Reports sent by an Agent provide best-effort 
            information to receiving Managers.            
         </t>
         <t>
            Since a Manager is not actively "monitoring" an Agent, the 
            Agent must make its own determination on when
            to send what Reports based on its own local time
            and state information. Agents should produce Reports of varying
            fidelity and with varying frequency based on thresholds and other
            information set as part of configuration services.
         </t>
         <t>
            Examples of reporting service behavior include the following.
            <list style="symbols">
               <t>Generate Report R1 every hour (time-based production).</t>
               <t>Generate Report R2 when X > 3 (state-based production).</t>
            </list>
         </t>         
      </section> 

      <section title="Autonomous Parameterized Procedure Calls" toc="default">
         <t> 
            Similar to an RPC call, some mechanism MUST exist which allows a procedure
            to be run on an Agent in order to affect its behavior or otherwise change 
            its internal state. 
            Since there is no guarantee that a Manager will be in contact with an
            Agent at any given time, the decisions of whether and when a procedure
            should be run MUST be made locally and autonomously by the Agent. Two
            types of automation triggers are identified in the AMA: triggers based 
            on the internal state of the Agent and triggers based
            on an Agent's notion of time. As such, the autonomous execution of procedures
            can be viewed as a stimulus-response system, where the stimulus is the
            positive evaluation of a state or time based predicate and the response is
            the function to be executed.
         </t>
         <t>
            The autonomous nature of procedure execution by an Agent implies that the
            full suite of information necessary to run a procedure may not be known
            by a Manager in advance. To address this
            situation, a parameterization mechanism MUST be available so that
            required data can be provided at the time of execution on the Agent rather
            than at the time of definition/configuration by the Manager. 
         </t>
         <t>
            Autonomous, parameterized procedure calls provide a powerful 
            mechanism for Managers to "manage" an Agent asynchronously during
            periods of no communication by pre-configuring responses to events that may
            be encountered by the Agent at a future time.             
         </t>
         <t>
            Examples of potential behavior include the following.
            <list style="symbols">
               <t>Updating local routing information based on instantaneous link analysis.</t>
               <t>Managing storage on the device to enforce quotas.</t>
               <t>Applying or modifying local security policy.</t>
            </list>
         </t>
      </section>         
      
      <section title="Administration" toc="default">
         <t> 
            Administration services enforce the potentially complex
            mapping of configuration, reporting, and control services amongst
            Agents and Managers in the network. Fine-grained access controls
            that specify which Managers may apply which services to which Agents 
            may be necessary in networks that either deal with multiple administrative
            entities or overlay networks that cross administrative 
            boundaries. Whitelists, blacklists, key-based infrastructures, or other 
            schemes may be used for this purpose.
         </t>     
         <t>
            Examples of administration service behavior include the following.
            <list style="symbols">
               <t>Agent A1 only Sends reports for Protocol P1 to Manager M1.</t>
               <t>Agent A2 only accepts a configurations for Application Y from Managers M2 and M3.</t>
               <t>Agent A3 accepts services from any Manager providing the proper authentication token.</t>
            </list>
         </t>
         <t>
            Note that the administrative enforcement of access control is different from
            security services provided by the networking stack carrying such messages.
         </t>
      </section>
   </section> 
 
    <section title="Logical Data Model" toc="default">
      
      <t>
         The AMA logical data model captures the types of information that should be collected
         and exchanged to implement necessary roles and responsibilities. 
         The data model presented in this section does not presuppose a specific mapping to
         a physical data model or encoding technique; it is included to provide a way to logically
         reason about the types of data that should be exchanged in an asynchronously managed network. 
      </t>
      
      <t>
         The  elements of the AMA logical data model are described as follows.
      </t>
         
         <section title="Data Representations: Constants, Externally Defined Data, and Variables">
            <t>
               There are three fundamental representations of data in the AMA: (1) data whose values do
               not change as a function of time or state, (2) data whose values change as determined by
               sampling/calculation external to the network management system, and (3) data whose values
               are calculated internal to the network management system.
            </t>
            
            <t>
               Data whose values do not change as a function of time or state are defined as Constants (CONST).
               CONST values are strongly typed, named values that cannot be modified once they have been defined.
            </t>

            <t>
               Data sampled/calculated external to the network management system are defined
               as Externally Defined Data" (EDD). EDD values represent the most useful information
               in the management system as they are provided by the applications or protocols being managed
               on the Agent. It is RECOMMENDED that EDD values be strongly typed to avoid issues
               with interpreting the data value. It is also RECOMMENDED that the timeliness/staleness of the
               data value be considered when using the data in the context of autonomous action
               on the Agent. 
            </t>
            
            <t>
               Data that is calculated internal to the network management system is defined as a
               Variable (VAR). VARs allow the creation of new data values for use in the network management
               system. New value definitions are useful for storing user-defined information, 
               storing the results of complex calculations for easier re-use, and providing a mechanism
               for combining information from multiple external sources. It is RECOMMENDED that VARs
               be strongly typed to avoid issues with interpreting the data value. In cases where a VAR
               definition relies on other VAR definitions, mechanisms to prevent circular references MUST
               be included in any actual data model or implementation.
            </t>
          </section>

          <section title="Data Collections: Reports and Tables">
            <t>
              Individual data values may be exchanged amongst Agents and Managers in the AMA. However,
              data are typically most useful to a Manager when received as part of a set of information.
              Ordered collections of data values can be produced by Agents and sent to Managers as a 
              way of efficiently communicating Agent status. Within the AMA, the structure of the ordered
              collection is treated separately from the values that populate such a structure. 
            </t>

            <t>
              The AMA provides two ways of defining collections of data: reports and tables. Reports are
              ordered sets of data values, whereas Tables are special types of reports whose entries have
              a regular, tabular structure. 
            </t>

            <section title="Report Templates and Reports">
              <t>
                 The typed, ordered structure of a data collection is defined 
                 as a Report Template (RPTT). A particular set of data
                 values provided in compliance with such a template is called 
                 a Report (RPT). 
              </t>
              <t>
                 Separating the structure and content of a report reduces the 
                 overall size of RPTs in cases where reporting structures 
                 are well known and unchanging. RPTTs can be synchronized 
                 between an Agent and a Manager so that RPTs themselves do 
                 not incur the overhead of carrying self-describing data. RPTTs 
                 may include EDD values, VARs, and also other RPTTs. In cases 
                 where a RPTT includes another RPTTs, mechanisms to prevent 
                 circular references MUST be included in any actual data model 
                 or implementation. 
              </t>
              <t>
                 Protocols and applications managed in the AMA may define 
                 common RPTTs. Additionally, users within a network may define 
                 their own RPTTs that are useful in the context of a particular 
                 deployment.
              </t>   
              <t>
                  Unlike tables, reports do not exploit assumptions on the
                  underlying structure of their data. Therefore, unlike
                  tables, operators can define new reports at any time as
                  part of the runtime configuration of the network.
              </t>
            </section>
            <section title="Table Templates and Tables">
              <t>    
                Tables optimize the communication of multiple sets of data 
                in situations where each data set has the same syntactic 
                structure and with the same semantic meaning. Unlike reports, 
                the regularity of tabular data representations allow for the 
                addition of new rows without changing the structure of the 
                table. Attempting to add a new data set at the end of a report 
                would require alterations to the report template.
              </t>
              <t>
                The typed, ordered structure of a table is defined as a Table 
                Template (TBLT). A particular instance of values populating 
                the table template is called a Table (TBL).
              </t>
              <t>
                TBLTs describes the "columns" that define the table schema. 
                A TBL represents the instance of a specific TBLT that holds 
                actual data values. These data values represent the "rows" of
                the table.
              </t>
              <t> 
                 The prescriptive nature of the TBLT allows for the possibility 
                 of advanced filtering which may reduce traffic between Agents 
                 and Managers. However, the unique structure of each TBLT
                 may make them difficult or impossible to change dynamically
                 in a network.
              </t>
            </section>
         </section>

         <section title="Command Execution: Controls and Macros">
            <t>
               Low-latency, high-availability approaches to network management 
               use mechanisms such as (or similar to) RPCs
               to cause some action to be performed on an Agent. The AMA 
               enables similar capabilities without requiring that the Manager 
               be in the processing loop of the Agent. Command execution in the 
               AMA happens through the use of controls and macros.
            </t>
            
            <t>
               A Control (CTRL) represents a parameterized, predefined 
               procedure that can be run on an Agent. While conceptually
               similar to a "remote procedure call", CTRLs differ in that
               they do not provide numeric return codes. The concept of a
               return code when running a procedure implies a synchronous
               relationship between the caller of the procedure and the
               procedure being called, which is disallowed in an asynchronous
               management system. Instead, CTRLs may create reports which 
               describe the status and other summarizations of their operation,
               and these reports may be sent to the Manager(s) calling the
               CTRL. 
            </t>
            <t>
               Parameters can be provided 
               when running a command from a Manager, pre-configured as part of
               an autonomy response on the Agent, or auto-generated as needed 
               on the Agent. The success or failure of a control MAY be inferred 
               by reports generated for that purpose.
            </t>
            
            <t>
              NOTE: The AMA term control is derived in part from
              the concept of Command and Control (C2) where control implies the 
              operational instructions that must be undertaken to implement 
              (or maintain) a commanded objective. An asynchronous management
              function controls an Agent to allow it to fulfill its commanded
              purpose in a variety of operational scenarios. For example, 
              attempting to maintain a safe internal thermal environment for
              a spacecraft is considered "thermal control" (not "thermal 
              commanding") even though thermal control involves "commanding" 
              heaters, louvers, radiators, and other temperature-affecting 
              components.
            </t>

            <t>
               Often, a series of controls must be executed in sequence to 
               achieve a particular outcome. A Macro (MACRO) represents an 
               ordered collection of controls (or other macros). In cases where 
               a MACRO includes another MACRO, mechanisms to prevent circular 
               references and maximum nesting levels MUST be included in
               any actual data model or implementation.
            </t>
         </section>
                 
         <section title="Autonomy: Time and State-Based Rules">
            <t>
            	The AMA data model contains EDDs and VARs that capture the 
              state of applications on an Agent. The model also contains 
              controls and macros to perform actions on an Agent. A mechanism 
              is needed to relate these two capabilities: to perform an action 
              on the Agent in response to the state of the Agent. This mechanism
              in the AMA is the "rule" and can be activated based on Agent
              state (state-based rule) or based on the Agent's notion of
              relative time (time-based rule). 
            </t>
            
            <section title="State-Based Rule (SBR)">
              <t>
                 State-Based Rules (SBRs) perform actions based on the Agent's
                 internal state, as identified by EDD and VAR values. An SBR
                 represents a stimulus-response pairing in the following form: 

                 <vspace blankLines="2"/>
                     
                  IF predicate THEN response 

                 <vspace blankLines="2"/> 
                  
                The predicate is a logical expression that evaluates to true if 
                the rule stimulus is present and evaluates to false otherwise. 
                The response may be any control or macro known to the Agent.
              </t>
              <t> 
                An example of an SBR could be to turn off a heater if some
                internal temperature is greater than a threshold:

                <vspace blankLines="2"/> 
                     
                IF (current_temp &gt; maximum_temp) THEN turn_heater_off

                <vspace blankLines="2"/> 
              </t>
                
              <t>
                Rules may construct their stimuli from the full set of values
                known to the network management system. Similarly, responses 
                may be constructed from the full set of controls and macros that can
                be run on the Agent. By allowing rules to evaluate the variety of all known data
                and run the variety of all known controls, multiple applications can be monitored 
                and managed by one (or few) Agent instances. 
              </t>
            </section>

            <section title="Time-Based Rule (TBR)">
              <t>
                Time-Based Rules (TBR) perform actions based on the Agent's 
                notion of the passage of time. A possible TBR construct would
                be to perform some action at 1Hz on the Agent. 
              </t>
              <t>
                A TBR is a specialization of an SBR as the Agent's notion of
                time is a type of Agent state. For example, a TBR to perform
                an action every 24 hours could be expressed using some type
                of predicate of the form:  

                <vspace blankLines="2"/> 
                IF (((current_time - base_time) % 24_hours) == 0) THEN ...
                <vspace blankLines="2"/> 

                However, time-based events are popular enough that special
                semantics for expressing them would likely significantly 
                reduce the computations necessary to represent time functions
                in a SBR. 
              </t>
            </section>
            
         </section>
         
         <section title="Calculations: Expressions, Literals, and Operators" toc="default">
            <t>
               Actions such as computing a VAR value or describing a rule 
               predicate require some mechanism for calculating the value
               of mathematical expressions. In addition to the aforementioned
               AMA logical data objects, Literals, Operators, and 
               Expressions are used to perform these calculations. 
             </t>

              <t>
               A Literal (LIT) represents a strongly typed datum whose 
               identity is equivalent to its value. An example of a LIT value
               is "4" - its identifier (4) is the same as its value (4). 
               Literals differ from constants in that constants have an 
               identifier separate from their value. For example, the constant 
               PI may refer to a value of 3.14.  However, the literal 3.14159 
               always refers to the value 3.14159. 
              </t>

            <t>
               An Operator (OP) represents a mathematical operation in an 
               expression. OPs should support multiple operands based on the 
               operation supported. A common set of OPs SHOULD be defined for 
               any Agent and systems MAY choose to allow individual
               applications to define new OPs to assist in the generation of 
               new VAR values and predicates for managing that application. OPs 
               may be simple binary operations such as "A + B" or more complex 
               functions such as sin(A) or avg(A,B,C,D). Additionally, OPs 
               may be typed. For example, addition of integers may be defined
               separately from addition of real numbers.
            </t>

             <t>
                An Expression (EXPR) is a combination of operators and operands
                used to construct a numerical value from a series of other 
                elements of the AMA logical model. Operands include any AMA
                logical data model object that can be interpreted as a value, 
                such as EDD, VAR, CONST, and LIT values. Operators perform 
                some function on operands to generate new values. 
             </t>

         </section>
         

      </section>
       
   <section title="System Model" toc="default">
        <t>
           This section describes the notional data flows and control
           flows that illustrate how Managers and Agents within an AMA
           cooperate to perform network management services.
        </t>
      
      <section title="Control and Data Flows" toc="default">
        <t>
           The AMA identifies three significant data flows: control
           flows from Managers to Agents, reports flows from Agents to Managers,
           and fusion reports from Managers to other Managers. These data flows
           are illustrated in <xref target="system_overview" pageno="false" format="default" />.
        </t>
        
        <figure align="center" anchor="system_overview">
          <preamble>AMA Control and Data Flows</preamble>
          <artwork align="center" xml:space="preserve">    
 +---------+       +------------------------+      +---------+        
 | Node A  |       |         Node B         |      |  Node C |
 |         |       |                        |      |         |
 |+-------+|       |+-------+      +-------+|      |+-------+|
 ||       ||=====&gt;&gt;||Manager|====&gt;&gt;|       ||====&gt;&gt;||       ||
 ||       ||&lt;&lt;=====||   B   |&lt;&lt;====|Agent B||&lt;&lt;====||       ||
 ||       ||       |+--++---+      +-------+|      ||Manager||
 || Agent ||       +---||-------------------+      ||   C   ||              
 ||   A   ||           ||                          ||       ||
 ||       ||&lt;&lt;=========||==========================||       ||
 ||       ||===========++========================&gt;&gt;||       ||
 |+-------+|                                       |+-------+|
 +---------+                                       +---------+
             </artwork>
        </figure>
        <t>
         In this data flow, the Agent on node A receives
         Controls from Managers on nodes B and C, and replies with
         Report Entries back to these Managers. Similarly, the Agent on node B
         interacts with the local Manager on node B and the remote Manager on
         node C. Finally, the Manager on node B may fuse Report Entries received
         from Agents at nodes A and B and send these fused Report Entries back to the
         Manager on node C.
        <vspace blankLines="0" />
         From this figure it is clear that there exist many-to-many relationships amongst
         Managers, amongst Agents, and between Agents and Managers. Note that
         Agents and Managers are roles, not necessarily different software
         applications. Node A may represent a single software application
         fulfilling only the Agent role, whereas node B may have a single
         software application fulfilling both the Agent and Manager roles. The
         specifics of how these roles are realized is an implementation matter.
        </t>
      </section>
      
      <section title="Control Flow by Role" toc="default">
        <t>
           This section describes three common configurations of Agents
           and Managers and the flow of messages between them. These
           configurations involve local and remote management and data fusion.
        </t>
        
        <section title="Notation" toc="default">
          <t> The notation outlined in <xref target="ctrl_macros" pageno="false" format="default" /> 
          describes the types of control messages exchanged 
          between Agents and Managers.</t>
          <texttable anchor="ctrl_macros" title="Terminology" suppress-title="false" align="center" style="full">
            <ttcol align="center" width="20%">Term</ttcol>
            <ttcol align="center" width="80%">Definition</ttcol>
            <ttcol align="center" width="20%">Example</ttcol>
            <c>EDD#</c>
            <c>EDD definition.</c>
            <c>EDD1</c>
            <c>V#</c>
            <c>Variable definition.</c>
            <c>V1 = EDD1 + V0.</c>
            <c>DEF([ACL], ID,EXPR)</c>
            <c>Define ID from expression. Allow managers
            in access control list (ACL) to request this ID.</c>
            <c>DEF([*], V1, EDD1 + EDD2)</c>
            <c>PROD(P,ID)</c>
            <c>Produce ID according to predicate 
            P. P may be a time period (1s) or an expression (EDD1 &gt; 10).</c>
            <c>PROD(1s, EDD1)</c>
            <c>RPT(ID)</c>
            <c>A report identified by ID.</c>
            <c>RPT(EDD1)</c>
          </texttable>
        </section>
        
        <section title="Serialized Management" toc="default">
          <t>This is a nominal configuration of network management where a
          Manager interacts with a set of Agents. The control flows for this are
          outlined in <xref target="serial_mgmt_ctrl_flow" pageno="false" format="default" />.</t>
          <figure align="center" anchor="serial_mgmt_ctrl_flow" title="" suppress-title="false" alt="" width="" height="">
            <preamble>Serialized Management Control Flow</preamble>
            <artwork align="center" xml:space="preserve" name="" type="" alt="" width="" height="">    
 +----------+            +---------+           +---------+              
 |  Manager |            | Agent A |           | Agent B |
 +----+-----+            +----+----+           +----+----+
      |                       |                     |
      |-----PROD(1s, EDD1)---&gt;|                     | (1)
      |----------------------------PROD(1s, EDD1)--&gt;|                    
      |                       |                     |
      |                       |                     |
      |&lt;-------RPT(EDD1)------|                     | (2)
      |&lt;----------------------------RPT(EDD1)-------|
      |                       |                     |
      |                       |                     |
      |&lt;-------RPT(EDD1)------|                     |
      |&lt;----------------------------RPT(EDD1)-------|
      |                       |                     |
      |                       |                     |
      |&lt;-------RPT(EDD1)------|                     |
      |&lt;----------------------------RPT(EDD1)-------|
      |                       |                     |
                 </artwork>
            <postamble>In a simple network, a Manager interacts with multiple
            Agents.</postamble>
          </figure>
          <t>
            In this figure, the Manager configures Agents A and B to produce
            EDD1 every second in (1). Upon receiving and configuring this message, Agents A and B then
            build a Report Entry containing EDD1 and send those reports back to the
            Manager in (2). This behavior then repeats this action every 1s without requiring other
            inputs from the Manager.
          </t>
        </section>
        
        <section title="Multiplexed Management" toc="default">
          <t>
            Networks spanning multiple administrative domains may require
            multiple Managers (for example, one per domain). When a
            Manager defines custom Reports/Variables to an Agent, that definition may
            be tagged with an Access Control List (ACL) to limit what other
            Managers will be privy to this information. Managers in such
            networks should synchronize with those other Managers granted access
            to their custom data definitions. When Agents generate messages,
            they MUST only send messages to Managers according to these ACLs, if
            present. The control flows in this scenario are outlined in 
            <xref target="multi_mgmt_ctrl_flow" pageno="false" format="default" />.
         </t>
          <figure align="center" anchor="multi_mgmt_ctrl_flow" title="" suppress-title="false" alt="" width="" height="">
            <preamble>Multiplexed Management Control Flow</preamble>
            <artwork align="center" xml:space="preserve" name="" type="" alt="" width="" height="">    
 +-----------+            +-------+            +-----------+              
 | Manager A |            | Agent |            | Manager B |
 +-----+-----+            +---+---+            +-----+-----+
       |                      |                      |
       |---DEF(A,V1,EDD1*2)--&gt;|&lt;-DEF(B, V2, EDD2*2)--| (1)
       |                      |                      |
       |---PROD(1s, V1)------&gt;|&lt;---PROD(1s, V2)------| (2)
       |                      |                      |
       |&lt;--------RPT(V1)------|                      | (3)
       |                      |--------RPT(V2)------&gt;|
       |&lt;--------RPT(V1)------|                      |
       |                      |--------RPT(V2)------&gt;|
       |                      |                      |
       |                      |&lt;---PROD(1s, V1)------| (4)
       |                      |                      |
       |                      |---ERR(V1 no perm.)--&gt;|   
       |                      |                      |
       |--DEF(*,V3,EDD3*3)---&gt;|                      | (5)
       |                      |                      |
       |---PROD(1s, V3)------&gt;|                      | (6)
       |                      |                      |
       |                      |&lt;----PROD(1s, V3)-----|
       |                      |                      |
       |&lt;--------RPT(V3)------|--------RPT(V3)------&gt;| (7)
       |&lt;--------RPT(V1)------|                      |
       |                      |--------RPT(V2)------&gt;|
       |&lt;-------RPT(V3)-------|--------RPT(V3)------&gt;|
       |&lt;-------RPT(V1)-------|                      |
       |                      |--------RPT(V2)------&gt;|
                 </artwork>
            <postamble>Complex networks require multiple Managers interfacing
            with Agents.</postamble>
          </figure>
 
          <t>
            In more complex networks, any Manager may choose to define custom
            Reports and Variables, and Agents may need to accept such
            definitions from multiple Managers. Variable
            definitions may include an ACL that describes who may query and
            otherwise understand these definitions. In (1), Manager A
            defines V1 only for A while Manager B defines V2 only for B.
            Managers may, then, request the production of Report Entries containing
            these definitions, as shown in (2). Agents produce 
            different data for different Managers in accordance
            with configured production rules, as shown in (3). If a Manager
            requests the production of a custom definition for which the Manager 
             has no permissions, a response
            consistent with the configured logging policy on the Agent should be
            implemented, as shown in (4). Alternatively, as shown in (5), a
            Manager may define custom data with no restrictions allowing all
            other Managers to request and use this definition. This allows all
            Managers to request the production of Report Entries containing this
            definition, shown in (6) and have all Managers receive this and
            other data going forward, as shown in (7).
         </t>
        </section>
        
        <section title="Data Fusion" toc="default">
          <t>
            Data fusion reduces the number and size of messages in the network 
            which can lead to more efficient utilization of networking resources. 
            The AMA supports fusion of NM reports
            by co-locating Agents and Managers on nodes and offloading
            fusion activities to the Manager. This process is illustrated in
            <xref target="fusion_ctrl_flow" pageno="false" format="default" />.
          </t>
          <figure align="center" anchor="fusion_ctrl_flow" title="" suppress-title="false" alt="" width="" height="">
            <preamble>Data Fusion Control Flow</preamble>
            <artwork align="center" xml:space="preserve" name="" type="" alt="" width="" height="">    
+-----------+        +-----------+      +---------+      +---------+               
| Manager A |        | Manager B |      | Agent B |      | Agent C |
+---+-------+        +-----+-----+      +----+----+      +----+----+
    |                      |                 |                |
    |-DEF(A,V0,EDD1+EDD2)-&gt;|                 |                | (1)
    |-PROD(EDD1&amp;EDD2,V0)--&gt;|                 |                |
    |                      |                 |                |
    |                      |--PROD(1s,EDD1)-&gt;|                | (2)
    |                      |------------------PROD(1s, EDD2)-&gt;|
    |                      |                 |                |
    |                      |&lt;---RPT(EDD1)----|                | (3)
    |                      |&lt;------------------RPT(EDD2)------|
    |                      |                 |                |
    |&lt;-----RPT(A,V0)-------|                 |                | (4)
    |                      |                 |                |
                 </artwork>
            <postamble>Data fusion occurs amongst Managers in the
            network.</postamble>
          </figure>
          <t>
            In this example, Manager A requires the production of a Variable 
            V0, from node B, as shown in (1). The Manager role
            understands what data is available from what agents in the subnetwork
            local to B, understanding that EDD1 is available locally and EDD2 is
            available remotely. Production messages are produced in (2) and data
            collected in (3). This allows the Manager at node B to fuse the
            collected Report Entries into V0 and return it in (4). While a
            trivial example, the mechanism of associating fusion with the
            Manager function rather than the Agent function scales with fusion
            complexity, though it is important to reiterate that Agent and
            Manager designations are roles, not individual software components.
            There may be a single software application running on node B
            implementing both Manager B and Agent B roles.
          </t>
        </section>
      </section>
    </section>
           
      
    
    
   <section anchor="IANA" title="IANA Considerations" toc="default">
      <t>
         This protocol has no fields registered by IANA.
        </t>
   </section>
   
   <section anchor="Security" title="Security Considerations" toc="default">
      <t>
         Security within an AMA MUST exist in two layers: transport layer
         security and access control.
      </t>
      
      <t>
         Transport-layer security addresses the questions of authentication,
         integrity, and confidentiality associated with the transport of
         messages between and amongst Managers and Agents in the AMA. This 
         security is applied before any particular Actor in the system 
         receives data and, therefore, is outside of the scope of this document.
      </t>
      
      <t>
        Finer grain application security is done via ACLs which are defined
        via configuration messages and implementation specific.
      </t>
    </section>
  </middle>
  
  <!--  *****BACK MATTER ***** -->
  <back>
    <!-- -<references title="Normative References">
      
     
    </references> -->
  
  <references title="Informative References">
   &RFC3416;
   &RFC2119;
   &RFC6241;
   &RFC7228;
   &RFC6020;
   &RFC8040;
     
   <reference anchor="RFC4838">
      <front>
         <title>Delay-Tolerant Networking Architecture</title>
         <author initials="V." surname="Cerf" fullname="V. Cerf"/>
         <author initials="S." surname="Burleigh" fullname="S. Burleigh"/>
         <author initials="A." surname="Hooke" fullname="A. Hooke"/>
         <author initials="L." surname="Torgerson" fullname="L. Torgerson"/>
         <author initials="R." surname="Durst" fullname="R. Durst"/>
         <author initials="K." surname="Scott" fullname="K. Scott"/>
         <author initials="K." surname="Fall" fullname="K. Fall"/>
         <author initials="H." surname="Weiss" fullname="H. Weiss"/>
         <date year="2007" month="April" />
      </front>
      <seriesInfo name="RFC" value="4838" />
      <format type="TXT" octets="89265" target="http://www.rfc-editor.org/rfc/rfc4838.txt" />
   </reference>
     
   <reference anchor="BIRRANE1">
      <front>
         <title>
            Management of Disruption-Tolerant Networks: A Systems Engineering 
            Approach
         </title>
         <author initials="E.B." surname="Birrane"/>
         <author initials="R.C." surname="Cole"/>
         <date year="2010"/>
      </front>     
   </reference>
   
   <reference anchor="BIRRANE2">
      <front>
         <title>
            Defining Tolerance: Impacts of Delay and Disruption when Managing 
            Challenged Networks
         </title>
         <author initials="E.B." surname="Birrane"/>
         <author initials="S.B." surname="Burleigh"/>
         <author initials="V.C." surname="Cerf"/>
         <date year="2011" />
      </front>
    </reference>
      
    <reference anchor="BIRRANE3">
      <front>
         <title>
            Delay-Tolerant Network Management: The Definition and Exchange of
            Infrastructure Information in High Delay Environments
         </title>
         <author initials="E.B." surname="Birrane"/>
          <author initials="H.K." surname="Kruse"/>
          <date year="2011" />
        </front>
      </reference> 
            
    <?rfc include="reference.I-D.draft-irtf-dtnrg-dtnmp-01"?>
	<?rfc include="reference.I-D.draft-ietf-dtn-bpbis-31"?>
      
  </references>
  
  </back>
</rfc>