MAGE: Do it yourself procedure for latest version
Posted: 29 Jul 2011, 16:29
Disclaimer: I am a newbie. The technique used here is probably overkill, but it works for me. Oh and this is a rough draft. Please copy your "Plugins\Images" folder out of your current MAGE installation so that you don't have to download them again.
1. Download latest JDK and install. Note that this is different from a generic JRE installation.
http://www.oracle.com/technetwork/java/ ... 32154.html
2. Set the JAVA_HOME and PATH environmental variables correctly! You should be able to execute "java" or "javac" from any folder.
3. Download latest Maven and install.
http://maven.apache.org/download.html
4. Set the M2 and M2_HOME environmental variables correctly! You should be able to execute "mvn" from any folder.
5. Download an IDE. I will use Eclipse for this example.
http://www.eclipse.org/downloads/packag ... 37/indigor
6. MAGE uses Mercurial. In Eclipse, select the Help menu and choose "Install new software...". In the "Work with:" field, paste this link:
http://cbes.javaforge.com/update
When you refresh the field, you should see "Mercurial Eclipse" in the window below. Select it and install...restart Eclipse.
7. Install Maven for Eclipse. Using the procedure above, put this link in the field instead:
http://download.eclipse.org/technology/m2e/releases/
8. Make sure you have the Eclipse JRE configuration set up correctly. Select the Windows menu and select Preferences. Select Java and Installed JRE's. Make sure the default is pointing to your JDK folder, not the JRE folder. You will get a tools.jar missing error if not.
9. Select the File menu and Choose "Import...". You should see a "Mercurial" folder. Expand it and choose "Clone an Existing Mercurial Repository". Paste the following in the "Repository Location" field:
https://code.google.com/p/mage/
and select next. The cloning process will take a long time, so just let it roll. Eventually, you will see a screen that lists the different working directory revisions. Select the "default" one and select next. After a bit of time you will see an "Import Projects" screen with our project already checked. Select Finish.
You should now see the MAGE project in the left-hand pane. Expand it. Note the "pom.xml" file at the bottom of the project. Right-click it and select "Run As" and select "Maven Install". If everything is configured correctly, the project will be built successfully after several minutes.
10. Open a terminal prompt/command prompt.
11. Go to the folder "mage-client" Here is my path:
c:\users\noob\workspace\magetest\mage-client
12. Enter the command "mvn clean assembly:assembly" without the quotes.
This will generate a zip file of the client application within the "target" folder. Again, my path:
c:\users\noob\workspace\magetest\mage-client\target
13. Do step 11 within the "mage-server" folder.
14. Copy the mage-client.zip and mage-server.zip to whatever location you wish to run MAGE. Extract them into their respective folders.
15. Execute the server application first followed by the client via their respective batch files.
1. Download latest JDK and install. Note that this is different from a generic JRE installation.
http://www.oracle.com/technetwork/java/ ... 32154.html
2. Set the JAVA_HOME and PATH environmental variables correctly! You should be able to execute "java" or "javac" from any folder.
3. Download latest Maven and install.
http://maven.apache.org/download.html
4. Set the M2 and M2_HOME environmental variables correctly! You should be able to execute "mvn" from any folder.
5. Download an IDE. I will use Eclipse for this example.
http://www.eclipse.org/downloads/packag ... 37/indigor
6. MAGE uses Mercurial. In Eclipse, select the Help menu and choose "Install new software...". In the "Work with:" field, paste this link:
http://cbes.javaforge.com/update
When you refresh the field, you should see "Mercurial Eclipse" in the window below. Select it and install...restart Eclipse.
7. Install Maven for Eclipse. Using the procedure above, put this link in the field instead:
http://download.eclipse.org/technology/m2e/releases/
8. Make sure you have the Eclipse JRE configuration set up correctly. Select the Windows menu and select Preferences. Select Java and Installed JRE's. Make sure the default is pointing to your JDK folder, not the JRE folder. You will get a tools.jar missing error if not.
9. Select the File menu and Choose "Import...". You should see a "Mercurial" folder. Expand it and choose "Clone an Existing Mercurial Repository". Paste the following in the "Repository Location" field:
https://code.google.com/p/mage/
and select next. The cloning process will take a long time, so just let it roll. Eventually, you will see a screen that lists the different working directory revisions. Select the "default" one and select next. After a bit of time you will see an "Import Projects" screen with our project already checked. Select Finish.
You should now see the MAGE project in the left-hand pane. Expand it. Note the "pom.xml" file at the bottom of the project. Right-click it and select "Run As" and select "Maven Install". If everything is configured correctly, the project will be built successfully after several minutes.
10. Open a terminal prompt/command prompt.
11. Go to the folder "mage-client" Here is my path:
c:\users\noob\workspace\magetest\mage-client
12. Enter the command "mvn clean assembly:assembly" without the quotes.
This will generate a zip file of the client application within the "target" folder. Again, my path:
c:\users\noob\workspace\magetest\mage-client\target
13. Do step 11 within the "mage-server" folder.
14. Copy the mage-client.zip and mage-server.zip to whatever location you wish to run MAGE. Extract them into their respective folders.
15. Execute the server application first followed by the client via their respective batch files.