SPL Stream web service saves messages received from SPL RadioRoom to AWS DynamoDB database service. SPL Tracks provides access to the reported data in GeoJSON format.
Though, SPL Stream and SPL Tracks web applications could run in any java application servers, yet because the application use DynamoDB AWS service, it is recommended to run these web applications in AWS.
The easiest way to deploy SPL Stream and SPL Tracks web applications on AWS is using Elastic Beanstalk service.
Follow these instructions to deploy SPL Stream and SPL Tracks web applications:
- Login to AWS Console and select the AWS region.
- Switch to IAM service service.
- Select ‘Roles’ in the vertical menu on the left.
- Click on aws-elasticbeanstalk-ec2-role in the list of available roles.
- Click ‘Attach Policy’ button, find and check ‘AmazonDynamoDBFullAccess’ policy in the list of IAM policies.
- Click ‘Attach Policy’.
- Download spltracks-2.0-bin.zip file from https://github.com/envirover/SPLGroundControl/releases.
- Switch to Elastic Beanstalk service in the AWS console.
- Click ‘Create New Application’ link.
- Enter ‘spltracks’ as the application name and ‘SPLStream and SPLTracks’ as the application description. Click ‘Create’.
- Click ‘Actions’ button and select ‘Create environment’.
- Select ‘Web server environment’ in the menu and click ‘Select’.
- Select ‘Preconfigured platform’ option, and in the list of preconfigured platforms select ‘Tomcat’.
- In the ‘Application code’ option select ‘Upload your code’ and select the downloaded spltracks-2.0-bin.zip.
- Click ‘Create environment’.
- After the application is ready, register
http://<application URL>/splstream/rockblockURL as a delivery address for your RockBBLOCK.
The GeoJSON web service URL will be available at
http://<application URL>/spltracks/features/?devices=<ISBD IMEA>. The demo web page URL will be available at
http://<application URL>/spltracks/?devices=<ISBD IMEA>.
Query string parameters
endTime could be used to specify the time interval of the requested data.