<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
<!ENTITY rfc2119 PUBLIC '' 
  'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml'>
]>

<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>

<?rfc toc="yes"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc iprnotified="no"?>
<?rfc strict="yes"?>
<?rfc compact="yes" ?> 
<?rfc subcompact="yes" ?>

<rfc category="info" ipr="trust200902" docName="draft-jlg-detnet-5gs-01">

<front>
<title abbrev="5GS DetNet Node">DetNet YANG Model Extension for 5GS as a Logical DetNet Node</title>

<author initials="T." surname="Jiang" fullname="Tianji Jiang">
<organization>China Mobile</organization>
<address>
<email>tianjijiang@chinamobile.com</email>
</address>
</author>

<author fullname="Peng Liu" initials="P." surname="Liu"> 
<organization>China Mobile</organization> 
<address> 
	<email>liupengyjy@chinamobile.com</email> </address> 
</author>

<author fullname="Xuesong Geng" initials="X." surname="Geng">
<organization>Huawei Technologies</organization> 
<address> 
 <email>gengxuesong@huawei.com</email> </address> 
</author>



<!-- month and day will be generated automatically by XML2RFC; be sure the year is current.-->
<!-- date month="June" year="2023"/ --> 
<date year="2023"/>
<area>Routing Area</area> 
<workgroup>Detnet Working Group</workgroup>

<abstract>
<t>
 The 3GPP Rel-18 has completed the working item (WID) of the DetNet, i.e., the Deterministic Network.  
 This WID defines and standardizes how a 5G system (5GS) may behave as a logical DetNet
 transit node, as well as how a 5GS DetNet node may integrate into the IP deterministic network domain.	
 A 5GS logical DetNet node bears the ‘composite’ architecture in that it could act as one or
 more DetNet routers.  While the 3GPP work has referenced the IETF Detnet YANG model draft 
 for the purpose of provisioning the DetNet traffic parameters to a 5GS logical DetNet node, the
 per-(logical)-node parameter provisioning needs to be further improved.
 This draft defines some new DetNet YANG parameters, e.g., the type of a (composite) DetNet node, the
 composite node ID, and the flow direction within a composite (5GS logical) node, 
 via reusing the existing IETF DetNet 
 YANG model. Toward the end, we also discuss some complicated 5GS related DetNet scenarios that would be
   considered for future extensions.
	
</t>
</abstract>
</front>

