Chapter 1. About the Quickstart Guide

Table of Contents

1.1. About this guide
1.2. Manual typographical conventions
1.3. The Developer website
1.4. Command line conventions
1.5. Reporting bugs

1.1. About this guide

This manual provides instructions on how to set up the ADK environment which is used to build Tryllian agents. It is assumed that the user of this manual has an understanding of the Java programming language. If more information is needed regarding Java or agents, see the reference list in the appendix of the Developer's Guide. The ADK Scenarios provide an overview of the main features of Tryllian's mobile agent technology and development platform through the use of functional scenarios, including a simple example showing how to run your first agent using the ADK.

1.2. Manual typographical conventions

This manual uses the following typefaces described in following table to indicate special text.

TypefaceMeaning
ItalicsNewly introduced terms, concepts, file names and emphasis.
Monospace typeCode and console output, as well as code to be entered verbatim. It is also used to indicate filenames.
KeycapsThis typeface indicates a key on your keyboard. For example, "Press ESC to exit a menu."

1.3. The Developer website

The Developer website is found on a special section of the Tryllian website (http://develop.tryllian.com) and is devoted to assisting ADK developers. It provides news regarding the latest ADK releases. A download area allows developers to download the ADK. A current FAQ for active ADK Developers is also on the website. It contains answers to many issues faced during development and helps with troubleshooting. In addition, current reference documents for the ADK and several tools packaged with it are provided. Finally, the Javadoc of the ADK can be found at this site.

1.4. Command line conventions

To facilitate the readability of this document, the command line commands are written for Windows users. If you install the ADK on a Unix system or a Unix-like system such as GNU/Linux, you should modify translate the command line as follows:

WindowsUnix
;:
\/
file.bat (The .bat extension can be omitted.)./file.sh
SETEXPORT (If the line is in a .sh replace the SET by nothing.)
%VARIABLE%${VARIABLE}

For example :

set ADK_PATH=%ADK_PATH%;%ADK_ROOT%\lib\jdbc\classes12.zip (Windows)

ADK_PATH=${ADK_PATH}:${ADK_ROOT}/lib/jdbc/classes12.zip (Unix)

habitat helloworld.xml (Windows)

./habitat.sh helloworld.xml (Unix)

For consistency in the document, the directory where you have installed the ADK will be named <ADK_ROOT>. You need then to replace <ADK_ROOT> with the name of your directory. For example:

replace cd <ADK_ROOT>\bin

with cd c:\Tryllian\adk-3.0\bin

1.5. Reporting bugs

You can report bugs through the ADK Users Mailing list or by sending an email to Tryllian at info@tryllian.com. You can also contact us via regular mail at

      Tryllian Solutions B.V.
      Hogehilweg 21
      1101 CB Amsterdam-Zuidoost
      The Netherlands
      (T) +31 (0)20 850 80 00
      (F) +31 (0)20 850 80 80
    

All reported bugs are submitted to Tryllian developers who will investigate these reported bugs in order to improve the quality of the ADK. The Tryllian developers may need to contact you to request more information or examples of source code exhibiting the reported bug.