Versions Compared

Old Version 2

changes.mady.by.user Yee-Ting Li

Saved on

compared with

New Version 3

changes.mady.by.user Yee-Ting Li

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Query the LS for information

The LS supports queries via XQuery. This is passed in the subject tag from which the service does a direct query. eg:

Code Block
<?xml version='1.0' encoding='UTF-8'?>
<nmwg:message type="LSQueryRequest"
              id="msg1"
              xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/"
              xmlns:xquery="http://ggf.org/ns/nmwg/tools/org/perfsonar/service/lookup/xquery/1.0/">
                                                                                                                                   
  <nmwg:metadata id="meta1">
  
    <xquery:subject id="sub1">

      <!-- XQUERY STATEMENT HERE -->

    </xquery:subject>
  declare namespace nmwg="http <nmwg:eventType>http://ggf.org/ns/nmwg/base/2.0/";
        collection('control.dbxml')/nmwg:metadata[@id="http://lhcopnmon1-mgm.fnal.gov:8091/axis/services/snmpMA"]

    </xquery:subject>
tools/org/perfsonar/service/lookup/xquery/1.0</nmwg:eventType>
  </nmwg:metadata>
  
  <nmwg:data metadataIdRef="meta1" id="d1"/>

</nmwg:message>

Notes

So depending on the type of query you wish to conduct, you must modify your XQuery statement. What follows is some common queries. Please not that the output, even though is XML, will be escaped and should be reconstructed so that it can be reparsed as XML DOM (etc).

A simple way of doing this is to pipe the output to:

Code Block

 sed s:'&gt;':'>':g | sed s:'&lt;':'<':g | sed s:'&quot;':'"':g | tidy

Dump Everything

Code Block

        declare namespace nmwg="http://ggf.org/ns/nmwg/base/2.0/";
        /nmwg:store
Code Block

[ytl@Yees-Ubuntu:~/Work/perfSONAR/perfSONAR-PS/trunk/perfSONAR-PS/client]$ ./client.pl http://patdev0.internet2.edu:6666/perfSONAR_PS/services/LS /tmp/test.xml | sed s:'&gt;':'>':g | sed s:'&lt;':'<':g | sed s:'&quot;':'"':g | tidy
2007/10/09 14:08:52 DEBUG> Transport.pm:469 perfSONAR_PS::Transport::makeEnvelope - Envelope created.
2007/10/09 14:08:52 DEBUG> Transport.pm:488 perfSONAR_PS::Transport::sendReceive - Sending information to "http://patdev0.internet2.edu:6666//perfSONAR_PS/services/LS".
2007/10/09 14:08:52 DEBUG> Transport.pm:505 perfSONAR_PS::Transport::sendReceive - Response returned.
No warnings or errors were found.

