-The version of the UNI Manager (UNIMgr) plug-in included in OpenDaylight
-Boron release is experimental, serving as a proof-of-concept (PoC)
-for using features of OpenDaylight to provision networked elements with
-attributes satisfying Metro Ethernet Forum (MEF) requirements for
-delivery of Carrier Ethernet service. This initial version of UNIMgr
-does not enable the full set of MEF-defined functionality for Carrier
-Ethernet service. UNI Manager adheres to a minimum set of functionality
-defined by MEF 7.2 and 10.2 specifications.
-
-UNIMgr receives a request from applications to create an Ethernet
-Private Line (EPL) private Ethernet connection between two endpoints on
-the network. The request must include the IP addresses of the endpoints
-and a class of service identifier.
-
-UNI Manager plug-in translates the request for EPL service into (a)
-configuring two instances of Open vSwitch (OVS), each instance running
-in one of the UNI endpoints, with two ports and a bridge between the
-ports, and (b) creating a GRE tunnel to provide a private connection
-between the endpoints. This initial version of UNIMgr uses only OVSDB on
-its southbound interface to send configuration commands.
-
-UNIMgr also accepts a bits per second datarate parameter, which is
-translated to an OVSDB command to limit the rate at which the OVS
-instances will forward data traffic.
-
-The YANG module used to create the UNIMgr plug-in models MEF-defined UNI
-and Ethernet Virtual Connection (EVC) attributes but does not include
-the full set of UNI and EVC attributes. And of the attributes modeled in
-the YANG module only a subset of them are implemented in the UNIMgr
-listener code translating the Operational data tree to OVSDB commands.
-The YANG module used to develop the PoC UNIMgr plug-in is
-cl-unimgr-mef.yang. A copy of this module is available in the
-odl-unimgr-api bundle of the UNIMgr project.
-
-Limitations of the PoC version of UNI Manager in OpenDaylight Boron
-include those listed below: \* Uses only OVSDB southbound interface of
-OpenDaylight \* Only uses UNI ID, IP Address, and speed UNI attributes
-\* Only uses a subset of EVC per UNI attributes \* Does not use MEF
-Class of Service or Bandwidth Profile attributes \* Configures only Open
-vSwitch network elements
-
-Opportunities for evolution of the UNI Manager plug in include using
-complete MEF Service Layer and MEF Resource Layer YANG models and
-supporting other OpenDaylight southbound protocols like NetConf and
-OpenFlow.
-
-UNI Manager Components
-----------------------
-
-UNI Manager is comprised of the following OpenDaylight Karaf features:
+The User Network Interface (UNI) Manager project within OpenDaylight provides
+data models and APIs that enable software applications and service
+orchestrators to configure and provision connectivity services; in particular,
+Carrier Ethernet services as defined by MEF Forum, in physical and virtual
+network elements.
+
+MEF has defined the Lifecycle Service Orchestration (LSO) Reference
+Architecture for the management and control of domains and entities that enable
+cooperative network services across one or more service provider networks. The
+architecture also identifies LSO Reference Points, which are the logical points
+of interaction between specific functional management components. These LSO
+Reference Points are further defined by interface profiles and instantiated by
+APIs.
+
+The LSO Reference Architecture is shown below. Note that this is a functional
+architecture that does not describe how the management components are
+implemented (e.g., single vs. multiple instances), but rather identifies
+management components that provide logical functionality as well as the points
+of interaction among them.
+
+.. figure:: ./images/unimgr-lso-arch.png
+ :alt: MEF LSO Reference Architecture
+
+ MEF LSO Reference Architecture
+
+Unimgr provides support for both the Legato as well as the Presto interfaces.
+These interfaces, and the APIs associated with them, are defined by YANG models
+developed within MEF in collaboration with ONF and IETF. For the Carbon release,
+these are as follows:
+
+Legato YANG modules:
+https://git.opendaylight.org/gerrit/gitweb?p=unimgr.git;a=tree;f=legato-api/src/main/yang;hb=refs/heads/stable/carbon
+
+Presto YANG modules:
+https://git.opendaylight.org/gerrit/gitweb?p=unimgr.git;a=tree;f=presto-api/src/main/yang;hb=refs/heads/stable/carbon
+
+An application/user can interact with Unimgr at either the service
+orchestration layer (Legato) or the network resource provisioning layer
+(Presto).
+
+Unimgr Architecture
+-------------------
+
+Unimgr is comprised of the following OpenDaylight Karaf features: