DIALOG Distributed information
architectures for collaborative logistics
 

About Dialog:

» Home
» Concept
» Publications
» Downloads
» Documentation
» Dialog team
» Contact info
» OSC
» Links

Last updated
April 22nd, 2010

id@uri

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:
    1. 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"
    2. 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.

            mysql:       jdbc:mysql://localhost/DBname
            postgresql:  jdbc:postgresql:DBname
            odbc:        jdbc:odbc:DBname
            oracle:      jdbc:oracle:thin:@ServerIP:port:SID
        
    3. 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

    1. Copy "soap_dialog" directory into the Tomcat "webapps" directory,
    2. Start Tomcat if not started yet and
    3. 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:

    1. a) If you are installing on a Windows machine just doubleclick the runclient.bat icon.
      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.
    2. 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.
  • To test the installation:

    1. Start the server versions that you want to test and the "client" program.
    2. In the "View" menu of the client program, choose "Hello World Agent".
    3. 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 default settings.
      • SOAP: Do same thing as for RMI but use the URI "soap://localhost:8080/soap_dialog/services/soap_dialog" instead (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.



Troubleshooting:

Problems may occur especially when creating database tables due to incompatibility issues in SQL statements of different databases. Currently tested databases are:
  • Microsoft ODBC for Windows, tested with Access driver
  • MySQL, version 3.23.49
  • PostgreSQL, version 7.1.3
  • Oracle, version 9
Databases that will be tested shortly include:
  • Oracle, version 8
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