CUPUS Use

System requirements

All you need to run the middleware is Java 7.0 (Java SDK 1.7) or later.

Download

The CUPUS middleware can be downloaded as Java JAR from the OpenIoT binary distribution repository.

Deploy: To deploy the Cloud Broker service, copy the “CloudBroker.java” to the cloud instance. Run the terminal command: java –jar StartBroker.jar <path_to_config_file> <classpath>.

The classpath argument is the CUPUS-1.0-jar-with-dependencies.jar file which serves as a library for the middleware components.

Undeploy: Stop the running instance of the service by typing “QUIT”.

Configuration file

An example of the Cloud Broker configuration file is provided below:

brokerName = testBroker
brokerPort = 10000
internalUDPPort = 10001

# max number of publications waiting to be sent, for each subscriber
queueCapacity = 1000
# GCM API key
apikey = AIzaSyADsn6N5Rq6an73KnSaEt3geI-BHy5nBdY

# Number of matcher processes, if elasticity is enabled this is the maximal number of Boolean matchers
numberOfBooleanMatchers = 1
numberOfTopKWMatchers = 1

# Enable dynamic management of matchers
elasticity = false
# Maximal share of idle time that will trigger splitting event
splitThreshold = 0.1
# Minimal share of idle time that will trigger merging event
mergeThreshold = 0.8
# Number of messages after which elasticity check is performed
checkThreshold = 500

# If testing is set there will be extensive output to std.out
testing = true
# If logWriting is set a log file will be created and filled with detailed info of broker events
logWriting = true

Mobile Broker, Publisher and Subscriber

Details how to create, build and run mobile broker, publisher or subscriber are given in the Develop page