» Dialog team
» Contact info
April 22nd, 2010
Dialog software download page
The software distributed here has been developed by the Dialog
research project's programming team. The software is written in Java
and should work as such on any Java-enabled computer running
UNIX/Linux or Windows.
- Download: DialogSrcLib.zip Last updated 28jun2006.
To download, unzip and build:
- If you are running the windows version you need a zip tool or the Java archive tool JAR (also on unix/linux) to unpack the files.
- To compile the source code you need Apache Ant build tool. Available here!
- Download and unpack the following file: DialogSrcLib.zip
- Double Click the file if using Windows. In Unix just execute "unzip DialogSrcLib.zip". To use the Java JAR tool type "jar xvf DialogSrcLib.zip".
- To compile the source code execute the following commands in the windows command prompt (in the directory where you unzipped the files):
"ant build" (RMI server, generic client node)
"ant soapserver" (Web Service/SOAP server)
"ant htmlformserver" (Servlet server using HTML FORM/POST messages)
To run the server:
You will need the following:
To start the RMI server:
- a) If you are using Windows, start the server by executing "runserver.bat" in the "build" directory created during compilation
The first time the server is run the command "runserver.bat -c" should be used in order to create the necessary tables in your database (use e.g. DOS command window for this).
b) correspondingly in Unix, issue the command "sh runserver.sh" or "sh runjarserver.sh -c"
- The options dialog will now be shown. If you want to use a databse, then you should activate the corresponding option. Then you should enter the url to your database, your user name on the
database and your password. The options dialog is only shown the first time you start the server, if
you want to change something later you can start the server with the -o switch (runserver -o).
The url to your database is database vendor dependant, check the documentation for your jdbc driver and
database. Here are some example urls for a few databases, note that these examples may not correspond to
how your database is set up and that you may need to modify them.
- You should now have a running RMI server listening for incoming connections!
To start SOAP and Servlet DIALOG nodes, you will also need the following:
To start the SOAP server:
Compiling with the command "ant soapserver" produces a sub-directory of
the "build" directory called "soap_dialog". Then
- Copy "soap_dialog" directory into the Tomcat "webapps" directory,
- Start Tomcat if not started yet and
- Execute "Deploy" script in the "webapps/soap_server" directory.
To start the Servlet (HTTP/POST) server:
Compiling with the command "ant htmlformserver" produces a sub-directory of
the "build" directory called "html_dialog". Copy this directory into the
Tomcat "webapps" directory, put a "ServerOptions.cfg" file with the right information into the "WEB-INF" directory.
To run the client:
- a) If you are installing on a Windows machine just doubleclick the runclient.bat icon.
A dialog box is shown the first time that the program is started, where program options are entered.
For the current version, this means geographical location as a free-format
text string and the type of barcode/RFID reader device being used. Further
options will be added in future versions.
b) If you are installing on a Unix machine run the command: "sh runclient.sh" at the prompt in the directory where you unpacked the files.
To test the installation:
- Start the server versions that you want to test and the "client" program.
- In the "View" menu of the client program, choose "Hello World Agent".
- Then test different protocols according to the following:
- RMI: Write some value into "Identifier" field and the text "/dialog" into
URI field. Writing "/dialog" signifies the use of localhost and RMI with
- SOAP: Do same thing as for RMI but use the URI
(sorry for the long URI but that is normally re-configured to something else in the web server anyway.
- Servlet (HTTP/POST): Direct your browser to
"http://localhost:8080/html_dialog" to use it (if you are just doing local testing). You can also use this address as a URI in the client application
but the results are less verbose than with the browser.
Remark: start "tomcat5.exe" directly from Tomcat's bin-directory; there
has been some problems with the newest version of Tomcat when starting
it as service.
Problems may occur especially when creating database tables due to incompatibility
issues in SQL statements of different databases. Currently tested databases
Databases that will be tested shortly include:
- Microsoft ODBC for Windows, tested with Access driver
- MySQL, version 3.23.49
- PostgreSQL, version 7.1.3
- Oracle, version 9
This software is still in alpha/beta phase
phase, so both the instructions and the software will still be strongly modified
in the near future!
Last updated 28 June 2006