-
Notifications
You must be signed in to change notification settings - Fork 189
User Instructions
under construction
To Implement the OpenIoT platform, we recommend that you use any of the linux distribution and the following prerequisites are advised:
- JDK 1.7
- Maven 3.0
- JBoss AS 7
- (Optional) Eclipse or any other IDE that you are familiar with
- The source code
If you do not have already installed any of the unix distribution, you can do it from here
We will guide you through the prerequisite section. Remember this is just a guideline; you can follow your own procedure to acquire them.
You can use this [link](http://askubuntu.com/questions/56104/how-can-i-install-sun-oracles-proprietary-java-6-7- jre-or-jdk) for help
Note: We recommend you to install Sun/Oracle Java, not the OpenJDK. check if u have done it correctly by typing in terminal: java -version
For installing maven on ubuntu, follow the procedure described [here](http://stackoverflow.com/questions/15630055/how-to-install-maven-3-on-ubuntu-12-04-12- 10-13-04-13-10-by-using-apt-get)
Alternatively you can try installing maven from Eclipse as well as described here
Check the maven version: mvn -version
For installing JBoss on ubuntu, you can follow these two tutorials, and do not need to create a new user thus do not follow the step three of the first link (Start from step 2, as it is expected that you have installed java 7 beforehand). [install-jboss-on-ubuntu](https://www.digitalocean.com/community/articles/how-to-install-jboss-on-ubuntu-12-10- 64bit) install-jboss-7-ubuntu-1110-server
After Installation, Start the JBoss Enterprise Application Platform 6 or JBoss AS 7.1 with the Web Profile. Open a command line and navigate to the root of the JBoss server directory. The following shows the command line to start the server with the web profile:
For Linux: JBOSS_HOME/bin/standalone.sh
For Windows: JBOSS_HOME\bin\standalone.bat
For example, we have used: XXX@ubuntu:~/jboss-as-7.1.1.Final/bin$ ./standalone.sh
Should get results here (http://localhost:8080/)
Alternatively you can also try to install JBoss from Eclipse Marketplace: If there is no ‘marketplace’ for your ubuntu, install it folowing this link
(Optional) Eclipse or any other IDE that you are familiar with
To deploy the codes, you have to acquire the codes first. For that you can ‘install git client’
by executing the following command:
sudo apt-get install git
And get the codes using following command:
git clone https://github.com/OpenIotOrg/openiot.git
With this command all the codes supposed to be in ~/openiot/ . Now unzip the openiot-modules.
Now you have the prerequisites ready and you have the codes in your local machine. OpenIoT modules depends on each other, so it is recommended that you follow the instructed serial while deploying the full platform.
Please note that several links with instructions suggested below may request and instruct you to install the prerequisites (e.g: Java or maven) again. Ignore those whenever necessary.
During the deployment steps, occasionally, your build may fail. It can happen for several reasons. If unsuccessful at the first attempt, try multiple times to deploy the same module. If it doesnt work, please swap between link (1) and (2). For example in Deployment Step 2, we have provided you two links. If the mentioned serial doesnt work, try the opposite - first follow link 2, then link 1. By doing this you should be able to deploy/install the module.
utils.commons Follow this link: https://github.com/OpenIotOrg/openiot/wiki/Openiot-Commons-Library copy utils.commons file from (example location: ~/openiot/utils/utils.commons/src/main/resources/properties/) to jboss directory (example location: ~/jboss-as-7.1.1.Final/standalone/configuration/) Some properties of this properties file need to be modified depending on the graph you use or data you load into your database. We will discuss about it later in this document.
Lsm-light client and server Follow these links: (1) https://github.com/OpenIotOrg/openiot/wiki/Sensor-Data-Use (2) https://github.com/OpenIotOrg/openiot/wiki/Sensor-Data-Develop
Scheduler Follow these links: (1) https://github.com/OpenIotOrg/openiot/wiki/Global-Scheduler-Use (2) https://github.com/OpenIotOrg/openiot/wiki/Global-Scheduler-Develop Check: http://localhost:8080/scheduler.core/rest/services
SDUM Follow these links: (1) https://github.com/OpenIotOrg/openiot/wiki/SD%26UM-Use (2) https://github.com/OpenIotOrg/openiot/wiki/SD%26UM-Develop Check: http://localhost:8080/sdum.core/rest/services
request.commons Go to ui/ui.requestCommons directory and install the ui.requestCommons.
ide.core Follow the link: (1) https://github.com/OpenIotOrg/openiot/wiki/IDE-Core-Use (2) https://github.com/OpenIotOrg/openiot/wiki/IDE-Core-Develop Check: http://localhost:8080/ide.core/
request definition Follow the links: (1) https://github.com/OpenIotOrg/openiot/wiki/Request-definition-use (2) https://github.com/OpenIotOrg/openiot/wiki/Request-Definition-Develop Check: http://localhost:8080/ui.requestDefinition/
request presentation Follow the links: (1) https://github.com/OpenIotOrg/openiot/wiki/Request-presentation-use (2) https://github.com/OpenIotOrg/openiot/wiki/Request-Presentation-Develop Check: http://localhost:8080/ui.requestPresentation/
Visual Sensor Schema Editor - RDFSensorSchemaEditor Follow the links: (1) https://github.com/OpenIotOrg/openiot/wiki/Virtual-Sensor-RDF-Schema-Editor-Use (2) https://github.com/OpenIotOrg/openiot/wiki/Virtual-Sensor-RDF-Schema-Editor-Develop Check: http://localhost:8080/sensorschema
By now, your openiot platform should be ready to run. But you do not have any data to test your platform. To load data to virtuoso database, firstly you have to have the data, secondly you have to load the data into the database. You can follow this step for loading data: http://virtuoso.openlinksw.com/dataspace/doc/dav/wiki/Main/VirtBulkRDFLoader Your openiot.properties file placed in JBoss directory must be configured according to your loaded graph, data and other parameters. It is important for you to understand what kind of graph you are loading for what purpose. For example, we have loaded these following graphs to our virtuoso database, and thus we have used the relevant openiot.properties file attached: graphs loaded: http://lsm.deri.ie/OpenIoT/demo/sensordata# http://lsm.deri.ie/OpenIoT/demo/functionaldata# http://lsm.deri.ie/OpenIoT/demo/sensormeta# Openiot.properties file: NOTE: you can provide a link of the openiot.properties file here ** ----- **
OpenIoT should be Up, Running and ready to create services on the fly
#Scheduler Properties
#The following three graph names depend on the graphs you imported in your DB
scheduler.core.lsm.openiotMetaGraph=http://lsm.deri.ie/OpenIoT/demo/sensormeta#
scheduler.core.lsm.openiotDataGraph=http://lsm.deri.ie/OpenIoT/demo/sensordata#
scheduler.core.lsm.openiotFunctionalGraph=http://lsm.deri.ie/OpenIoT/demo/functionaldata#
#At this moment, you do not need to change the credentials below
scheduler.core.lsm.access.username=openiot_guest
scheduler.core.lsm.access.password=openiot
#Next two parameters are configured for OpenIoT using local database
scheduler.core.lsm.sparql.endpoint=http://localhost:8890/sparql
scheduler.core.lsm.remote.server=http://localhost:8080/lsm-light.server/
#Service Delivery & Utility Manager (SD&UM) Properties
#The following graph name depends on the graph you imported in your DB
sdum.core.lsm.openiotFunctionalGraph=http://lsm.deri.ie/OpenIoT/demo/functionaldata#
#Next two parameters are configured for OpenIoT using local database
sdum.core.lsm.sparql.endpoint=http://localhost:8890/sparql
sdum.core.lsm.remote.server=http://localhost:8080/lsm-light.server/
#Request Definition
#Request Presentation
#LSM-LIGHT Properties
lsm-light.server.connection.driver_class=virtuoso.jdbc4.Driver
lsm-light.server.connection.url=jdbc:virtuoso://localhost:1111/log_enable=2
#The following credentials depend on your installation of local DB (virtuoso)
lsm-light.server.connection.username=dba
lsm-light.server.connection.password=dba
lsm-light.server.minConnection=10
lsm-light.server.maxConnection=15
lsm-light.server.acquireRetryAttempts=5
#for local virtuoso instance
#The following graph names depend on the graphs you imported in your DB
lsm-light.server.localMetaGraph = http://lsm.deri.ie/OpenIoT/demo/sensormeta#
lsm-light.server.localDataGraph = http://lsm.deri.ie/OpenIoT/demo/sensordata#
To download and use the OpenIoT platform's modules please follow the instructions provided in the links below. A package integrating all the different modules will be provided in the future.