<middle>
<section title="Introduction">
<t>
Recently the 3GPP Rel-18 has completed the working item (WID) of the DetNet, i.e., the Deterministic Network. This WID defines and standardizes how a 5G system (5GS) may behave as a logical DetNet node, as well as how a 5GS DetNet node may integrate into the IP-domain deterministic network. As of now, the Rel-18 has only realized the functionalities of the DetNet forwarding sub-layer <xref target="TS.23.501"/>.
</t>

    <section anchor="5gsDetnetLogicalNode">
      <name>5GS – A Logical DetNet Transit Node</name>
      	<t>
		  As shown in the <xref target="fig:5gsLogicalDetnetNode"/>, the 5G system or 5GS is a logical DetNet transit node that are comprised of various 5G network functions or NFs, e.g. AMF, SMF, UPF, PCF, etc. It behaves holistically as a transparent box
		  to external networks (as demarcated by the dotted box in 
		  the <xref target="fig:5gsLogicalDetnetNode"/>), and can be integrated with the IP deterministic network as defined in IETF RFC 8655 <xref target="RFC8655"/>. The 5G NF TSCTSF performs mappings in the control plane between the 5GS internal NFs and the DetNet controller in the IP domain. As a black box-like transit node, the 5GS specific procedures in both the 5G core (i.e., 5GC) and the radio access network (i.e., RAN) remain hidden from the IP DetNet controller.
		</t>

		<figure anchor="fig:5gsLogicalDetnetNode" title="A 5GS Logical DetNet Node">
			<artwork><![CDATA[

                ..........................................
               :         +-----+           +--------+    :   +----------+ 
               :         | UDM |           | TSCTSF |--------|CPF:DetNet|  
               :         +-----+           +--------+    :   |Controller| 
               :         /      \               |        :   +----------+
               :        N8       N10            |N84     :
               :      +-----+     +------+    +-----+    :
               :      | AMF |-N11-|  SMF |-N7-| PCF |    :
               :      +-----+     +------+    +-----+    :
               :      /    |             |               :
               :     N1   N2             N4              :
               :    /      |             |               :
   +--------+  :   /       |        +-------+            :
   | DetNet |  +----+  +-------+ N3 |(NW-TT)| N6 (UP)    :    +--------+  
   | System |--| UE |--| (R)AN |----|       |------------:----| DetNet |  
   +--------+  +----+  +-------+    |  UPF  |            :    | Network|                           
               :                    +-------+            :    +--------+
               :                     |    |              :
               :                     +-N9-+              :
               ...........................................
	    ]]>
			</artwork>
		</figure>

		<t>
		   The 5GS logical DetNet node, as a whole,
		   has two types of external-facing interfaces, i.e., the device-side ports or DS-TT, and the network-side ports or NW-TT. On the device side, a UE via its DS-TT ports connects with external DetNet entities, which might be DetNet end systems or full-fledged IP DetNet nodes (e.g., IP DetNet routers). This scenario would be a typical deployment for small businesses to achieve deterministic network connectivity via 5G wireless services. On the network side, the NW-TT functionalities could co-exist with the 5G NF UPF, though it is not mandatory. A NW-TT port is connected via the 5G data-plane to external DetNet domain (most likely, the IP deterministic network).
		</t>
		<t>
		  Note that there is a need of coordination between the 5GS mobile operator and the IP-domain service provider to support various functionalities, e.g., AAA, signaling exchange, etc. This is currently based on the assumption of the existence of a pre-determined business agreement between the two parties to support the interactions between the 5GS TSCTSF and the IP DetNet controller <xref target="TS.23.501"/>. The interface between the TSCTSF and the DetNet controller uses protocols defined in IETF. The DetNet configuration is carried in the YANG model <xref target="IETF-Draft.DetNet.Yang"/>
		</t>
    </section>

    <section anchor="5gsCompositeArchitecture">
      <name>Composite Architecture of a 5GS Logical DetNet Node</name>
      	<t>
      	  As shown in the <xref target="fig:5gsCompositeNode"/>, a 5GS (composite) node (or so-tagged ‘bridge’ in the figure) is composed of the ports on the UPF network side (i.e., NW-TT), the user plane tunnels between the UE and UPF (i.e., PDU sessions), and the ports on the device side (i.e., DS-TT). For a 5GS DetNet node, the NW-TT ports, the DS-TT ports and the correspondingly associated PDU Sessions together support the 5GS connectivity to the deterministic network.
      	</t>

      			<figure anchor="fig:5gsCompositeNode" title="5GS DetNet Node Composite Architecture">
			<artwork><![CDATA[

               PDU-S: PDU Session
               ..................................................
               : Bridge_A                 +-------+  +-------+  :
               :               [PDU-S]    | UPF-A |--| NW_TT |  :
   +--------+  :                    /-----+-------+  +-------+--\ 
   |        |  : +-----+  +-----+--/                            :\---+--------+  
   |        |----|DS_TT|--|     |                               :    |        |  
   | DetNet |  : +-----+  | UE1 |                               :    |        |
   | System |  ...........| ... |................................    | DetNet |
   |        |             |     |                                    |        |
   |        |  ...........| ... |................................    | System |                           
   |        |  : +-----+  |     | [PDU-S]                       :    |        |
   |        |----|DS_TT|--|     |-----\   +-------+  +-------+  :/---+--------+
   +--------+  : +-----+  +-----+      \--|       |--|       |--/
               :                          | UPF-B |  | NW_TT |  :
               :          +-----+         |       |--|       |  :
   +--------+  : +-----+  |     |      /--+-------+  +-------+  :
   | DetNet |----|DS_TT|--| UE2 |-----/                         :
   | System |  : +-----+  |     | [PDU-S]                       :
   +--------+  :          +-----+                               :
               :                                                :
               : Bridge_B                                       :
               ..................................................

	    ]]>
			</artwork>
		</figure>

      	<t>
	      According to 3GPP TS 23.501 <xref target="TS.23.501"/>, a 5GS logical DetNet node bears the ‘composite’ architecture in that it could act as one or more DetNet routers upon the integration into the IP-domain deterministic network.  The granularity of 
	      determining a 5GS DetNet node is per UPF for each network instance, or per DNN/S-NSSAI in 3GPP term. 
	      For example, in the <xref target="fig:5gsCompositeNode"/>, there are two 5GS DetNet nodes 
	      corresponding respectively to two UPFs, i.e., the UPF-A matching to the DetNet node ‘Bridge-A’ 
	      and the UPF-B matching to the DetNet node ‘Bridge B’, respectively. 
	      A 5GS DetNet node may be identified by the corresponding UPF node ID. 
		</t>
	</section>

	<section anchor="5gsYangConfigProvisioning">
      <name>YANG Configuration Provisioning of 5GS Logical DetNet Node</name>
		<t>
		  The 5GS NF TSCTSF maps the configuration parameters in the format of DetNet YANG model, e.g., DetNet flow attributes, DnTrafficSpec, DnFlowReqs, DnMaxLatency, DnMaxLoss, etc., that are provided from the IP-domain DetNet controller (so-tagged as ‘CPF:DetNet Conoller’ 
		  in the <xref target="fig:5gsLogicalDetnetNode"/>), to 5GS parameters as defined in TS 23.503 <xref target="TS.23.503"/>. Once the provisioning is completed, the TSCTSF provides a response to the (IP-domain) DetNet controller regarding the (success or failure) status of the configuration setup. 
		 </t>
		 <t>
		  As of the completion of the 3GPP Rel-18 work, the IETF DetNet YANG model draft <xref target="IETF-Draft.DetNet.Yang"/> has been identified and referenced for the purpose of provisioning the DetNet traffic parameters to a 5GS logical DetNet node. This IETF draft standardizes the specification of the DetNet YANG model for configuration and operational data of a DetNet flow so as to provision the end-to-end service on devices along the path. However, from the perspective of 5GS-being-a-logical-DetNet-node, the QoS requirements, e.g., max-latency, max-loss, etc., have to be (5GS) node-specific. As such, this discrepancy led to liaison exchanges between the 3GPP SA2 and the IETF DetNet working groups <xref target="Liaison.3GPP-2-IETF"/> <xref target="Liaison.IETF-2-3GPP"/>. Due to unfavourable comments by the IETF DetNet WG, 3GPP decided to pursue the 3GPP-centric extension to the IETF draft <xref target="IETF-Draft.DetNet.Yang"/>, and plan to define a YANG model by importing <xref target="IETF-Draft.DetNet.Yang"/> with the addition of 3GPP related DetNet specific parameters. The 3GPP defined YANG model will use the 3GPP namespace as defined in IETF RFC 5279 <xref target="RFC5279"/>.
		 </t>
		 <t>
		  However, this special 3GPP-extension handling bears a limited scope and will be tailored only for 3GPP and 5GS DetNet node. The per-(logical)-node DetNet traffic parameters are general traffic characteristics that should be standardized best in the IETF DetNet WG. Fortunately, there is an IETF DetNet WG draft that works on defining a YANG data model for DetNet topology discovery and capability configuration on the per-(logical)-node basis <xref target="IETF-Draft.Topology.Yang"/>. We have presented and discussed the draft in the IETF-116, and authors of the draft have been revising it since then. As a consequence, the 3GPP SA2 DetNet team have thus discussed this draft <xref target="IETF-Draft.Topology.Yang"/> and agreed to improve the 5GS standards once the draft matures.
		</t>
	</section>

