SD&UM Use

System requirements

All you need to run this project is Java 7.0 (Java SDK 1.7) or later and JBoss Enterprise Application Platform 6 or JBoss AS 7.1.

Deployment/Undeployment

JBoss AS 6.0

Deploy: To deploy the SD&UM on JBoss AS 6.0, copy the sdum.core.war to the server's deploy directory.

Undeploy: Remove the app war sdum.core.war from the JBoss deploy directory while the server is running.

JBoss AS 7.0

Deploy: To deploy the SD&UM on JBoss AS 7.0, copy the sdum.core.war to the server's standalone/deployments directory.

Undeploy: To undeploy the application, you need to remove the .deployed marker file that is generated upon successful deployment of the scheduler module.

You can find more detailed directions on the ins and outs of deployment on JBoss AS7 here.

Properties Set-Up/Configuration

The SD&UM uses the global properties file. Directions on how to use and configure can be found here

Manual

This module is expected to be used from the OpenIoT Request Presentation user interface. Instructions on how to install and use this interface can be found in Request-Presentation. In case you would like to use a third party application use the restful web services from the URLs listed below (the inputs and the outputs of these services are defined in API Specifications Table here):

• Welcome message listing the available services:
  • http://localhost:8080/sdum.core/rest/services/
• Poll for Report :
  • http://localhost:8080/sdum.core/rest/services/pollforreport
• Get Service Status:
  • http://localhost:8080/sdum.core/rest/services/getServiceStatus
• Get Application:
  • http://localhost:8080/sdum.core/rest/services/getApplication
• Get Service:
  • http://localhost:8080/sdum.core/rest/services/getService
• Get User:
  • http://localhost:8080/sdum.core/rest/services/getUser
• Get Available Application IDs:
  • http://localhost:8080/sdum.core/rest/services/getAvailableAppIDs
• Get Available Service IDs :
  • http://localhost:8080/sdum.core/rest/services/getAvailableServiceIDs

Security Configuration

Service

For using the SD&UM, a REST service must be created. When the OpenIoT graph is initialized, a REST service is created for the SD&UM with the following key and secret as defined in the openiot.properties:

• security.initialize.sdum.key=sdum
• security.initialize.sdum.secret=sdum.secret

The key and secret of the service must correspond to the key and secret specified in the global security-config.ini file in the configuration section devoted to the SD&UM.

Permissions

Users need to have the permission "*" to access various functionality of the SD&UM. The permission "*" is created upon initialization of the OpenIoT graph for the SD&UM service.

Roles

The role "AllPermRole" is created upon initialization of the OpenIoT graph for the SD&UM service. The permission "*" is assigned to this role.