retsina tutorial
DESCRIPTION
RETSINA Tutorial. MSEC 20-854. Fall 2001. Joseph Giampapa. 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 - PowerPoint PPT PresentationTRANSCRIPT
![Page 1: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/1.jpg)
RETSINA Tutorial
Joseph Giampapa MSEC 20-854 Fall 2001
![Page 2: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/2.jpg)
Overview
• Installing the Software
• Configuring the Infrastructure
• Developing an Agent
• Running an Agent
• Debugging and Development Tools
• Useful Agents to Know
![Page 3: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/3.jpg)
Installing the Software
• For C/C++ Development– Windows 2000– Unix - to be released
• For Java Development– Windows 2000– Unix – to be released
![Page 4: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/4.jpg)
Installing the RETSINA AFC SDK on Windows 2000
• Preferable System Requirements
• Software Dependencies
• Installation Procedure
Joseph Giampapa MSEC 20-854 Fall 2001
![Page 5: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/5.jpg)
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
![Page 6: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/6.jpg)
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
![Page 7: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/7.jpg)
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
![Page 8: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/8.jpg)
1. Initialize Directory Structure
1. put CD in CD reader
2. click through the menus ...
3. There is only one obvious path to success
![Page 9: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/9.jpg)
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
![Page 10: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/10.jpg)
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%
![Page 11: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/11.jpg)
3. Install DLLs under Windows
1. login as Administrator
2. cd %RETSINA%\AFC\lib\dll\debug
3. click to activate the “install.bat” file
![Page 12: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/12.jpg)
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
![Page 13: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/13.jpg)
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”
![Page 14: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/14.jpg)
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]
![Page 15: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/15.jpg)
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.
![Page 16: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/16.jpg)
Installing the Software for Java Development
• Windows 2000– Software Dependencies– Installation Procedure
• Unix – to be released
![Page 17: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/17.jpg)
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
![Page 18: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/18.jpg)
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
![Page 19: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/19.jpg)
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
![Page 20: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/20.jpg)
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
![Page 21: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/21.jpg)
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]
![Page 22: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/22.jpg)
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 >].
![Page 23: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/23.jpg)
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 >]
![Page 24: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/24.jpg)
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.
![Page 25: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/25.jpg)
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.
![Page 26: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/26.jpg)
MFC Retsina Agent AppWizardConfirmation Box
You will see a review box, labeled “New Project Information”.
![Page 27: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/27.jpg)
Important Final Steps
Before you begin modifying your agent, you need to manually copy some library files into your project repository.
![Page 28: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/28.jpg)
Running an Agent
![Page 29: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/29.jpg)
Debugging and Development Tools
• testANS and TestANSGUI
• kqmlcenter and KQMLMessageSenderGUI
• ACLParserTestbed - ACLExplorer
![Page 30: RETSINA Tutorial](https://reader035.vdocument.in/reader035/viewer/2022062517/56813ad9550346895da31a9b/html5/thumbnails/30.jpg)
Useful Agents to Know
• MediaAgent
• RPA
• MokSAF
• SpeechAgent
• SpeechBroker
• Others, at a later date