retsina tutorial

RETSINA Tutorial

Joseph Giampapa MSEC 20-854 Fall 2001

Overview

• Installing the Software

• Configuring the Infrastructure

• Developing an Agent

• Running an Agent

• Debugging and Development Tools

• Useful Agents to Know

Installing the Software

• For C/C++ Development– Windows 2000– Unix - to be released

• For Java Development– Windows 2000– Unix – to be released

Installing the RETSINA AFC SDK on Windows 2000

• Preferable System Requirements

• Software Dependencies

• Installation Procedure

Joseph Giampapa MSEC 20-854 Fall 2001

Software Dependencies

1. install Visual Studio 6.0, Visual C++– You should be Administrator

2. install MSDN - Microsoft Developer Network

– You should be Administrator

3. install the RETSINA AFC SDK• You should be the local user, i.e. garof

Preferable System Requirements

• Windows 2000

• 96M RAM, or more

• 885M Disk for MS Visual Studio 6.0– VB, VC, & MSDN– May be less

• 95M Disk for RETSINA– AFC SDK, Tools + some Agents

AFC SDK Installation Procedure

1.Initialize Directory Structure

2.Setup the RETSINA Variable

3.Install DLLs

4.Install Common System Files

5.Configure Visual C/C++

6.Start the MFC Visual Studio

1. Initialize Directory Structure

1. put CD in CD reader

2. click through the menus ...

3. There is only one obvious path to success

2. Setup the RETSINA VariableSystem-wide, so that it will be the same for every user

1. login as Administrator

2. start settings control panel system advanced environment variables System variables new

3. variable name: RETSINA

4. value: the AFC parent directoryExample:

– if the path to AFC is c:\Program Files\RETSINA\AFC

– then the value for the RETSINA variable is c:\Program Files\RETSINA

5. DO NOT end the path name with a slash

2.1. RETSINA Variable Verification

To verify the values of the system variables:

1. open a DOS prompt, and

2. type “set”.

3. It will display all the known variables and their values.

4. Access the variable by “quoting” it with percent-signs: %RETSINA%

3. Install DLLs under Windows

1. login as Administrator

2. cd %RETSINA%\AFC\lib\dll\debug

3. click to activate the “install.bat” file

4. Install Common System Files

1. login as Administrator

2. start run d:\RETSINAsystemfiles.exe

3. Browse the CD-ROM and select the file named “RETSINAsystemfiles.exe”

N.B.: your file manager may be configured to not show file name extensions

4. Run the selected executable

5. Configuring Visual C/C++

1. login as user (e.g. garof)

2. start programs accessories windows explorerWARNING: The view from “My Computer” will only permit you

to launch the “InstallShield Wizard”, so you need to use “Windows Explorer”

3. Copy “D:\MFC RetsinaAgent.awx” to “C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\IDE”

6. Start the MFC Visual Studio1. login as user (e.g. garof)

2. Start Programs Microsoft Visual Studio 6.0 Microsoft Visual C++ 6.0

3. from within the Microsoft Visual C++ application, select:Tools Options ... Directories• illustrated on page 4 of AFC Developer’s Guide

4. From within the Options pop-up dialogue box, select:1. empty line -> click within it -> and browse [...]

2. C:\PROGRAM FILES\RETSINA\AFC\INCLUDE

3. [OK]

AFC SDK Setup is Compete

• Setup is now complete.

• Now it is possible to create agents.

• Please monitor the AFC distribution web site for updates.

Installing the Software for Java Development

• Windows 2000– Software Dependencies– Installation Procedure

• Unix – to be released

Software Dependencies

1. Jdk 1.1.7 - recommended– Available on course web page

– Requires 22.2M of free disk

2. jdk 1.3.1_01 - optional– Download from http://java.sun.com/

– Requires 60M of free disk

– Will not run ANS from current jar

3. Specific jar files and instructions– Available on course web page

Configuring the Infrastructure• Agent Name Services

1. Win32ANS - Windows only

2. AgentNameService - Java-based for Windows and Unix

• Logging and Visualization1. Windows-based DemoDisplay

2. Applet-based DemoDisplay - per request

• Matchmakers – at a later date1. Gin-based Matchmaker

2. A-Match Matchmaker

3. LARKS Matchmaker

Developing an Agent• Recommended Text Editors

– MS Visual Studio for AFC SDK– Text-only editors for Java-based development

• Emacs 20.7 is the best

• Notepad and WordPad are OK if used only in Text mode

• in AFC

• in Java– Demonstration at a later date– Please see me if you need immediate help

Developing in AFC SDK

• You can build you agents in any subdirectory.– For convenience: “%RETSINA%\Agents”

• Use AFC AppWizard– Page 41 of “AFC Developer’s Guide”– A 4-step process

Starting the Agent AppWizardFrom within MS Visual C++:

1. File New MFC Retsina Agent AppWizard

2. For “Project Name”, enter an agent name: Test_01

3. Change the “Location:” directory to “%RETSINA%\Agents”

• Notice that Visual C will create another subdirectory, based on your agent name: “%RETSINA%\Agents\Test_01”

• Click [OK]

MFC Retsina Agent AppWizard – Step 1

You will be prompted to select an application type:

To the left of the radio button window, you will see a visualization of each of those choices.

At this time, only “Dialog based” is implemented.

Select “Dialog based” and click [Next >].

MFC Retsina Agent AppWizard – Step 2 of 4

This menu allows you to select a label for your agent’s GUI title bar.Please enter a title for your dialogue: Test_01[Next >]

MFC Retsina Agent AppWizard – Step 3 of 4

The only option, leave as is.

You choice: comments are better.

The only option that you can select.

This feature is not yet implemented.

Please click [Next >] when you are ready to proceed.

MFC Retsina Agent AppWizard – Step 4 of 4

This window gives you the chance to change the names of the files.Use the defaults, for now.Please click [Finish] when ready.

MFC Retsina Agent AppWizardConfirmation Box

You will see a review box, labeled “New Project Information”.

Important Final Steps

Before you begin modifying your agent, you need to manually copy some library files into your project repository.

Running an Agent

Debugging and Development Tools

• testANS and TestANSGUI

• kqmlcenter and KQMLMessageSenderGUI

• ACLParserTestbed - ACLExplorer

Useful Agents to Know

• MediaAgent

• RPA

• MokSAF

• SpeechAgent

• SpeechBroker

• Others, at a later date