From 2176fcc5a3fe08b51eee800007235cb26cf367ea Mon Sep 17 00:00:00 2001
From: Blake Harnden <32446120+bharnden@users.noreply.github.com>
Date: Mon, 5 Jun 2023 13:57:06 -0700
Subject: [PATCH] docs: adding tutorial 7

---
 docs/static/tutorial7/scenario.png            | Bin 0 -> 51422 bytes
 docs/tutorials/tutorial7.md                   | 236 ++++++++++++++++++
 mkdocs.yml                                    |   1 +
 .../examples/tutorials/tutorial7/scenario.py  |  52 ++++
 .../examples/tutorials/tutorial7/scenario.xml |  90 +++++++
 .../tutorials/tutorial7/scenario_service.py   |  53 ++++
 .../tutorials/tutorial7/scenario_service.xml  |  91 +++++++
 7 files changed, 523 insertions(+)
 create mode 100644 docs/static/tutorial7/scenario.png
 create mode 100644 docs/tutorials/tutorial7.md
 create mode 100644 package/examples/tutorials/tutorial7/scenario.py
 create mode 100644 package/examples/tutorials/tutorial7/scenario.xml
 create mode 100644 package/examples/tutorials/tutorial7/scenario_service.py
 create mode 100644 package/examples/tutorials/tutorial7/scenario_service.xml

diff --git a/docs/static/tutorial7/scenario.png b/docs/static/tutorial7/scenario.png
new file mode 100644
index 0000000000000000000000000000000000000000..1c677aa339468cac652ac0ce0bf26822f4c92944
GIT binary patch
literal 51422
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%0Db;=*ts
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
COG@1U

literal 0
HcmV?d00001

