Exchange data and metadata with others

In this chapter we activate FDSN web services [And Arclink? :FIXME:] to allow waveforms and inventory metadata to be shared with others.

Check Arclink installation

Connect to your Arclink server through telnet and perform a request with the following commands:

telnet localhost 18001
HELLO
USER you@yourdomain
REQUEST waveform
2016,8,24,2,0,0 2016,8,24,2,0,20 GE MATE BHZ .
END

(The server responds after each command, with a message such as “OK”.) You will receive a number as a response from the last command. Let’s suppose that it’s 333. Then, continue with the following commands.

status 333

This shows a small XML document. In the <volume> tag are the status and size attributes:

status 333
<?xml version="1.0"?>
<arclink>
    <request args="" encrypted="false" error="false" id="333" label="" message="" ready="true" size="36864" type="WAVEFORM">
        <volume dcid="MYDC" encrypted="false" id="MYDC-73088822" message="" size="36864" status="OK">
            <line content="2016,8,24,2,0,0 2016,8,24,2,0,30 GE MATE BHZ ." message="" size="15872" status="OK" />
        </volume>
    </request>
</arclink>
END

Keep asking for the status until you can see that it’s OK. Next to the status, the final size of your request will be shown, in case you want to download it. Use the following command (this is ‘’‘not’’ recommended; it will dump binary SEED data directly to your terminal):

DOWNLOAD 333
BYE

Configure FDSN web services in your SC3

• Open scconfig.

• Click on the “Modules” icon and go to the “global” module.

• Look for the “database” section and complete the following:

  type=mysql
  parameters=sysop:sysop@localhost/seiscomp3
  

• Press Ctrl+S to save the configuration.

• Go to the “fdsnws” module in the tree on the left. Then, go to the “global” section and the “recordstream” subsection and complete with the following:

  service=sdsarchive
  source=/home/sysop/seiscomp3/var/lib/archive
  

• Press Ctrl+S to save the configuration.

• Click to the “System” icon, click on “Update configuration” and restart SeisComP3 (Stop and Start buttons).

Send requests to the web services

Metadata

• Open a browser and go to http://localhost:8080/fdsnws/station/1/query?level=station

Basically, what you are requesting here is a list of all the stations configured in your system using the SeisComP3 implementation of the FDSN web services.

You should see the whole GE network and the stations around the event in Italy. With this test you verify that the inventory is apparently correct AND that you are able to share this data with others via FDSN web services, in the same way as data centres do.

Waveforms

• You can do the same for the waveforms that you have imported.
• In the browser go to http://localhost:8080/fdsnws/dataselect/1/query?starttime=2016-08-24T02:00:00& endtime=2016-08-24T02:10:00&net=GE
• You requested all the waveforms from the GE network from 2016-08-24T02:00:00 to 2016-08-24T02:10:00.

Now you can use clients to work with your data. For instance, scolv. Remember to switch in scolv to “combined” (combined://localhost:18000;localhost:18001) to load the waveforms from the archive.