Server Side Tutorial

This page contains tutorials for setting up and configuring the testbed runtime wrapper for OMF. First, you'll learn which prerequisites have to be created before you are able to run the wrapper on your server.

Prerequisites

1. You need an XMPP server which is used for the communication between the server and the experiment clients. You could install your own XMPP server (e.g. Openfire, as recommended on OMF Developer Installation) or use any other XMPP server meeting the requirements described in the OMF installation instructions.
2. The testbed wrapper was designed to work with the ruby version 2.0.0. Make sure, that ruby -v returns an appropriate version and install ruby if necessary.
3. Assuming you're in the directory of the WiseOMF RC, run bundle install to install all needed gems.
4. Read the OMF installation instructions to learn about the OMF architecture and how to generally configure the OMF Resource Controller.

Configuration of the testbed wrapper

The WiseOMF RC has its own config file ./config.yml. This file is used to configure the resource controller to fit for the your server side environment. Example:

---
:xmpp_url:  xmpp://localhost
:env:   development
:debug:     false
:trhost:    localhost
:trport:    9998

• xmpp_url: the xmpp_url is the url to the XMPP server to used for communication between the server and the client.
• env: the ruby environment symbol (e.g. devolpment or production). Use production for less message output and a log file.
• debug: if true also messages on the debug level are printed to the log file as well as to the stdout
• trhost: adress of the server running the testbed runtime
• trport: the port on which to connect to the testbed as external plugin.

Running the WiseOMF Resource Controller

After finishing the configuration, the testbed wrapper could be started by calling the ruby script ./wiseomfrc.rb. Assuming you're in the main directory of the WiseOMF RC, simply call ruby wiseomfrc.rb. That`s all!