7.0.0

# Enable local FDSNWS server

You will …

- Enable FDSN web service by fdsnws to serve waveforms and inventory for a configured station

Pre-requisites for this tutorial:

- Tutorial on Maintain waveform archives

Afterwards/Results/Outcomes:

- The station meta data and waveforms are available from a local web server

Time range estimate:

- 10 minutes

By default, fdsnws will serve the three FDSN web services

- fdsnws-dataselect

- fdsnws-event

- fdsnws-station

on a server running locally on port 8080.

The additional availability feature allows users to obtain information on continuous data segments in the waveform archive. This information is written to the database by scardac. To active the availability feature set `serveAvailability` and `dataAvailability.enable` to true. The availability information can be retrieved using scxmldump or fdsnws.

## Set-up

1. Configure fdsnws:

   - set the RecordStream to point to archived data.

   - configured and enable the desired services.

2. Enable and start fdsnws locally:

   - in scconfig, go to the System tab. Click on the line for the “fdsnws” module, and press “Enable module(s)”. Then restart SeisComP.

   - or from the command line

         $ seiscomp enable fdsnws
         $ seiscomp start fdsnws

3. Test by visiting the locally started fdsnws.

Logging information goes to `~/.seiscomp/log/fdsnws.log` by default. Information about requests handled goes to the file named in accessLog, if you set this.

To see the available configuration options, go to the Modules tab in scconfig. Under Utilities open “fdsnws” to reveal the options. To disable fdsnws-event, for instance, unlock the “serveEvent” area and uncheck this parameter.

You can limit the choice of stations shared to be less than what is in your SeisComP inventory using the allowRestricted, dataSelectFilter and stationFilter options.

## Visiting the Service

Once fdsnws is running, you can visit the local web server that it runs. In your browser, visit http://localhost:8080/fdsnws/dataselect/1/

Information screen shown by fdsnws-dataselect at http://localhost:8080/fdsnws/dataselect/1/

## Check it Works

- If you visit the URL http://localhost:8080/fdsnws/dataselect/1/version you should receive a version number string - currently 1.1.0.

- To view all activated services visit http://localhost:8080/fdsnws/

- The fdsnws-station service should give a list of networks configured and served by the service, e.g. visiting http://localhost:8080/fdsnws/station/1/query?level=network&format=text produces

      #Network|Description|StartTime|EndTime|TotalStations
      GE|GEOFON Program, GFZ Potsdam, Germany|1993-01-01T00:00:00||84

  Omitting the format=text argument in the query string of the above URL results in the service returning a StationXML file.

Example of StationXML returned by the fdsnws-station service at

http://localhost:8080/fdsnws/station/1/query?level=network

## Further Information

- The URL Builder at GEOFON lets you fill out a form to tailor your request. The URL to use to make your request is displayed at the bottom of that page.

- More example requests are at the FDSNWS description at GEOFON

- The FDSN Web Services specification document [5] provides the technical documentation and examples.

## Final Tests

- The station should now be visible when you query your local fdsnws instance. In your browser, visit http://localhost:8080/fdsnws/station/1/query?format=text to see a list of all channels available from your fdsnws server.

- Request waveform data like this:

  http://localhost:8080/fdsnws/dataselect/1/query?start=2020-01-01T01:01:01&end=2020-01-01T02:00:00

  Don’t forget to adjust your start and end times to match the data actually present in your archive. The above example is just for the first hour of 2020.