IoT Platform Documentation
Note well
-
This home wiki redirects to
SDK-v1SDK-v2, but also toserver installationwiki. -
Developers of AI, WMS and/or HMI components can skip document about
installing the platform, and focus on SDK-v1 and SDK-v2 documents.
SDKs
If you want to test communications with the platform, then please ignore the IoT platform installation wiki and proceed to test comms with development server environment
IoT Platform available servers
We currently use two deployments (platforms) for NAIADES,
-
DEVELOPMENT platform: also known asdev platform, is an environment where we test new features, test integration, etc. DATABASEs data will probably be wiped out from time to time -
PRODUCTION platform: also known asprod platform, is an environment where we deploy stable features, databases are backed-up regularly
| environment | host | opened ports | services running |
|---|---|---|---|
| DEVELOPMENT | 5.53.108.182 | 1026/tcp 1027/tcp 3005/tcp 8668/tcp |
current data (pull and/or subscribe) access controlled querying identity manager querying historical data |
| PRODUCTION | ? | 80/tcp 443/tcp |
IoT Platform services
The following table describes what is the purposes of each platform service:
| service | purpose |
|---|---|
| db-crate | database for timeseries (historical data) |
| db-mongo | database for context-manager (currrent data) |
| db-mysql | database for identities and roles |
| fiware-keyrock | manages identities and roles |
| fiware-orion | context manager, API server for all entities |
| fiware-orion-proxy | enforce access control |
| fiware-quantumleap | REST service for storing, querying and retrieving NGSI v2 spatial-temporal data |
| wms-app-example | Dummy example of a WMS component, acts as a consumer(subscriber) and publisher of messages to NAIADES |
SDK (software development kits)
Here below we provide some documents which will help any developer either i) communicate with an existing IoT platform (as clients) or ii) deploy the IoT platform (deploy your own server).
NOTE:
Developers of AI, WMS and/or HMI components can skip document about server installation, and focus on SDK-v1 and SDK-v2 documents:
| Document description | Document link | Comments |
|---|---|---|
| Installing the IoT platform in your own server | server installation | Advanced Only for partners which want to build their own IoT platform. Not needed for running SDKs |
| Getting started with Context Manager and Time Series APIs | SDK-v1 | Please run SDK scripts against dev environment server (5.53.108.182) |
| How to use IdM API and tokens for queries | SDK-v2 | Please run SDK scripts against dev environment server (5.53.108.182) |
| Some basic API client examples using postman | postman collection |
Integration tests:
The following table describes which partners have managed to test successfully communications with the dev platform
| Partner | Component | Testeds comms ok (sdk-v1) | Tested Auth(s) comms ok (sdk-v2) |
|---|---|---|---|
| UDGA | Data collection | OK | OK |
| SIMAVI | Data collection |
not tested |
not tested |
| ADSYS | Data collection |
not tested |
not tested |
| AIMEN | Data collection | OK | OK |
| IHE | WMS service |
not tested |
not tested |
| JSI | WMS service |
not tested |
not tested |
| AIMEN | WMS service |
not tested |
not tested |
| CERTH | WMS service | OK | OK |
| ADSYS | Data fusion |
not tested |
not tested |
| KT | HMI |
not tested |
not tested |
| ICCS | HMI | OK | OK |
| SIMAVI | HMI |
not tested |
not tested |
FAQs:
please check the IoT Platform FAQ
TODO :
- fill in PRODUCTION row after testing services are reachable (SIMAVI)
- Include section about maintainance , e.g. data base backups and restoring (UDGA)
- Describe NGINX integration (SIMAVI)