This is the homepage of the Genius2 parties server. This server can provide running instances of specified agents.

The Genius2 main page is ​here.

The Parties server runs on Tomcat 8 and is developed with Eclipse EE.

Installation

• Install your apache-tomcat 8 installation ​​https://tomcat.apache.org/download-80.cgi. You can re-use an existing installation.
• Download the parties server war file from ​the artifactory. Go into the latest version of the partiesserver and download (right click) the war file. NOTICE: your browser must have cookies enabled to access the artifactory.
• Copy the downloaded war file into the tomcat webapps directory
• (Re)start tomcat

Now your local partiesserver should be up and running.

Using

After installing and starting, go to ​http://localhost:8080/partiesserver to see if it works.

Example parties can be found in the general genius repository, for example the ​randomparty.

To deploy a party, the party jar file (with dependencies) is simply copied into the the tomcat/webapps/partiesserver/partiesrepo directory. This directory is created by tomcat when started, and is an unzipped version of the war file that you copied there for installation.

To remove or rename a party, you can simply remove or rename the jar file.

How it is expected to work

The parties server is a component in the bigger genius2 framework. Its main function is to

• create an running instance of a party when a certain address on the server is requested
• It then returns a websocket on which the party can be contacted
• The connection implements something like Connection<Inform, Action> (see the references module in genius2 core)
  • accepts Inform objects and these are passed into the party (see the the party module in genius2 core)
  • can send Action objects as requested by the agent (see the events module in genius2 core)

Using the source code

You can download the source repository. Note that you don't need this if you just want to use the parties server.

svn checkout https://tracinsy.ewi.tudelft.nl/svn/Genius2PartiesServer/

Since this is a tomcat web application, you need Eclipse Enterprise edition if you want to run this from Eclipse. Also, to checkout from Eclipse, you need to prepare Eclipse for this. Check ​https://tracinsy.ewi.tudelft.nl/trac/Genius2/wiki/WikiStart

It is maven based so you only need maven to compile the code.

Create new party instance

A new instance of a party can be created by connecting to partiesserver/run/<party name>, for instance

​http://localhost:8080/partiesserver/run/randomparty-1.0.0

There are two possible responses from the party server:

1. a URL. This is the URL of the websocket behind which the newly instantiated party can be contacted.
2. error code 503 "Service Unavailable" if there is no room on the partiesserver at this moment to instantiate another party