<?xml version="1.0"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header />
  <SOAP-ENV:Body>
    <nmwg:message xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="message.1124710" messageIdRef="msg1" type="LSQueryResponse">
      <nmwg:metadata xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="metadata.7145326" metadataIdRef="meta1"></nmwg:metadata>
      <nmwg:data xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="data.1129756" metadataIdRef="metadata.7145326">
        <psservice:datum xmlns:psservice="http://ggf.org/ns/nmwg/tools/org/perfsonar/service/1.0/">
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore">
            <nmwg:metadata xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="http://patdev0.internet2.edu:8080/perfSONAR_PS/services/snmpMA">
              <perfsonar:subject xmlns:perfsonar="http://ggf.org/ns/nmwg/tools/org/perfsonar/1.0/">
                <psservice:service xmlns:psservice="http://ggf.org/ns/nmwg/tools/org/perfsonar/service/1.0/">
                  <psservice:serviceName>Internet2 SNMP MA #2</psservice:serviceName>
                  <psservice:accessPoint>http://patdev0.internet2.edu:8080/perfSONAR_PS/services/snmpMA</psservice:accessPoint>
                  <psservice:serviceType>MA</psservice:serviceType>
                  <psservice:serviceDescription>perfSONAR_PS SNMP MA Located in Ann Arbor, MI</psservice:serviceDescription>
                </psservice:service>
              </perfsonar:subject>
            </nmwg:metadata>
          </nmwg:store>
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore-control">
            <nmwg:metadata id="http://patdev0.internet2.edu:8080/perfSONAR_PS/services/snmpMA-control"
            metadataIdRef="http://patdev0.internet2.edu:8080/perfSONAR_PS/services/snmpMA" xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
              <nmwg:parameters id="control-parameters">
                <nmwg:parameter name="timestamp">
                  <nmtm:time type="unix" xmlns:nmtm="http://ggf.org/ns/nmwg/time/2.0/">1191966278</nmtm:time>
                </nmwg:parameter>
              </nmwg:parameters>
            </nmwg:metadata>
          </nmwg:store>
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore">
            <nmwg:data xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/"
            id="http://patdev0.internet2.edu:8080/perfSONAR_PS/services/snmpMA/1191879862/0"
            metadataIdRef="http://patdev0.internet2.edu:8080/perfSONAR_PS/services/snmpMA">
              <nmwg:metadata xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="m-in-netutil-1">
                <netutil:subject xmlns:netutil="http://ggf.org/ns/nmwg/characteristic/utilization/2.0/" id="s-in-netutil-1">
                  <nmwgt:interface xmlns:nmwgt="http://ggf.org/ns/nmwg/topology/2.0/">
                    <nmwgt:ifAddress type="ipv4">164.113.238.205</nmwgt:ifAddress>
                    <nmwgt:hostName>ks-42-tenge4-2-130.r.greatplains.net</nmwgt:hostName>
                    <nmwgt:ifName>TenGigabitEthernet2/1</nmwgt:ifName>
                    <nmwgt:ifIndex>3</nmwgt:ifIndex>
                    <nmwgt:direction>in</nmwgt:direction>
                    <nmwgt:capacity>10000000000</nmwgt:capacity>
                    <nmwgt:description>Internet2 via Great Plains Network</nmwgt:description>
                    <nmwgt:ifDescription>Internet2 via Great Plains Network</nmwgt:ifDescription>
                  </nmwgt:interface>
                </netutil:subject>
                <nmwg:eventType>http://ggf.org/ns/nmwg/tools/snmp/2.0</nmwg:eventType>
                <nmwg:eventType>http://ggf.org/ns/nmwg/characteristic/utilization/2.0</nmwg:eventType>
                <nmwg:parameters id="p-in-netutil-1">
                  <nmwg:parameter name="supportedEventType">http://ggf.org/ns/nmwg/tools/snmp/2.0</nmwg:parameter>
                  <nmwg:parameter name="supportedEventType">http://ggf.org/ns/nmwg/characteristic/utilization/2.0</nmwg:parameter>
                </nmwg:parameters>
              </nmwg:metadata>
            </nmwg:data>
          </nmwg:store>
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore">
            <nmwg:data xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/"
            id="http://patdev0.internet2.edu:8080/perfSONAR_PS/services/snmpMA/1191879862/1"
            metadataIdRef="http://patdev0.internet2.edu:8080/perfSONAR_PS/services/snmpMA">
              <nmwg:metadata xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="m-out-netutil-1">
                <netutil:subject xmlns:netutil="http://ggf.org/ns/nmwg/characteristic/utilization/2.0/" id="s-out-netutil-1">
                  <nmwgt:interface xmlns:nmwgt="http://ggf.org/ns/nmwg/topology/2.0/">
                    <nmwgt:ifAddress type="ipv4">164.113.238.205</nmwgt:ifAddress>
                    <nmwgt:hostName>ks-42-tenge4-2-130.r.greatplains.net</nmwgt:hostName>
                    <nmwgt:ifName>TenGigabitEthernet2/1</nmwgt:ifName>
                    <nmwgt:ifIndex>3</nmwgt:ifIndex>
                    <nmwgt:direction>out</nmwgt:direction>
                    <nmwgt:capacity>10000000000</nmwgt:capacity>
                    <nmwgt:description>Internet2 via Great Plains Network</nmwgt:description>
                    <nmwgt:ifDescription>Internet2 via Great Plains Network</nmwgt:ifDescription>
                  </nmwgt:interface>
                </netutil:subject>
                <nmwg:eventType>http://ggf.org/ns/nmwg/tools/snmp/2.0</nmwg:eventType>
                <nmwg:eventType>http://ggf.org/ns/nmwg/characteristic/utilization/2.0</nmwg:eventType>
                <nmwg:parameters id="p-out-netutil-1">
                  <nmwg:parameter name="supportedEventType">http://ggf.org/ns/nmwg/tools/snmp/2.0</nmwg:parameter>
                  <nmwg:parameter name="supportedEventType">http://ggf.org/ns/nmwg/characteristic/utilization/2.0</nmwg:parameter>
                </nmwg:parameters>
              </nmwg:metadata>
            </nmwg:data>
          </nmwg:store>
