blob: 7e947290e3dc6a8b6e5b7befb3cfb1fb50f0615e [file] [log] [blame]
<h2>Installing AMP using Update Sites (Recommended)</h2>
<ol>
<li><b>Install the latest version of Eclipse from <a href="http://eclipse.org/downloads" />here</a>.</b>
<p>AMP is built for Eclipse 3.6 (Helios). We recommend the "Eclipse Modeling Tools" release, though "Eclipse
Classic"" also works well.*</p>
</li>
<li><b>Add update sites for AMP and AMP dependencies.</b>
<p>Look <a href="http://help.eclipse.org/galileo/topic/org.eclipse.platform.doc.user/tasks/tasks-124.htm">here</a>
for more details.**</p>
<ul>
<li><b>Add External Update Site(s)</b>
<p><i>Before</i> installing AMP itself, you'll want to add the external Update Sites for Agent Modeling
Extensions. ** Simply type the URL in the "Work with:" box and hit return. For most usages, you'll just need
to add the LWJGL update site as shown below. Don't actually install anything yet.</p>
<ul>
<li><b>AGF 3D (recommended):</b> <a href="http://lwjgl.org/update">http://lwjgl.org/update</a></li>
<li>AMF for Ascape (optional): <a href="http://ascape.sourceforge.net/eclipse">http://ascape.sourceforge.net/eclipse</a></li>
<li>AMF for Repast (challenging): <a href="http://mirror.anl.gov/pub/repastsimphony/site.xml">http://mirror.anl.gov/pub/repastsimphony/site.xml</a>
(non P2)</li>
</ul>
<img src="../images/AMPInstallLWJGL.png" /></li>
<li><b>Add AMP Update Site</b>
<p>Enter one of the following URLs in the "Work with:" box and press enter.</p>
<ul>
<li><b>Release (recommended for new users)</b>: <a
href="http://download.eclipse.org/amp/updates/releases">http://download.eclipse.org/amp/updates/releases</a></li>
<li>Milestones (recommended for seasoned users): <a
href="http://download.eclipse.org/amp/updates/milestones">http://download.eclipse.org/amp/updates/milestones</a></li>
<li>Interim (most recent features): <a href="http://download.eclipse.org/amp/updates/interim">http://download.eclipse.org/amp/updates/interim</a></li>
<li>Nightly (bleeding edge, useful for troubleshooting): <a
href="http://download.eclipse.org/amp/updates/nightly">http://download.eclipse.org/amp/updates/nightly</a></li>
</ul>
</li>
</ul>
</li>
<li><b>Install desired features.</b>
<p>Just select the Agent Modeling category plus any of the features in the Agent Modeling Extensions category
that you've added external sites for.*** For most users, the selections shown below are recommended. Just make your
selection, click the <b>Next</b> button and follow the remaining prompts.</p>
<img src="../images/AMPInstall.png" /></li>
</ol>
<p><small>* It is possible that some AMP components will function in earlier versions of Eclipse, but this
usage isn't recommended or supported.</small></p>
<p><small>** It is not neccessary to actually install the features, just add the update site. It usually
works better to enter all of the update sites first, and then select all of the features you will need. But if you run
into issues, try installing the features in the "Agent Modeling" category only into a fresh Eclipse install..</small></p>
<p><small>**We recommend installing the LWJGL libraries and AGF3D as AGF3D adds important capabilities to
Escape. On the other hand, you should only install the Repast extensions if you are planning on using Repast actively,
as it currently carries a large number of dependencies of its own. Finally note that the Ascape target allows execution
of models externally using the original Ascape Swing User Interface. If you want to run models written for the Ascape
API using the Eclipse hosted Escape environment, you do not need this feature.</small></p>