| <html> |
| <head> |
| <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <title>Chapter 6. Installation Guide</title> |
| <link href="book.css" type="text/css" rel="stylesheet"> |
| <meta content="DocBook XSL Stylesheets V1.76.0" name="generator"> |
| <link rel="home" href="index.html" title="Agent Modeling Guide"> |
| <link rel="up" href="index.html" title="Agent Modeling Guide"> |
| <link rel="prev" href="Programer_Guide.html" title="Chapter 5. Programer Guide"> |
| <link rel="next" href="New_and_Noteworthy.html" title="Chapter 7. New and Noteworthy"> |
| </head> |
| <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> |
| <div class="navheader"> |
| <table summary="Navigation header" width="100%"> |
| <tr> |
| <th align="center" colspan="3">Chapter 6. Installation Guide</th> |
| </tr> |
| <tr> |
| <td align="left" width="20%"><a accesskey="p" href="Programer_Guide.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="New_and_Noteworthy.html">Next</a></td> |
| </tr> |
| </table> |
| <hr> |
| </div> |
| <div class="chapter" title="Chapter 6. Installation Guide"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h2 class="title"> |
| <a name="Installation_Guide"></a>Chapter 6. Installation Guide</h2> |
| </div> |
| </div> |
| </div> |
| <div class="toc"> |
| <dl> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Tools">Tools</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Complete_IDE">Complete IDE</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Eclipse_and_the_Agent_Modeling_Tools">Eclipse and the Agent Modeling Tools</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Extensions">Extensions</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Ascape">Ascape</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Repast">Repast</a></span> |
| </dt> |
| </dl> |
| </dd> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Models">Models</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Obtaining_Example_Models">Obtaining Example Models</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#Team_Project_Sets">Team Project Sets</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="Installation_Guide.html#From_Version_Control_Systems">From Version Control Systems</a></span> |
| </dt> |
| </dl> |
| </dd> |
| </dl> |
| </dd> |
| </dl> |
| </div> |
| <div class="section" title="Tools"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h2 class="title" style="clear: both"> |
| <a name="Tools"></a>Tools</h2> |
| </div> |
| </div> |
| </div> |
| <div class="section" title="Complete IDE"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h3 class="title"> |
| <a name="Complete_IDE"></a>Complete IDE</h3> |
| </div> |
| </div> |
| </div> |
| <p>You may already have obtained a complete IDE bundled with AMP and other modeling tools. The project contributors offer open source and commercial versions of the AMP tools, which you can find at their sites. If so, you can mostly ignore this chapter unless you want to install an optional component like Repast.</p> |
| </div> |
| <div class="section" title="Eclipse and the Agent Modeling Tools"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h3 class="title"> |
| <a name="Eclipse_and_the_Agent_Modeling_Tools"></a>Eclipse and the Agent Modeling Tools</h3> |
| </div> |
| </div> |
| </div> |
| <p>You can find more detailed instructions |
| <a class="ulink" href="http://eclipse.org/amp/installing/" target="_new">here</a>, but here are the basic steps. |
| </p> |
| <div class="orderedlist"> |
| <ol class="orderedlist" type="1"> |
| <li class="listitem"> |
| <p>Install the latest version of Eclipse from |
| <a class="ulink" href="http://www.eclipse.org/downloads/" target="_new">here</a>. AMP requires version 3.5.x (Gallieo) or higher. Version 3.6 (Hellos) which is currently a development (beta) release works well too. We recommend the "Classic" release at the bottom of the page as the other releases have a bunch of stuff you wont' need. |
| </p> |
| </li> |
| <li class="listitem"> |
| <p>Add update sites for AMP and AMP dependencies. See the screenshot below and the |
| <a class="ulink" href="http://help.eclipse.org/galileo/topic/org.eclipse.platform.doc.user/tasks/tasks-124.htm" target="_new">Eclipse Documentation</a>. There are different versions of the update sites, depending on whether you want to use the most stable version of the toolset or the "latest and greatest". The update sites are listed below. |
| </p> |
| </li> |
| <li class="listitem"> |
| <p>(Optional) If you install and AMP extensions, add Update Sites for them -- they're also listed below.</p> |
| </li> |
| <li class="listitem"> |
| <p>Select the features that you want to install.</p> |
| </li> |
| <li class="listitem"> |
| <p>Click the |
| <span class="bold"><strong>Next</strong></span> button, review the licenses, and then click |
| <span class="bold"><strong>Finish</strong></span>. |
| </p> |
| </li> |
| </ol> |
| </div> |
| <p>Agent Modeling Platform update sites:</p> |
| <div class="literallayout"> |
| <p>Milestones (recommended): http://download.eclipse.org/amp/updates/milestones<br> |
| Interim (newer): http://download.eclipse.org/amp/updates/interim<br> |
| Nightly (bleeding edge): http://download.eclipse.org/amp/updates/nightly<br> |
| |
| </p> |
| </div> |
| <p>Update sites for AMP Extensions</p> |
| <div class="literallayout"> |
| <p>AGF 3D (recommended): http://lwjgl.org/update<br> |
| AMF for Ascape (recommended for Java developers): http://ascape.sourceforge.net/eclipse<br> |
| AMF for Repast (for people using Repast): http://mirror.anl.gov/pub/repastsimphony/site.xml (non P2)<br> |
| |
| </p> |
| </div> |
| <p>In the following screenshot, we've added the LWJGL site (not shown) as well as the Ascape site (not shown), but not the Repast site, and we're about to install the respective features. </p> |
| <p> |
| |
| </p> |
| <div class="mediaobject"> |
| <img src="images/resources/AMPUpdateSite.png"></div> |
| <p> |
| |
| </p> |
| <p>Once you've done that, select the |
| <span class="bold"><strong>Help > Help Contents</strong></span> menu, find the Agent Modeling Guide and open this overview page within that guide. |
| </p> |
| </div> |
| <div class="section" title="Extensions"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h3 class="title"> |
| <a name="Extensions"></a>Extensions</h3> |
| </div> |
| </div> |
| </div> |
| <div class="section" title="Ascape"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h4 class="title"> |
| <a name="Ascape"></a>Ascape</h4> |
| </div> |
| </div> |
| </div> |
| <p>For licensing and copyright reasons we can't provide all of the Ascape tools and manual on the Eclipse hosted Agent Modeling Project site. None of these tools are necessary to use AMP (the core Ascape support is an IP approved part of the AMP distribution) but they're highly recommended. The Ascape tools include:</p> |
| <div class="orderedlist"> |
| <ol class="orderedlist" type="1"> |
| <li class="listitem"> |
| <p>An excellent Manual covering programming Java models in Ascape and Escape. (The API is the same.)</p> |
| </li> |
| <li class="listitem"> |
| <p>Support for creating Ascape Java projects and executing the Swing-based Java Applications. Swing deployed Ascape Java Applications can be as small as 10MB and can be deployed to the web.</p> |
| </li> |
| <li class="listitem"> |
| <p>Eclipse based IDE support for plain Java Ascape projects.</p> |
| </li> |
| </ol> |
| </div> |
| <p>The Ascape update site is at:</p> |
| <div class="literallayout"> |
| <p>http://ascape.sourceforge.net/eclipse<br> |
| |
| </p> |
| </div> |
| <p>To install Ascape, use the update manager. Select |
| <span class="bold"><strong>Help > Install New Software..."</strong></span>, add the Ascape update site, select the Ascape category and click the |
| <span class="bold"><strong>Finish</strong></span> button. |
| </p> |
| <p> |
| |
| </p> |
| <div class="mediaobject"> |
| <img src="images/resources/AscapeUpdateSite.png"></div> |
| <p> |
| |
| </p> |
| </div> |
| <div class="section" title="Repast"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h4 class="title"> |
| <a name="Repast"></a>Repast</h4> |
| </div> |
| </div> |
| </div> |
| <p>The Repast update site is at:</p> |
| <div class="literallayout"> |
| <p>http://mirror.anl.gov/pub/repastsimphony/site.xml<br> |
| |
| </p> |
| </div> |
| <p>More information on downloading and installing repast can be found |
| <a class="ulink" href="http://repast.sourceforge.net/docs/development.html" target="_new">here</a>. Follow the instrucitons for "Configuration B". |
| </p> |
| </div> |
| </div> |
| </div> |
| <div class="section" title="Models"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h2 class="title" style="clear: both"> |
| <a name="Models"></a>Models</h2> |
| </div> |
| </div> |
| </div> |
| <div class="section" title="Obtaining Example Models"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h3 class="title"> |
| <a name="Obtaining_Example_Models"></a>Obtaining Example Models</h3> |
| </div> |
| </div> |
| </div> |
| <p>There is a cheat-sheet available for obtaining the example models. If you would rather obtain them yourself, here is the CVS information:</p> |
| <div class="section" title="Team Project Sets"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h4 class="title"> |
| <a name="Team_Project_Sets"></a>Team Project Sets</h4> |
| </div> |
| </div> |
| </div> |
| <p>You can use the following team project sets. See |
| <a class="ulink" href="http://help.eclipse.org/galileo/topic/org.eclipse.platform.doc.user/tasks/tasks-cvs-project-set.htm" target="_new">this document</a> for more information about using project sets. |
| </p> |
| <div class="literallayout"> |
| <p>http://eclipse.org/amp/project-sets/ascape.psf<br> |
| http://eclipse.org/amp/project-sets/escapeAMFExamples.psf<br> |
| |
| </p> |
| </div> |
| </div> |
| <div class="section" title="From Version Control Systems"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h4 class="title"> |
| <a name="From_Version_Control_Systems"></a>From Version Control Systems</h4> |
| </div> |
| </div> |
| </div> |
| <p>Import the CVS projects from the AMP project repository. For help, see |
| <a class="ulink" href="http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.platform.doc.user/reference/ref-40a.htm" target="_new">this page</a>. Here are the details for CVS Access: |
| </p> |
| <p>CVS Repository:</p> |
| <div class="literallayout"> |
| <p>Connection type: pserver<br> |
| User: anonymous<br> |
| Password: [none]<br> |
| Host: dev.eclipse.org<br> |
| Path: /cvsroot/modeling<br> |
| Module: /org.eclipse.amp<br> |
| |
| </p> |
| </div> |
| <p>AMF Escape Models:</p> |
| <div class="literallayout"> |
| <p>org.eclipse.amp/org.eclipse.amp.amf/examples/org.eclipse.amp.amf.examples.escape <br> |
| |
| </p> |
| </div> |
| <p>AMF Ascape and Repast Models:</p> |
| <div class="literallayout"> |
| <p>org.eclipse.amp/org.eclipse.amp.amf/examples/org.eclipse.amp.amf.examples.ascape <br> |
| org.eclipse.amp/org.eclipse.amp.amf/examples/org.eclipse.amp.amf.examples.repast <br> |
| |
| </p> |
| </div> |
| <p>The Ascape example projects are available at the Sourceforge SVN server. You can get them at the following locations. See the |
| <a class="ulink" href="/wiki/http://www.eclipse.org/subversive/documentation/teamSupport/find_check_wiz.php_Subversive_User_Guide" target="_new">http://www.eclipse.org/subversive/documentation/teamSupport/find_check_wiz.php Subversive User Guide</a> for more information about using SVN. (You'll need to install Subversion if you don't already have it.) |
| </p> |
| <p>Escape Java Models:</p> |
| <div class="literallayout"> |
| <p>https://ascape.svn.sourceforge.net/svnroot/ascape/org.ascape.models.brook<br> |
| https://ascape.svn.sourceforge.net/svnroot/ascape/org.ascape.models.examples<br> |
| |
| </p> |
| </div> |
| <p>Ascape (Swing-based) Java Models:</p> |
| <div class="literallayout"> |
| <p>https://ascape.svn.sourceforge.net/svnroot/ascape/org.ascape.escape.models.examples<br> |
| https://ascape.svn.sourceforge.net/svnroot/ascape/org.ascape.escape.models.brook<br> |
| |
| </p> |
| </div> |
| </div> |
| </div> |
| </div> |
| </div> |
| <div class="navfooter"> |
| <hr> |
| <table summary="Navigation footer" width="100%"> |
| <tr> |
| <td align="left" width="40%"><a accesskey="p" href="Programer_Guide.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="New_and_Noteworthy.html">Next</a></td> |
| </tr> |
| <tr> |
| <td valign="top" align="left" width="40%">Chapter 5. Programer Guide </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> Chapter 7. New and Noteworthy</td> |
| </tr> |
| </table> |
| </div> |
| </body> |
| </html> |