</section> <!-- End of the Introduction section -->


<section anchor="Enhance5gsYang" title="Enhance DetNet YANG Configuration for 5GS Logical Node">
	<t>
	Apart from the lack of configuring per-(logical)-node parameters as mentioned in the <xref target="5gsYangConfigProvisioning"/>, we also believe that, based on the requirements of 3GPP extension, the standardized operations of a 5GS DetNet node shall be improved with the definition of certain new DetNet YANG parameters, e.g., the type of a (composite) DetNet node, the composite node ID, and the flow direction within a 5GS logical node. 
	</t>
	
	<section anchor="5gsYangNodeType">
		<name>Type of a DetNet node</name>
		<t>
		The 3GPP document TR 23.700-46 <xref target="TR.23.700-46"/> concludes to define the type of a 5GS DetNet node. It claims to be useful for the IP-domain DetNet controller to identify that the 5GS node is a 3GPP defined 5GS system, rather than a router with fixed interfaces only. This knowledge can be useful for the DetNet controller to consider for the QoS that can be provided for a flow. 

		Further, the node-type parameter can be generalized to other non-5GS scenarios. For example, the application of some advanced features, e.g., network slicing, virtual-router setting, etc., would divide a single physical node into multiple logical nodes, for which the node-type parameter will help a DetNet controller do better provisioning.
		</t>
	</section>

	<section anchor="5gsYangCompositeNodeID">
		<name>Composite node ID &amp; DetNet node ID</name>
		<t>
		As we have explained in the <xref target="5gsCompositeArchitecture"/>, a 5GS logical DetNet node bears the ‘composite’ architecture in that it could act as one or more DetNet routers to the IP-domain Deterministic Network.  The granularity of the 5GS DetNet node (or router) is per UPF, and a 5GS DetNet node may be identified by the corresponding UPF node ID. Thus, it would be better to define a
		new parameter to differentiate the higher-level composite nature of a 5GS node.
		</t>	
	</section>

	<section anchor="5gsYangDirectionUpDown">
		<name>Directions of 5GS DetNet parameters: Uplink vs. Downlink</name>
		<t>
		The <xref target="5gsCompositeArchitecture"/> illustrates that a 5GS DetNet router can be comprised of the NW-TT ports, the user plane (UP) tunnels between the UE and UPF, and the DS-TT ports. This corresponds roughly to directional, i.e., either Uplink/UL or Downlink/DL, associations among ports and tunnels. TS 23.501 <xref target="TS.23.501"/> specifies that the 5GS NF TSCTSF uses the identities of the incoming and outgoing interfaces, i.e., DS-TT and NW-TT ports, to determine whether the direction is uplink or downlink. 

		For DetNet related parameters, e.g., per-node max-loss, per-node max-latency, etc., they might have asymmetric settings between the UL and DL directions. So, we propose to define a 'direction' parameter in the enhanced YANG model.
		</t>		
	</section>

	<section anchor="5gsYangModelInfoExposure">
		<name>YANG Model for 5GS Information Exposure</name>
		<t>
		The spec. 3GPP TS 23.501 also standardizes the reporting scheme of a 5GS DetNet node to the IP-domain DetNet controller. Basically, a 5GS DetNet node may provide exposure information to the IP-domain DetNet controller using information collected from the 5GS entities. The exposure information can be used by the DetNet controller to build up the network topology (of a holistic DetNet domain). The exposure may be based on IETF RFC 8343 <xref target="RFC8343"/> and IETF RFC 8344 <xref target="RFC8344"/>. Note that while the configuration provisioning and the information reporting involve the opposite directions of data flow between a 5GS and a DetNet controller, there is no material difference in term of the YANG model definition in either direction. Therefore, we do not need to differentiate them in our YANG model enhancement.
		</t>
	</section>
