Changes between Version 20 and Version 21 of Nmm2022/Agenda/perfSONARuse

Timestamp:

Jul 17, 2022, 3:47:39 PM (2 years ago)

Author:

admin

Comment:

--

Nmm2022/Agenda/perfSONARuse

@@ -136 +136 @@
 == Displaying Measurements with MaDDash in a Single Measurement Node == 
 
-
+The default perfSONAR toolkit installation comes with esmond archiver installed and the measurement results are archived by default at the node itself. The archive can be accessed through the RESTful API from the below URL,
+
+https://[perfSONAR-IP]/esmond/perfsonar/archive/
+
+So we have nothing to do with archive configuration. Now we will install required MaDDash packages since they are not bundled with perfSONAR toolkit.
+
+sudo yum install epel-release http://software.internet2.edu/rpms/el7/x86_64/latest/packages/perfSONAR-repo-0.10-1.noarch.rpm
+sudo yum clean all
+sudo yum install maddash
+sudo yum install perfsonar-psconfig-maddash
+
+Here you need to open some ports on linux firewall which is require for MaDDash web and esmond archiver.
+
+{{{
+firewall-cmd --permanent --add-port=80/tcp
+firewall-cmd --permanent --add-port=443/tcp
+firewall-cmd --reload
+}}}
+
+Next we have to create a pSConfig template for feeding measurement tasks to the perfSONAR node. Sample templates can be found at /usr/share/doc/perfsonar/psconfig/ on the central measurement archive server. skeleton.json is basic sample configuration file to start with. Below is the configuration file that we are going to use in this installation.
+
+
+{{{
+{
+   "_meta":{
+      "display-name":"LEARN Measurements",
+      "psconfig-publisher":{
+         "publish-source":"psconfig-publish-cli",
+         "publish-time":"2022-07-13T00:26:07+00:00"
+      }
+   },
+   "addresses":{
+      "PS":{
+         "address":"PS_IP"
+      },
+      "NSRC":{
+         "address":"perfsonar.nsrc.org"
+      },
+      "NORDUnet":{
+         "address":"perfsonar-ps.ndgf.org"
+      }
+   },
+   "archives":{
+      "example_esmond_archive":{
+         "archiver":"esmond",
+         "data":{
+            "measurement-agent":"{% scheduled_by_address %}",
+            "url":"https://[PS_IP]/esmond/perfsonar/archive/"
+         }
+      }
+   },
+   "groups":{
+      "example_group_mesh":{
+         "addresses":[
+            {
+               "name":"PS"
+            },
+            {
+               "name":"NSRC"
+            },
+            {
+               "name":"NORDUnet"
+            }
+         ],
+         "type":"mesh"
+      }
+   },
+   "schedules":{
+      "example_schedule_PT10M":{
+         "repeat":"PT10M",
+         "slip":"PT10M",
+         "sliprand":true
+      },
+      "example_schedule_PT4H":{
+         "repeat":"PT4H",
+         "slip":"PT4H",
+         "sliprand":true
+      }
+   },
+   "tasks":{
+      "example_task_latencybg":{
+         "_meta":{
+            "display-name":"Example Loss Tests"
+         },
+         "archives":[
+            "example_esmond_archive"
+         ],
+         "group":"example_group_mesh",
+         "test":"example_test_latencybg"
+      },
+      "example_task_throughput":{
+         "_meta":{
+            "display-name":"Example Throughput Tests"
+         },
+         "archives":[
+            "example_esmond_archive"
+         ],
+         "group":"example_group_mesh",
+         "schedule":"example_schedule_PT4H",
+         "test":"example_test_throughput"
+      },
+      "example_task_trace":{
+         "_meta":{
+            "display-name":"Example Traceroute Tests"
+         },
+         "archives":[
+            "example_esmond_archive"
+         ],
+         "group":"example_group_mesh",
+         "schedule":"example_schedule_PT10M",
+         "test":"example_test_trace"
+      }
+   },
+   "tests":{
+      "example_test_latencybg":{
+         "spec":{
+            "dest":"{% address[1] %}",
+            "flip":"{% flip %}",
+            "source":"{% address[0] %}"
+         },
+         "type":"latencybg"
+      },
+      "example_test_throughput":{
+         "spec":{
+            "dest":"{% address[1] %}",
+            "duration":"PT30S",
+            "source":"{% address[0] %}"
+         },
+         "type":"throughput"
+      },
+      "example_test_trace":{
+         "spec":{
+            "dest":"{% address[1] %}",
+            "source":"{% address[0] %}"
+         },
+         "type":"trace"
+      }
+   }
+}
+}}}
+
+You can run below to validate file for any syntax errors, 
+
+{{{
+jq . learn.json
+}}}
+
+Now we will add pSConfig template as a local template.
+
+psconfig remote add /<Path-To-Template>/learn.json"
+
+Now restart below services to make the changes to be effect.
+
+{{{
+systemctl restart cassandra
+systemctl restart maddash-server
+systemctl restart psconfig-maddash-agent
+}}}
 
 == Setting up Central Measurement Archive and MadDash for Multiple Measurement Nodes ==