diff --git a/docs/tutorials/tutorial7.md b/docs/tutorials/tutorial7.md
new file mode 100644
index 00000000..89a84555
--- /dev/null
+++ b/docs/tutorials/tutorial7.md
@@ -0,0 +1,236 @@
+# Tutorial 7 - EMANE
+
+## Overview
+
+This tutorial will cover basic usage and some concepts one may want to
+use or leverage when working with and creating EMANE based networks.
+
+<p align="center">
+  <img src="/static/tutorial7/scenario.png" width="75%">
+</p>
+
+For more detailed information on EMANE see the following:
+
+* [EMANE in CORE](../emane.md)
+* [EMANE Wiki](https://github.com/adjacentlink/emane/wiki)
+
+## Files
+
+Below is a list of the files used for this tutorial.
+
+* 2 node EMANE ieee80211abg scenario
+    * scenario.xml
+    * scenario.py
+* 2 node EMANE ieee80211abg scenario, with **n2** running the "Chat App Server" service
+    * scenario_service.xml
+    * scenario_service.py
+
+## Running this Tutorial
+
+This section covers interactions that can be carried out for this scenario.
+
+Our scenario has the following nodes and addresses:
+
+* emane1 - no address, this is a representative node for the EMANE network
+* n2 - 10.0.0.1
+* n3 - 10.0.0.2
+
+All usages below assume a clean scenario start.
+
+### Using Ping
+
+Using the command line utility **ping** can be a good way to verify connectivity
+between nodes in CORE.
+
+* Make sure the CORE daemon is running a terminal, if not already
+    ``` shell
+    sudop core-daemon
+    ```
+* In another terminal run the GUI
+    ``` shell
+    core-gui
+    ```
+* In the GUI menu bar select **File->Open...**, then navigate to and select **scenario.xml**
+   <p align="center">
+     <img src="/static/tutorial-common/running-open.png" width="75%">
+   </p>
+* You can now click on the **Start Session** button to run the scenario
+   <p align="center">
+     <img src="/static/tutorial7/scenario.png" width="75%">
+   </p>
+* Open a terminal on **n2** by double clicking it in the GUI
+* Run the following in **n2** terminal
+    ``` shell
+    ping -c 3 10.0.0.2
+    ```
+* You should see the following output
+    ``` shell
+    PING 10.0.0.2 (10.0.0.2) 56(84) bytes of data.
+    64 bytes from 10.0.0.2: icmp_seq=1 ttl=64 time=7.93 ms
+    64 bytes from 10.0.0.2: icmp_seq=2 ttl=64 time=3.07 ms
+    64 bytes from 10.0.0.2: icmp_seq=3 ttl=64 time=3.05 ms
+
+    --- 10.0.0.2 ping statistics ---
+    3 packets transmitted, 3 received, 0% packet loss, time 2000ms
+    rtt min/avg/max/mdev = 3.049/4.685/7.932/2.295 ms
+    ```
+
+### Using Tcpdump
+
+Using **tcpdump** can be very beneficial for examining a network. You can verify
+traffic being sent/received among many other uses.
+
+* Make sure the CORE daemon is running a terminal, if not already
+    ``` shell
+    sudop core-daemon
+    ```
+* In another terminal run the GUI
+    ``` shell
+    core-gui
+    ```
+* In the GUI menu bar select **File->Open...**, then navigate to and select **scenario.xml**
+   <p align="center">
+     <img src="/static/tutorial-common/running-open.png" width="75%">
+   </p>
+* You can now click on the **Start Session** button to run the scenario
+   <p align="center">
+     <img src="/static/tutorial7/scenario.png" width="75%">
+   </p>
+* Open a terminal on **n2** by double clicking it in the GUI
+* Open a terminal on **n3** by double clicking it in the GUI
+* Run the following in **n3** terminal
+    ``` shell
+    tcpdump -lenni eth0
+    ```
+* Run the following in **n2** terminal
+    ``` shell
+    ping -c 1 10.0.0.2
+    ```
+* You should see the following in **n2** terminal
+    ``` shell
+    tcpdump: verbose output suppressed, use -v[v]... for full protocol decode
+    listening on eth0, link-type EN10MB (Ethernet), snapshot length 262144 bytes
+    14:56:25.414283 02:02:00:00:00:01 > 02:02:00:00:00:02, ethertype IPv4 (0x0800), length 98: 10.0.0.1 > 10.0.0.2: ICMP echo request, id 64832, seq 1, length 64
+    14:56:25.414303 02:02:00:00:00:02 > 02:02:00:00:00:01, ethertype IPv4 (0x0800), length 98: 10.0.0.2 > 10.0.0.1: ICMP echo reply, id 64832, seq 1, length 64
+    ```
+
+### Running Software
+
+We will now leverage the installed Chat App software to stand up a server and client
+within the nodes of our scenario.
+
+* Make sure the CORE daemon is running a terminal, if not already
+    ``` shell
+    sudop core-daemon
+    ```
+* In another terminal run the GUI
+    ``` shell
+    core-gui
+    ```
+* In the GUI menu bar select **File->Open...**, then navigate to and select **scenario.xml**
+   <p align="center">
+     <img src="/static/tutorial-common/running-open.png" width="75%">
+   </p>
+* You can now click on the **Start Session** button to run the scenario
+   <p align="center">
+     <img src="/static/tutorial7/scenario.png" width="75%">
+   </p>
+* Open a terminal on **n2** by double clicking it in the GUI
+* Run the following in **n2** terminal
+    ``` shell
+    export PATH=$PATH:/usr/local/bin
+    chatapp-server
+    ```
+* Open a terminal on **n3** by double clicking it in the GUI
+* Run the following in **n3** terminal
+    ``` shell
+    export PATH=$PATH:/usr/local/bin
+    chatapp-client -a 10.0.0.1
+    ```
+* You will see the following output in **n1** terminal
+    ``` shell
+    chat server listening on: :9001
+    [server] 10.0.0.1:44362 joining
+    ```
+* Type the following in **n2** terminal and hit enter
+    ``` shell
+    hello world
+    ```
+* You will see the following output in **n1** terminal
+    ``` shell
+    chat server listening on: :9001
+    [server] 10.0.0.2:44362 joining
+    [10.0.0.2:44362] hello world
+    ```
+
+### Tailing a Log
+
+In this case we are using the service based scenario. This will automatically start
+and run the Chat App Server on **n2** and log to a file. This case will demonstrate
+using `tail -f` to observe the output of running software.
+
+* Make sure the CORE daemon is running a terminal, if not already
+    ``` shell
+    sudop core-daemon
+    ```
+* In another terminal run the GUI
+    ``` shell
+    core-gui
+    ```
+* In the GUI menu bar select **File->Open...**, then navigate to and select **scenario_service.xml**
+   <p align="center">
+     <img src="/static/tutorial-common/running-open.png" width="75%">
+   </p>
+* You can now click on the **Start Session** button to run the scenario
+   <p align="center">
+     <img src="/static/tutorial7/scenario.png" width="75%">
+   </p>
+* Open a terminal on **n2** by double clicking it in the GUI
+* Run the following in **n2** terminal
+    ``` shell
+    tail -f chatapp.log
+    ```
+* Open a terminal on **n3** by double clicking it in the GUI
+* Run the following in **n3** terminal
+    ``` shell
+    export PATH=$PATH:/usr/local/bin
+    chatapp-client -a 10.0.0.1
+    ```
+* You will see the following output in **n2** terminal
+    ``` shell
+    chat server listening on: :9001
+    [server] 10.0.0.2:44362 joining
+    ```
+* Type the following in **n3** terminal and hit enter
+    ``` shell
+    hello world
+    ```
+* You will see the following output in **n2** terminal
+    ``` shell
+    chat server listening on: :9001
+    [server] 10.0.0.2:44362 joining
+    [10.0.0.2:44362] hello world
+    ```
+
+## Advanced Topics
+
+This section will cover some high level topics and examples for running and
+using EMANE in CORE. You can find more detailed tutorials and examples at
+the [EMANE Tutorial](https://github.com/adjacentlink/emane-tutorial/wiki).
+
+!!! note
+
+    Every topic below assumes CORE, EMANE, and OSPF MDR have been installed.
+
+    Scenario files to support the EMANE topics below will be found in
+    the GUI default directory for opening XML files.
+
+| Topic                                   | Model   | Description                                               |
+|-----------------------------------------|---------|-----------------------------------------------------------|
+| [XML Files](../emane/files.md)          | RF Pipe | Overview of generated XML files used to drive EMANE       |
+| [GPSD](../emane/gpsd.md)                | RF Pipe | Overview of running and integrating gpsd with EMANE       |
+| [Precomputed](../emane/precomputed.md)  | RF Pipe | Overview of using the precomputed propagation model       |
+| [EEL](../emane/eel.md)                  | RF Pipe | Overview of using the Emulation Event Log (EEL) Generator |
+| [Antenna Profiles](../emane/antenna.md) | RF Pipe | Overview of using antenna profiles in EMANE               |
+
+--8<-- "tutorials/common/grpc.md"
diff --git a/mkdocs.yml b/mkdocs.yml
index 74bfd331..4879e09e 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -42,6 +42,7 @@ nav:
       - Setup: tutorials/setup.md
       - Tutorial 1: tutorials/tutorial1.md
       - Tutorial 4: tutorials/tutorial4.md
+      - Tutorial 7: tutorials/tutorial7.md
   - Detailed Topics:
       - GUI: gui.md
       - Node Types:
diff --git a/package/examples/tutorials/tutorial7/scenario.py b/package/examples/tutorials/tutorial7/scenario.py
new file mode 100644
index 00000000..6c4125ed
--- /dev/null
+++ b/package/examples/tutorials/tutorial7/scenario.py
@@ -0,0 +1,52 @@
+from core.api.grpc import client
+from core.api.grpc.wrappers import Position, Interface, NodeType
+from core.emane.models.ieee80211abg import EmaneIeee80211abgModel
+
+
+def main():
+    # interface helper
+    iface_helper = client.InterfaceHelper(ip4_prefix="10.0.0.0/24", ip6_prefix="2001::/64")
+
+    # create grpc client and connect
+    core = client.CoreGrpcClient()
+    core.connect()
+
+    # create session
+    session = core.create_session()
+
+    # create nodes
+    position = Position(x=375, y=500)
+    emane_net = session.add_node(
+        _id=1,
+        _type=NodeType.EMANE,
+        name="emane1",
+        position=position,
+        emane=EmaneIeee80211abgModel.name
+    )
+    position = Position(x=250, y=250)
+    node2 = session.add_node(_id=2, model="mdr", name="n2", position=position)
+    position = Position(x=500, y=250)
+    node3 = session.add_node(_id=3, model="mdr", name="n3", position=position)
+
+    # create links to emane
+    node2_iface = iface_helper.create_iface(node_id=node2.id, iface_id=0)
+    node2_iface.ip4 = "10.0.0.1"
+    node2_iface.ip4_mask = 32
+    node2_iface.ip6 = "2001::1"
+    node2_iface.ip6_mask = 128
+    # emane_iface1 = Interface(id=0)
+    session.add_link(node1=node2, node2=emane_net, iface1=node2_iface)
+    node3_iface = iface_helper.create_iface(node_id=node3.id, iface_id=0)
+    node3_iface.ip4 = "10.0.0.2"
+    node3_iface.ip4_mask = 32
+    node3_iface.ip6 = "2001::2"
+    node3_iface.ip6_mask = 128
+    # emane_iface2 = Interface(id=1)
+    session.add_link(node1=node3, node2=emane_net, iface1=node3_iface)
+
+    # start session
+    core.start_session(session=session)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/package/examples/tutorials/tutorial7/scenario.xml b/package/examples/tutorials/tutorial7/scenario.xml
new file mode 100644
index 00000000..721a7b8f
--- /dev/null
+++ b/package/examples/tutorials/tutorial7/scenario.xml
@@ -0,0 +1,90 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<scenario name="/tmp/tmpmewk97ls">
+  <networks>
+    <network id="1" name="emane1" icon="" canvas="1" model="emane_ieee80211abg" type="EMANE">
+      <position x="375.0" y="500.0" />
+    </network>
+  </networks>
+  <devices>
+    <device id="2" name="n2" icon="" canvas="1" type="mdr" class="" image="">
+      <position x="250.0" y="250.0" />
+      <configservices>
+        <service name="zebra"/>
+        <service name="OSPFv3MDR"/>
+        <service name="IPForward"/>
+      </configservices>
+    </device>
+    <device id="3" name="n3" icon="" canvas="1" type="mdr" class="" image="">
+      <position x="500.0" y="250.0" />
+      <configservices>
+        <service name="zebra"/>
+        <service name="OSPFv3MDR"/>
+        <service name="IPForward"/>
+      </configservices>
+    </device>
+  </devices>
+  <links>
+    <link node1="2" node2="1">
+      <iface1 nem="1" id="0" name="eth0" mac="02:02:00:00:00:01" ip4="10.0.0.1" ip4_mask="32" ip6="2001::1" ip6_mask="128"/>
+    </link>
+    <link node1="3" node2="1">
+      <iface1 nem="2" id="0" name="eth0" mac="02:02:00:00:00:02" ip4="10.0.0.2" ip4_mask="32" ip6="2001::2" ip6_mask="128"/>
+    </link>
+  </links>
+  <configservice_configurations>
+    <service name="zebra" node="2"/>
+    <service name="OSPFv3MDR" node="2"/>
+    <service name="IPForward" node="2"/>
+    <service name="zebra" node="3"/>
+    <service name="OSPFv3MDR" node="3"/>
+    <service name="IPForward" node="3"/>
+  </configservice_configurations>
+  <session_origin lat="47.579166412353516" lon="-122.13232421875" alt="2.0" scale="150.0"/>
+  <session_options>
+    <configuration name="controlnet" value=""/>
+    <configuration name="controlnet0" value=""/>
+    <configuration name="controlnet1" value=""/>
+    <configuration name="controlnet2" value=""/>
+    <configuration name="controlnet3" value=""/>
+    <configuration name="controlnet_updown_script" value=""/>
+    <configuration name="enablerj45" value="1"/>
+    <configuration name="preservedir" value="0"/>
+    <configuration name="enablesdt" value="0"/>
+    <configuration name="sdturl" value="tcp://127.0.0.1:50000/"/>
+    <configuration name="ovs" value="0"/>
+    <configuration name="platform_id_start" value="1"/>
+    <configuration name="nem_id_start" value="1"/>
+    <configuration name="link_enabled" value="1"/>
+    <configuration name="loss_threshold" value="30"/>
+    <configuration name="link_interval" value="1"/>
+    <configuration name="link_timeout" value="4"/>
+    <configuration name="mtu" value="0"/>
+  </session_options>
+  <session_metadata>
+    <configuration name="shapes" value="[]"/>
+    <configuration name="edges" value="[]"/>
+    <configuration name="hidden" value="[]"/>
+    <configuration name="canvas" value="{&quot;gridlines&quot;: true, &quot;canvases&quot;: [{&quot;id&quot;: 1, &quot;wallpaper&quot;: null, &quot;wallpaper_style&quot;: 1, &quot;fit_image&quot;: false, &quot;dimensions&quot;: [1000, 750]}]}"/>
+  </session_metadata>
+  <default_services>
+    <node type="mdr">
+      <service name="zebra"/>
+      <service name="OSPFv3MDR"/>
+      <service name="IPForward"/>
+    </node>
+    <node type="PC">
+      <service name="DefaultRoute"/>
+    </node>
+    <node type="prouter"/>
+    <node type="router">
+      <service name="zebra"/>
+      <service name="OSPFv2"/>
+      <service name="OSPFv3"/>
+      <service name="IPForward"/>
+    </node>
+    <node type="host">
+      <service name="DefaultRoute"/>
+      <service name="SSH"/>
+    </node>
+  </default_services>
+</scenario>
diff --git a/package/examples/tutorials/tutorial7/scenario_service.py b/package/examples/tutorials/tutorial7/scenario_service.py
new file mode 100644
index 00000000..1f8b0f72
--- /dev/null
+++ b/package/examples/tutorials/tutorial7/scenario_service.py
@@ -0,0 +1,53 @@
+from core.api.grpc import client
+from core.api.grpc.wrappers import Position, Interface, NodeType
+from core.emane.models.ieee80211abg import EmaneIeee80211abgModel
+
+
+def main():
+    # interface helper
+    iface_helper = client.InterfaceHelper(ip4_prefix="10.0.0.0/24", ip6_prefix="2001::/64")
+
+    # create grpc client and connect
+    core = client.CoreGrpcClient()
+    core.connect()
+
+    # create session
+    session = core.create_session()
+
+    # create nodes
+    position = Position(x=375, y=500)
+    emane_net = session.add_node(
+        _id=1,
+        _type=NodeType.EMANE,
+        name="emane1",
+        position=position,
+        emane=EmaneIeee80211abgModel.name
+    )
+    position = Position(x=250, y=250)
+    node2 = session.add_node(_id=2, model="mdr", name="n2", position=position)
+    node2.config_services.add("ChatApp Server")
+    position = Position(x=500, y=250)
+    node3 = session.add_node(_id=3, model="mdr", name="n3", position=position)
+
+    # create links to emane
+    node2_iface = iface_helper.create_iface(node_id=node2.id, iface_id=0)
+    node2_iface.ip4 = "10.0.0.1"
+    node2_iface.ip4_mask = 32
+    node2_iface.ip6 = "2001::1"
+    node2_iface.ip6_mask = 128
+    # emane_iface1 = Interface(id=0)
+    session.add_link(node1=node2, node2=emane_net, iface1=node2_iface)
+    node3_iface = iface_helper.create_iface(node_id=node3.id, iface_id=0)
+    node3_iface.ip4 = "10.0.0.2"
+    node3_iface.ip4_mask = 32
+    node3_iface.ip6 = "2001::2"
+    node3_iface.ip6_mask = 128
+    # emane_iface2 = Interface(id=1)
+    session.add_link(node1=node3, node2=emane_net, iface1=node3_iface)
+
+    # start session
+    core.start_session(session=session)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/package/examples/tutorials/tutorial7/scenario_service.xml b/package/examples/tutorials/tutorial7/scenario_service.xml
new file mode 100644
index 00000000..da2cb8e8
--- /dev/null
+++ b/package/examples/tutorials/tutorial7/scenario_service.xml
@@ -0,0 +1,91 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<scenario name="/tmp/tmpmewk97ls">
+  <networks>
+    <network id="1" name="emane1" icon="" canvas="1" model="emane_ieee80211abg" type="EMANE">
+      <position x="375.0" y="500.0" />
+    </network>
+  </networks>
+  <devices>
+    <device id="2" name="n2" icon="" canvas="1" type="mdr" class="" image="">
+      <position x="250.0" y="250.0" />
+      <configservices>
+        <service name="zebra"/>
+        <service name="OSPFv3MDR"/>
+        <service name="IPForward"/>
+        <service name="ChatApp Server"/>
+      </configservices>
+    </device>
+    <device id="3" name="n3" icon="" canvas="1" type="mdr" class="" image="">
+      <position x="500.0" y="250.0" />
+      <configservices>
+        <service name="zebra"/>
+        <service name="OSPFv3MDR"/>
+        <service name="IPForward"/>
+      </configservices>
+    </device>
+  </devices>
+  <links>
+    <link node1="2" node2="1">
+      <iface1 nem="1" id="0" name="eth0" mac="02:02:00:00:00:01" ip4="10.0.0.1" ip4_mask="32" ip6="2001::1" ip6_mask="128"/>
+    </link>
+    <link node1="3" node2="1">
+      <iface1 nem="2" id="0" name="eth0" mac="02:02:00:00:00:02" ip4="10.0.0.2" ip4_mask="32" ip6="2001::2" ip6_mask="128"/>
+    </link>
+  </links>
+  <configservice_configurations>
+    <service name="zebra" node="2"/>
+    <service name="OSPFv3MDR" node="2"/>
+    <service name="IPForward" node="2"/>
+    <service name="zebra" node="3"/>
+    <service name="OSPFv3MDR" node="3"/>
+    <service name="IPForward" node="3"/>
+  </configservice_configurations>
+  <session_origin lat="47.579166412353516" lon="-122.13232421875" alt="2.0" scale="150.0"/>
+  <session_options>
+    <configuration name="controlnet" value=""/>
+    <configuration name="controlnet0" value=""/>
+    <configuration name="controlnet1" value=""/>
+    <configuration name="controlnet2" value=""/>
+    <configuration name="controlnet3" value=""/>
+    <configuration name="controlnet_updown_script" value=""/>
+    <configuration name="enablerj45" value="1"/>
+    <configuration name="preservedir" value="0"/>
+    <configuration name="enablesdt" value="0"/>
+    <configuration name="sdturl" value="tcp://127.0.0.1:50000/"/>
+    <configuration name="ovs" value="0"/>
+    <configuration name="platform_id_start" value="1"/>
+    <configuration name="nem_id_start" value="1"/>
+    <configuration name="link_enabled" value="1"/>
+    <configuration name="loss_threshold" value="30"/>
+    <configuration name="link_interval" value="1"/>
+    <configuration name="link_timeout" value="4"/>
+    <configuration name="mtu" value="0"/>
+  </session_options>
+  <session_metadata>
+    <configuration name="shapes" value="[]"/>
+    <configuration name="edges" value="[]"/>
+    <configuration name="hidden" value="[]"/>
+    <configuration name="canvas" value="{&quot;gridlines&quot;: true, &quot;canvases&quot;: [{&quot;id&quot;: 1, &quot;wallpaper&quot;: null, &quot;wallpaper_style&quot;: 1, &quot;fit_image&quot;: false, &quot;dimensions&quot;: [1000, 750]}]}"/>
+  </session_metadata>
+  <default_services>
+    <node type="mdr">
+      <service name="zebra"/>
+      <service name="OSPFv3MDR"/>
+      <service name="IPForward"/>
+    </node>
+    <node type="PC">
+      <service name="DefaultRoute"/>
+    </node>
+    <node type="prouter"/>
+    <node type="router">
+      <service name="zebra"/>
+      <service name="OSPFv2"/>
+      <service name="OSPFv3"/>
+      <service name="IPForward"/>
+    </node>
+    <node type="host">
+      <service name="DefaultRoute"/>
+      <service name="SSH"/>
+    </node>
+  </default_services>
+</scenario>