</section> <!-- End of section of 'Enhance DetNet YANG Config for 5GS Logic Node' -->


<section anchor="5gsYangModelDefinition" title="YANG Model Definition of 5GS as a logical DetNet node">
	
	 <t>
	  Based on the proposed enhancements in <xref target="Enhance5gsYang"/>, 
	  this section defines how to reuse the existing IETF Yang model in
      the scenario of 5GS as a logical DetNet node. As described in RFC 8340 <xref target="RFC8340"/>, topology
      Yang model allows the configuration of overlay networks on top of the
      underlay networks, through supporting network, supporting nodes,
      supporting links, etc. The 5GS could be treated as an underlay network
      and used as a logical node in the layer 3 DetNet system.
     </t>
     <t>
      [Editor's Notes]: This version just provides the basic idea of what
      attributes are requested. The formal yang model will be defined in the
      following version.
     </t>
	
	 <section>
        <name>5GS as a logical DetNet node: Augment Composite-Node-Type and Direction in IETF YANG Model</name>
        <t>
          <figure>
            <artwork><![CDATA[augment "/nw:networks/nw:network/nw:node/nw:termination-point/nw:supporting-termination-point "{
description 
"5GS Composite Node Type";

  leaf 5gs-composite-node-type {
     type bool;
     description
       "Describe whether the node is 5GS Composite Node ";
  }

  leaf 5gs-direction {
     type bool;
     description
       "Describe whether the node is downstream ";
  }
}
]]></artwork>
          </figure>        
        </t>
     </section>

     <section>
        <name>5GS as a logical DetNet node: Composite-Node-ID in YANG Model</name>

        <t>
        	Reuse the attribute of &ldquo;node-id&rdquo; defined in RFC 8340<xref target="RFC8340"/>.
        </t>
     </section>


</section> <!-- End of section for 5GS YANG Model Definition -->


<section anchor="5GSFutureConsideration" 
	title="Discussions upon Supporting More Complicated 5GS DetNet Scenarios">
	<t>
	There are some complicated 5GS related DetNet scenarios that would be considered for future extensions.
	</t>
	
	<section anchor="5gsYangBindingRelationship">
		<name>DetNet YANG for the Binding Relationship</name>
		<t>
		As explained in the <xref target="5gsCompositeArchitecture"/>, a 5GS DetNet router champions the binding relationships that consist of DS-TT ports, user-plane tunnels between UEs and UPF, and NW-TT ports. The binding information is stored in the 5GS NF TSCTSF (see the <xref target="fig:5gsLogicalDetnetNode"/>). Evidently, this ‘binding’ is not restricted to a standalone, fixed port or an individual UP tunnel. Instead, it indicates an integrated ‘association’ among multiple entities to provide the DetNet service as a whole. Accordingly, the corresponding definition of the YANG model in this scenario should not be independent for each entity, but be considered holistically. This is different from how the normal DetNet (topology) YANG model defines for a node, a port and a Link Termination Point <xref target="IETF-Draft.Topology.Yang"/>.
		</t>
	</section>

	<section anchor="5gsYangFramedRoute">
		<name>DetNet YANG for Framed-route</name>
		<t>
		A 5GS (logical) DetNet node as specified in the Rel-18 can transport IP packets destined not only to the UE's IP address or prefix, but also to a range of IPv4 addresses or IPv6 IP prefixes that have been allocated to end devices which can be reached via their DS-TT ports. 
		That is, as shown in the <xref target="fig:5gsCompositeNode"/>, 
		those end devices are located in the DetNet system beyond DS-TT ports (toward the left). This advanced scenario is termed as ‘Framed Route’ in TS 23.501 <xref target="TS.23.501"/>. In field, this is a very useful deployment case in which enterprise-based customers, connected via 5GS DS-TT ports, could achieve deterministic network services provisioned by a 5GS (logical) DetNet node. 
		</t>
		<t>
		As per 5GS standard, for DS-TT ports, the framed-route information, i.e., the additional IP addresses or IP prefixes, are not directly assigned to but reachable via the ports. The 5GS NF TSCTSF has to expose the information to and also coordinate with the IP-domain DetNet controller in order to correctly map flows beyond the UE. This is a unique scenario for YANG modelling since the YANG definitions in this situation have to embrace the entities that are not within the physical boundary of, but being controllable by, a (5GS) DetNet node. 
		</t>
	</section>

	<section anchor="5gsRel19Proposal">
		<name>5GS DetNet Extension for Future 3GPP Release</name>
		<t>
		As we have mentioned previously, the 3GPP Rel-18 has so far only realized the functionalities of the DetNet forwarding sub-layer, without supporting the DetNet service sub-layer functions. Along with the recent maturity and then the adoption of service-layer drafts in the IETF DetNet WG, 3GPP may pursue extensions in future release to align with the IETF DetNet work by standardizing the service-layer functions in a 5GS (logical) DetNet node. E.g., those proposals may apply either multi-UE devices or multi-UE multi-connection schemes with redundancy paths to achieve the PREOF.
		</t>
	</section>
</section> <!-- End of section for 5GS DetNet Future Considerations -->

<section title="Security Considerations">
<t>Generally, this function will not incur additional security issues.</t>
</section>

<section title="IANA Considerations">
<t>This document makes no request of IANA.</t>
</section>

</middle>


<back>

<references title="Normative References">
<?rfc include="reference.RFC.5279.xml" ?>
<?rfc include="reference.RFC.8340.xml" ?>
<?rfc include="reference.RFC.8343.xml" ?>
<?rfc include="reference.RFC.8344.xml" ?>
<?rfc include="reference.RFC.8655.xml" ?>

<reference anchor="TS.23.501">
        <front>
          <title>3GPP TS 23.501 (V18.2.1): System Architecture for the 5G System (5GS)</title>

          <author initials="3GPP">
            <organization/>
          </author>

          <date month="June" year="2023"/>
        </front>

        <seriesInfo name="" value="3GPP TS 23.501"/>
</reference>

<reference anchor="TS.23.503">
        <front>
          <title>3GPP TS 23.503 (V18.2.0): Policy and charging control framework for the 5G System (5GS); Stage 2 </title>

          <author initials="3GPP">
            <organization/>
          </author>

          <date month="June" year="2023"/>
        </front>

        <seriesInfo name="" value="3GPP TS 23.503"/>
</reference>

<reference anchor="TR.23.700-46">
        <front>
          <title>3GPP TR 23.700-46 (V18.0.0): Study on 5GS Deterministic Networking (DetNet) interworking</title>
          <author initials="3GPP">
            <organization/>
          </author>
          <date month="March" year="2023"/>
        </front>

        <seriesInfo name="" value="3GPP TR 23.700-46"/>
</reference>

<reference anchor="IETF-Draft.DetNet.Yang">
        <front>
          <title>Deterministic Networking (DetNet) YANG Model</title>

          <author initials="X" surname="Geng">
            <organization/>
          </author>

          <author initials="Y" surname="Ryoo">
            <organization/>
          </author>

          <author initials="D" surname="Fedyk">
            <organization/>
          </author>

          <author initials="R" surname="Rahman">
            <organization/>
          </author>

          <author initials="Z" surname="Li">
            <organization/>
          </author>

          <date month="April" year="2023"/>
        </front>

        <seriesInfo name="" value="draft-ietf-detnet-yang-17"/>
</reference>

<reference anchor="IETF-Draft.Topology.Yang">
        <front>
          <title>Deterministic Networking (DetNet) Topology YANG Model</title>

          <author initials="X" surname="Geng">
            <organization/>
          </author>

          <author initials="M" surname="Chen">
            <organization/>
          </author>

          <author initials="Z" surname="Li">
            <organization/>
          </author>

          <author initials="R" surname="Rahman">
            <organization/>
          </author>

          <date month="April" year="2023"/>
        </front>

        <seriesInfo name="" value="draft-ietf-detnet-topology-yang-01"/>
</reference>

</references>	

<references title="Informative References">
<reference anchor="Liaison.3GPP-2-IETF">
        <front>
          <title>LS on 3GPP 5G System acting as a Detnet node</title>

          <author initials="3GPP">
            <organization/>
          </author>

          <date month="October" year="2022"/>
        </front>

        <seriesInfo name="" value="https://datatracker.ietf.org/liaison/1800/"/>
</reference>

<reference anchor="Liaison.IETF-2-3GPP">
        <front>
          <title>Response to 3GPP SA2 LS on 3GPP 5G System acting as a DetNet node</title>

          <author initials="IETF">
            <organization/>
          </author>

          <date month="February" year="2023"/>
        </front>

        <seriesInfo name="" value="https://datatracker.ietf.org/liaison/1816/"/>
</reference>

</references>	

</back>
</rfc>

