Make Agents Yourself

h1. SpeADL MAY Installation

h2. Java Development Kit

You will need to install the Java Development Kit (JDK) in order to run Eclipse.

You can donwload it here if you don't have it already : http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u25-download-346242.html

h2. Eclipse Helios

The following instructions will guide you through the SpeADL MAY installation process.

Sometimes, eclipse answer delay are a bit long, make sure you don't abort an operation thinking it crashed, wait for it to finish.

You will need the latest Eclipse *Helios* distribution. The Eclipse IDE for Java Developers will be fine.

*Warning : make sure you download the version that matches your JDK. If you have a 32bits JDK, take the 32bits version of Eclipse Helios. If you have the 64bits JDK, choose Eclipse Helios 64bits.*

You can download Eclipse Helios here: http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/heliossr2

This entire tutorial has been written for this particular Helios eclipse version, so make sure you download and use this one.

Install it and launch it.

There is a known bug on windows that requieres eclipse to be launched in administrator mode in order to install plugin correctly.

Make sure you always launch it in this mode during the installation process.

h2. Eclipse and proxy

If you are behind a proxy you may need to configure eclipse.

*Window* / *Preferences*

!https://wwwsecu.irit.fr/redmine/attachments/download/390/eclipse_proxy1.jpg!

Type *connection* in the text field and it will bring the following :

!https://wwwsecu.irit.fr/redmine/attachments/download/391/eclipse_proxy2.jpg!

Select *Network Connections* and choose *Manual* for the Active Provider setting.

Then select the ligne with *HTTP* and click *Edit*.

!https://wwwsecu.irit.fr/redmine/attachments/download/392/eclipse_proxy3.jpg!

Enter your Host and Port information. At the IRIT these are :

*Host* : proxy.irit.fr

*Port* : 8001

!https://wwwsecu.irit.fr/redmine/attachments/download/394/eclipse_proxy5.jpg!

Click *OK*.

Do the same for the *HTTPS* line. You should obtain the following :

!https://wwwsecu.irit.fr/redmine/attachments/download/393/eclipse_proxy4.jpg!

Click *OK*.

h2. Make Agents Yourself Plugin

Now you are ready to install the MAY plugin for eclipse : *Help* / *Install New Software...* / *Add...*

*Name* : may

*Location* : http://www.irit.fr/~Victor.Noel/may/update-may-2/

!https://wwwsecu.irit.fr/redmine/attachments/download/349/new_may_add_repo.jpg!

Select *Make Agents Yourself* and click *Next*. It will take some times calculating requirements and dependencies.

Click *Next* again when it shows you the install details and accept the terms of the licence agreements, then *Finish*.

Click *OK* when you get the security warning, and accept to restart Eclipse now.

!https://wwwsecu.irit.fr/redmine/attachments/download/339/security_warning.jpg!

h2. MAVEN plugin

http://eclipse.org/m2e/

With this tool, you can easily publish projects informations and share JARs across several projects.

Installing it will save you a lot of time trying to navigate many projects, and will allow you to quickly start using MAY, resolving dependencies and providing you access to existing MAY components.

Follow the instructions on this page to install it : [[Maven Plugin Install for Eclipse]]

h2. SpeADL MAY project Setup

When all is installed and that you have configured Maven to work with your proxy, you are ready to create a MAY project.

For further instructions, click here: [[SpeADL MAY Project SetUp]]

h1. Sources

The source code can be downloaded using the Mercurial DVCS:

MAY:

 hg clone https://anon@wwwsecu.irit.fr/hg/SMAC/victor-noel-phd/may/may/

Libraries and examples:

 hg clone https://anon@wwwsecu.irit.fr/hg/SMAC/victor-noel-phd/may/lib/

For Mercurial integration in Eclipse, use the following plugin: http://javaforge.com/project/HGE

In particular, the following update site can be used:

 http://cbes.javaforge.com/update