1. RETSINA Tutorial Joseph Giampapa MSEC 20-854Fall 2001

2. Overview Installing the Software Configuring the Infrastructure Developing an Agent Running an Agent Debugging and Development Tools Useful Agents to Know

3. Installing the Software For C/C++ Development –Windows 2000 –Unix - to be released For Java Development –Windows 2000 –Unix – to be released

4. Installing the RETSINA AFC SDK on Windows 2000 Preferable System Requirements Software Dependencies Installation Procedure Joseph Giampapa MSEC 20-854Fall 2001

5. 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

6. 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

7. 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

8. 1. Initialize Directory Structure 1.put CD in CD reader 2.click through the menus... 3.There is only one obvious path to success

9. 2. Setup the RETSINA Variable System-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 directory Example: –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

10. 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%

11. 3. Install DLLs under Windows 1.login as Administrator 2.cd %RETSINA%\AFC\lib\dll\debug 3.click to activate the “install.bat” file

12. 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

13. 5. Configuring Visual C/C++ 1.login as user (e.g. garof) 2.start  programs  accessories  windows explorer WARNING: 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”

14. 6. Start the MFC Visual Studio 1.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]

15. 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.AFC distribution web site

16. Installing the Software for Java Development Windows 2000 –Software Dependencies –Installation Procedure Unix – to be released

17. Software Dependencies 1.Jdk 1.1.7 - recommended –Available on course web pagecourse web page –Requires 22.2M of free disk 2.jdk 1.3.1_01 - optional –Download from http://java.sun.com/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 pagecourse web page

18. Configuring the Infrastructure Agent Name Services 1.Win32ANS - Windows only 2.AgentNameService - Java-based for Windows and Unix Logging and Visualization 1.Windows-based DemoDisplay 2.Applet-based DemoDisplay - per request Matchmakers – at a later date 1.Gin-based Matchmaker 2.A-Match Matchmaker 3.LARKS Matchmaker

19. Developing an Agent Recommended Text Editors –MS Visual Studio for AFC SDK –Text-only editors for Java-based development Emacs 20.7 is the bestEmacs 20.7 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

20. 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

21. Starting the Agent AppWizard From 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]

22. 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 >].

23. 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 >]

24. 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.

25. 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.

26. MFC Retsina Agent AppWizard Confirmation Box You will see a review box, labeled “New Project Information”.

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

28. Running an Agent

29. Debugging and Development Tools testANS and TestANSGUI kqmlcenter and KQMLMessageSenderGUI ACLParserTestbed - ACLExplorer

30. Useful Agents to Know MediaAgent RPA MokSAF SpeechAgent SpeechBroker Others, at a later date