X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?p=transportpce.git;a=blobdiff_plain;f=docs%2Fdeveloper-guide.rst;fp=docs%2Fdeveloper-guide.rst;h=ca95df191d6ef4ecb078cdcb89b22823c0e5bd64;hp=1e6e5d3080246dde822c36336065e99c14b7d24e;hb=70335a7069e419b4a7cbc311a5d801a01a2b717c;hpb=b752c6e59b386787552b0fbb6f84c42933ed5faf diff --git a/docs/developer-guide.rst b/docs/developer-guide.rst index 1e6e5d308..ca95df191 100644 --- a/docs/developer-guide.rst +++ b/docs/developer-guide.rst @@ -472,9 +472,9 @@ through the NETCONF connector. Connecting nodes ~~~~~~~~~~~~~~~~ -To connect a node, use the following JSON RPC +To connect a node, use the following RESTconf request -**REST API** : *POST /restconf/config/network-topology:network-topology/topology/topology-netconf/node/* +**REST API** : *PUT /rests/data/network-topology:network-topology/topology=topology-netconf/node=* **Sample JSON Data** @@ -506,7 +506,7 @@ To connect a node, use the following JSON RPC Then check that the netconf session has been correctly established between the controller and the node. the status of **netconf-node-topology:connection-status** must be **connected** -**REST API** : *GET /restconf/operational/network-topology:network-topology/topology/topology-netconf/node/* +**REST API** : *GET /rests/data/network-topology:network-topology/topology=topology-netconf/node=?content=nonconfig* Node configuration discovery @@ -517,9 +517,9 @@ discovery of the node configuration datastore and creates **Logical Connection P physical ports related to transmission. All *circuit-packs* inside the node configuration are analyzed. -Use the following JSON RPC to check that function internally named *portMapping*. +Use the following RESTconf URI to check that function internally named *portMapping*. -**REST API** : *GET /restconf/config/portmapping:network* +**REST API** : *GET /rests/data/transportpce-portmapping:network* .. note:: @@ -550,26 +550,26 @@ created by transportPCE. Nevertheless, depending on the configuration inside opt topology can be partial. Check that link of type *ROADMtoROADM* exists between two adjacent rdm nodes. -**REST API** : *GET /restconf/config/ietf-network:network/openroadm-topology* +**REST API** : *GET /rests/data/ietf-network:networks/network=openroadm-topology* If it is not the case, you need to manually complement the topology with *ROADMtoROADM* link using the following REST RPC: -**REST API** : *POST /restconf/operations/networkutils:init-roadm-nodes* +**REST API** : *POST /rests/operations/transportpce-networkutils:init-roadm-nodes* **Sample JSON Data** .. code:: json { - "networkutils:input": { - "networkutils:rdm-a-node": "", - "networkutils:deg-a-num": "", - "networkutils:termination-point-a": "", - "networkutils:rdm-z-node": "", - "networkutils:deg-z-num": "", - "networkutils:termination-point-z": "" + "input": { + "rdm-a-node": "", + "deg-a-num": "", + "termination-point-a": "", + "rdm-z-node": "", + "deg-z-num": "", + "termination-point-z": "" } } @@ -581,21 +581,21 @@ following REST RPCs: From xpdr to rdm: ^^^^^^^^^^^^^^^^^ -**REST API** : *POST /restconf/operations/networkutils:init-xpdr-rdm-links* +**REST API** : *POST /rests/operations/transportpce-networkutils:init-xpdr-rdm-links* **Sample JSON Data** .. code:: json { - "networkutils:input": { - "networkutils:links-input": { - "networkutils:xpdr-node": "", - "networkutils:xpdr-num": "1", - "networkutils:network-num": "", - "networkutils:rdm-node": "", - "networkutils:srg-num": "", - "networkutils:termination-point-num": "" + "input": { + "links-input": { + "xpdr-node": "", + "xpdr-num": "1", + "network-num": "", + "rdm-node": "", + "srg-num": "", + "termination-point-num": "" } } } @@ -603,21 +603,21 @@ From xpdr to rdm: From rdm to xpdr: ^^^^^^^^^^^^^^^^^ -**REST API** : *POST /restconf/operations/networkutils:init-rdm-xpdr-links* +**REST API** : *POST /rests/operations/transportpce-networkutils:init-rdm-xpdr-links* **Sample JSON Data** .. code:: json { - "networkutils:input": { - "networkutils:links-input": { - "networkutils:xpdr-node": "", - "networkutils:xpdr-num": "1", - "networkutils:network-num": "", - "networkutils:rdm-node": "", - "networkutils:srg-num": "", - "networkutils:termination-point-num": "" + "input": { + "links-input": { + "xpdr-node": "", + "xpdr-num": "1", + "network-num": "", + "rdm-node": "", + "srg-num": "", + "termination-point-num": "" } } } @@ -629,7 +629,7 @@ Before creating an OTN service, your topology must contain at least two xpdr dev or SWITCH type connected to two different rdm devices. To check that these xpdr are present in the OTN topology, use the following command on the REST API : -**REST API** : *GET /restconf/config/ietf-network:network/otn-topology* +**REST API** : *GET /rests/data/ietf-network:networks/network=otn-topology* An optical connectivity service shall have been created in a first setp. Since Magnesium SR2, the OTN links are automatically populated in the topology after the Och, OTU4 and ODU4 interfaces have