...

We see here all the <nmwg:store/>'s that have been registered with the LS. Here we see a list of SNMP-MA metadata elements which have been registered with the LS.

Later on in the output, we have

Code Block

...
         <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore">
            <nmwg:metadata xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="http://packrat.internet2.edu:8089/perfSONAR_PS/services/topology">
              <perfsonar:subject xmlns:perfsonar="http://ggf.org/ns/nmwg/tools/org/perfsonar/1.0/">
                <psservice:service xmlns:psservice="http://ggf.org/ns/nmwg/tools/org/perfsonar/service/1.0/">
                  <psservice:serviceName>Topology MA</psservice:serviceName>
                  <psservice:accessPoint>http://packrat.internet2.edu:8089/perfSONAR_PS/services/topology</psservice:accessPoint>
                  <psservice:serviceType>MA</psservice:serviceType>
                  <psservice:serviceDescription>Topology Measurement Archive</psservice:serviceDescription>
                </psservice:service>
              </perfsonar:subject>
            </nmwg:metadata>
          </nmwg:store>
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore-control">
            <nmwg:metadata id="http://packrat.internet2.edu:8089/perfSONAR_PS/services/topology-control"
            metadataIdRef="http://packrat.internet2.edu:8089/perfSONAR_PS/services/topology" xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
              <nmwg:parameters id="control-parameters">
                <nmwg:parameter name="timestamp">
                  <nmtm:time type="unix" xmlns:nmtm="http://ggf.org/ns/nmwg/time/2.0/">1191967581</nmtm:time>
                </nmwg:parameter>
              </nmwg:parameters>
            </nmwg:metadata>
          </nmwg:store>
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore">
            <nmwg:data xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/"
            id="http://packrat.internet2.edu:8089/perfSONAR_PS/services/topology/1191881181/0"
            metadataIdRef="http://packrat.internet2.edu:8089/perfSONAR_PS/services/topology">
              <nmwg:metadata id="meta17737387">
                <nmwg:subject id="sub0">
                  <ctrlplane_jun:domain xmlns:CtrlPlane="http://ogf.org/schema/network/topology/ctrlPlane/20070626/"
                  xmlns:ctrlplane_jun="http://ogf.org/schema/network/topology/ctrlPlane/20070626/" id="urn:ogf:network:domain=293" />
                </nmwg:subject>
                <nmwg:eventType>topology</nmwg:eventType>
                <nmwg:eventType>http://ggf.org/ns/nmwg/topology/query/all/20070809</nmwg:eventType>
                <nmwg:eventType>http://ggf.org/ns/nmwg/topology/query/xquery/20070809</nmwg:eventType>
                <nmwg:eventType>http://ggf.org/ns/nmwg/topology/change/add/20070809</nmwg:eventType>
                <nmwg:eventType>http://ggf.org/ns/nmwg/topology/change/update/20070809</nmwg:eventType>
                <nmwg:eventType>http://ggf.org/ns/nmwg/topology/change/replace/20070809</nmwg:eventType>
              </nmwg:metadata>
            </nmwg:data>
          </nmwg:store>
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore">
            <nmwg:metadata xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="http://packrat.internet2.edu:5800/perfSONAR_PS/services/topology">
              <perfsonar:subject xmlns:perfsonar="http://ggf.org/ns/nmwg/tools/org/perfsonar/1.0/">
                <psservice:service xmlns:psservice="http://ggf.org/ns/nmwg/tools/org/perfsonar/service/1.0/">
                  <psservice:accessPoint>http://packrat.internet2.edu:5800/perfSONAR_PS/services/topology</psservice:accessPoint>
                  <psservice:serviceType>MA</psservice:serviceType>
                  <psservice:serviceDescription>Topology Measurement Archive</psservice:serviceDescription>
                </psservice:service>
              </perfsonar:subject>
            </nmwg:metadata>
          </nmwg:store>
