Project

General

Profile

Statistics
| Branch: | Tag: | Revision:

gdp / README-CAAPI.md @ master

History | View | Annotate | Download (2.49 KB)

1 632861ce Eric Allman
***This documentation is out of date as of 2018-12-07.***
2 b2714365 Eric Allman
3
OTHER INTERFACES TO THE GLOBAL DATAPLANE
4
========================================
5
6
There are some other interfaces to the GDP, generally referred to
7
as CAAPIs (Common Access APIs).  For the most part these are lightly
8
documented.
9
10 3bfb8d8e Rick Pratt
The RESTful Interface
11
---------------------
12
13 79c3499d Rick Pratt
The RESTful interface was originally implemented and deployed in
14
support of the Signposts Project, which was demonstrated at the
15
TerraSwarm Annual Meeting held in October 2017. In addition to the
16
Signposts, several other TerraSwarm demonstrations made use of the
17 3bfb8d8e Rick Pratt
RESTful GDP Gateway deployment.
18
19 79c3499d Rick Pratt
The RESTful gateway provided access to the GDP v1 Network until June
20
2019, when the implementation was adapted and transitioned to the
21
recently deployed GDP v2 Network.
22
23 3bfb8d8e Rick Pratt
If you want to use the deployed RESTful GDP Gateway, please browse to
24 632861ce Eric Allman
the <https://gdp-rest-01.eecs.berkeley.edu/> home page, which will
25 3bfb8d8e Rick Pratt
present hotlinks to the RESTful API (`doc/gdp-rest-interface.html`)
26
and to python client usage example(s). Be advised that gdp-rest-01
27
will not respond to non-SSL-protected (http://) traffic, and requires
28
basic client authentication when executing RESTful actions. Please
29
contact the Swarm Lab for inquires regarding basic client credentials.
30
In addition to programmatic access, you can do GETs from inside a
31
browser such as Firefox or Chrome, but not POSTs.  To use other
32
methods you'll have to use Chrome.  Install the "postman" extension to
33
enable sending of arbitrary methods such as POST and PUT.
34
35
If you want to set up your own RESTful GDP Gateway, please review the
36
gdp-rest-01 server configuration details as documented on the GDP
37
redmine wiki. The production deployment uses a lighttpd server running
38
on Ubuntu 16.04, integrated with an SCGI backend. The gdp-rest daemon
39 79c3499d Rick Pratt
handles requests from SCGI, and leverages gdp-create for log creation.
40 3bfb8d8e Rick Pratt
41
The RESTful GDP Gateway is limited to a RESTful-compatible subset of
42
GDP capabilities, though it provides an easy and rapid way to begin
43
using the GDP. A Web Socket Interface (`gdp-ws') has been deployed on
44
gdp-rest-01 to support access to some non-RESTful GDP functionality
45 79c3499d Rick Pratt
(e.g. log subscriptions) in web browser environments.
46 b2714365 Eric Allman
47
Python Key-Value Store
48
----------------------
49
50
Key-Value lookups can be done in Python using
51
`lang/python/apps/KVstore.py`.  This is a library package for
52
incorporation into larger Python programs.
53
54
<!-- vim: set ai sw=4 sts=4 ts=4 : -->
55 632861ce Eric Allman
56
<!-- Use
57
	pandoc -sS -o README-CAAPI.html README-CAAPI.md
58
to process this to HTML -->