Location-based services (LBS) uses real-time location or geo-data from devices to monitor and track devices. The geo extension in WSO2 IoT Server provides real-time information about geospatial objects. It processes spatial data from an external source of events and analyzes/manipulates this data to produce meaningful information to end users. You can interact with it to generate a variety of alerts and warnings.
...
Tip If you are running WSO2 IoT Server already, stop the server before proceeding to the next step.
Navigate to the
<IOTS_HOME>/wso2/analytics/scripts
folder and run the following command. This installs the required geo extension feature to WSO2 IoT Server.Code Block mvn clean install -f siddhi-geo-extention-deployer.xml
Open the
cdm-config.xml
file found in the<IOTS_HOME>/conf
folder and set the following properties under the<GeoLocationConfiguration>
tag to true.
This enables the geo extension feature in WSO2 IoT Server.Code Block <GeoLocationConfiguration> <isEnabled>true</isEnabled> <PublishLocationOperationResponse>true</PublishLocationOperationResponse> </GeoLocationConfiguration>
Start the WSO2 IoT Server core and analytics profiles and sign in to the WSO2 IoT Server Device Management Console.
Expand title Click here for more information. Start the WSO2 IoT Server core profile.
Code Block cd <IOTS_HOME>/bin sh iot-server.sh
Next, start the WSO2 IoT Server analytics profile.
Code Block cd <IOTS_HOME>/bin sh analytics.sh
Access the device management console.
For access via HTTP:
For example:
http://<IOTS_HTTP_HOST>:9763/devicemgt/
http://localhost:9763/devicemgt/
- For access via secured HTTP:
https://<IOTS_HTTPS_HOST>:9443/devicemgt/
For example:https://localhost:9443/devicemgt/
Enter the username and password, and sign in.
Info The system administrator will be able to log in using
admin
for both the username and password. However, other users will have to first register with IoTS before being able to log into the IoTS device management console. For more information on creating a new account, see Registering with WSO2 IoT Server.Click LOGIN . The respective device management console will change, based on the permissions assigned to the user.
For example, the device management console for an administrator is as follows:
Tip title Deploying in a multi-tenant environment The geo analytics artifacts are deployed by default in the WSO2 IoT Server super tenant. However, if you are setting up geofencing in a multi-tenant environment, you have to deploy the geo analytics artifacts in each tenant.
Login to the device management console using the tenant credentials.
Click on the menu button and select Configuration Management>Platform Configurations.
- Click the Deploy Geo Analytics Artifacts button. You can also use this button to redeploy the geo analytics artifacts in super tenant mode if required.
Enroll a device. For this tutorial, an Android device has been enrolled.
Tip For more information on how to enroll an Android device, see Android.
For more information on how to enroll other sample device types, see Enrolling Sample Devices.
- Access the geofencing map for the device you just enrolled by doing the following:
- Click the menu icon, and then click Device Management.
- Click view on the device you just enrolled and select the Location tab.
...