...

Whis is the metadata from a Topology Service.

And we even have that of from the Status MA:

Code Block

...
         <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore">
            <nmwg:metadata xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" id="http://packrat.internet2.edu:5801/perfSONAR_PS/services/status">
              <perfsonar:subject xmlns:perfsonar="http://ggf.org/ns/nmwg/tools/org/perfsonar/1.0/">
                <psservice:service xmlns:psservice="http://ggf.org/ns/nmwg/tools/org/perfsonar/service/1.0/">
                  <psservice:accessPoint>http://packrat.internet2.edu:5801/perfSONAR_PS/services/status</psservice:accessPoint>
                  <psservice:serviceType>MA</psservice:serviceType>
                  <psservice:serviceDescription>Link Status Measurement Archive</psservice:serviceDescription>
                </psservice:service>
              </perfsonar:subject>
            </nmwg:metadata>
          </nmwg:store>
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore-control">
            <nmwg:metadata id="http://packrat.internet2.edu:5801/perfSONAR_PS/services/status-control"
            metadataIdRef="http://packrat.internet2.edu:5801/perfSONAR_PS/services/status" xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
              <nmwg:parameters id="control-parameters">
                <nmwg:parameter name="timestamp">
                  <nmtm:time type="unix" xmlns:nmtm="http://ggf.org/ns/nmwg/time/2.0/">1191967524</nmtm:time>
                </nmwg:parameter>
              </nmwg:parameters>
            </nmwg:metadata>
          </nmwg:store>
          <nmwg:store xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/" type="LSStore">
            <nmwg:data xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/"
            id="http://packrat.internet2.edu:5801/perfSONAR_PS/services/status/1191881560/0"
            metadataIdRef="http://packrat.internet2.edu:5801/perfSONAR_PS/services/status">
              <nmwg:metadata id="meta0">
                <nmwg:subject id="sub0">
                  <nmtopo_aug:link xmlns:nmtopo="http://ogf.org/schema/network/topology/base/20070828/"
                  xmlns:nmtopo_aug="http://ogf.org/schema/network/topology/base/20070828/"
                  id="urn:ogf:network:domain=I2:node=rtr.wash:port=so-1%2F1%2F0.0:link=ATLA to WASH OC192" />
                </nmwg:subject>
                <nmwg:eventType>Link.Status</nmwg:eventType>
                <nmwg:eventType>http://ggf.org/ns/nmwg/toolscharacteristic/orglink/perfsonarstatus/service/lookup/xquery/1.0</20070809</nmwg:eventType>
              </nmwg:metadata>
        
  <nmwg:data metadataIdRef="meta1" id="d1"/>

 </nmwg:data>
          </nmwg:message>store>
...