----------------------------------------------------- | Authors: Janelle Mason and Monica Barnette | Date: September 7, 2007 | Project: Multi-Agent Systems (US Army Project) | Advisor: Dr. Esterline | Semester: FALL 2007 ----------------------------------------------------- Jade Software: Jade 3.5 latest version (25/06/2007) Installation Techniques ======================= CLASSPATH Info -------------- When setting the CLASSPATH variable, the 'Base64.jar' file is not included in the Jade files that you download from the website. First, get this file from the following site using the Internet Explorer browser: "http://www.comp.nus.edu.sg/~bimlesh/ametrics/SAMA.htm". Select the 'lib.jar' link. You can copy the 'Base64.jar' file from this folder into the your folder at this path: "C:\JADE\JADE-all-3[1].5\JADE-bin-3.5\jade\lib". Make sure you include the 'Base64.jar' file in the CLASSPATH variable. Java Info --------- Check to see if you have the JDK 1.5.0-05 version of Java installed on your computer. If not, you need to download Java JDK 1.5.0_05. The path to view the version of Java is C:\Program Files\Java. Tutorial ======== The documentation for the tutorial is found on the Jade website. Select the 'papers & resources' link. Then select the 'Online documentation' link. Under the header 'Basic Documentation', select the 'Description of the examples' link (http://jade.tilab.com/doc/examples/index.html). NOTE: The 'JADE Tutorial and Primer' is obselete for this version of Jade, Jade 3.5. Compiling Techniques ==================== When compiling the .java files, go to the folder where the file is located. For an example: The path should be, "C:\JADE\JADE-all-3[1].5\JADE-examples-3.5\jade\src\examples\hello" to compile the HelloWorldAgent.java file. When executing the jade.Boot command, the path should be the following: C:\JADE\JADE-all-3[1].5\JADE-examples-3.5\jade\src Current Issues with the Tutorial ================================ - The site for the Book Trading Tutorial is not working. (09/07/07) - I was not able to compile the ontology tutorial example. The RequesterAgent.java and EngagerAgent.java files contained 61 errors total. (09/07/07) Command to Compile the Ontology tutorial: (Fixed on 09/10/07) ----------------------------------------- C:\JADE\JADE-all-3[1].5\JADE-examples-3.5\jade\src\examples\ontology>javac Engag erAgent.java employment\Person.java RequesterAgent.java employment\Company.java employment\Address.java employment\EmploymentOntology.java employment\Engage.jav a employment\EngagementError.java employment\PersonTooOld.java employment\WorksF or.java - I need to run the JSP example. (09/07/07) - In order to execute the Jess & JadeJessProtege Tutorial example, you have to download Jess 7.1 (http://www.jessrules.com/jess/download.shtml), because it supports peering, or the ability for mulitple engines to share a single rule base. I am not able to run this example. (09/07/07) - The site for the MeetingScheduler Tutorial is not found. (09/07/07) Overview & status of Tutorials as of (09/07/07) =============================================== Functional Tutorials -------------------- 1. Hello World 2. Behaviours 3. Messaging 4. Yello Pages 5. Topic-based communication 6. Protocols 7. InProcess 8. Base64 9. Mobile 10. ThanksAgent 11. Party 12. The Agentcities PingAgent 13. Ontology Require other environments * ---------------------------- 1. JSP 2. Jess 3. JadeJessProtege * You have to create the enviornments with JESS in order to execute these programs. Non-functional Tutorials -------------------------- 1. Book Trading * 2. Ontology # - Executed on 09/10/07 properly, Disregard comments below 3. MeetingScheduler * * The site that contains the instructions as not working. # There are a total of 61 errors when compiling the RequesterAgent.java and EngagerAgent.java files. Setting up Eclipse with Jade - (09/15/07) ========================================= Eclipse 3.3.0 & EJIP 0.2.0 downloads ------------------------------------ 1. Download Eclipse 3.2 or better from http://www.eclipse.org/downloads/ 2. Save the '.zip file' to the C:/ directory. 3. Extract all the files. 4. Open another browser to get the EJIP plugin. Use the following website, http://www.mars-team.com/forum/ , to register to obtain the EJIP plugin to install in Eclipse. After creating your profile and logging in, select the first link 'Announcement - Downloads' to download the EJIP plugin. 5. Read documentation on how to install the plugin into Eclipse. 6. To get instructions to verify that you set it up correctly use this link to watch the movie - http://www.mars-team.com/video/ejip_0.2.0.wmv NOTE: I created a the MyAgent.java file so you don't have to type it all in. I will send it to you to assist with any difficulties.