Mcom Integration

{{toc}}

h1. Setup Development Environment

This guide describes how to setup the development environment which contains the following components:

* Eclipse IDE (_Galileo_)

* Jboss AS 4.0.4 (_local deployment only_)

* Jboss AS 4.2.2 (_local deployment only_)

* Jetty 7.5.1 (_local & remote deployment_)

All of the projects requires *JDK 6.0*.

h2. Steps

> *Note:* Refer to the [[Setup_Development_Environment#Setup-Files|Setup Files]] section to get all of the required files.

# Download and extract the following files to <code>C drive (C:\)</code>:

** [[Setup_Development_Environment#Setup-Files|Eclipse Galileo]]

** [[Setup_Development_Environment#Setup-Files|Eclipse Workspace]]

** [[Setup_Development_Environment#Setup-Files|Jboss AS 4.0.4]]

** [[Setup_Development_Environment#Setup-Files|Jboss AS 4.2.2]]

# Install the [[Setup_Development_Environment#Setup-Files|JDK 6.0 Update 23]] into <code>c:\program files</code>

# Edit *eclipse.ini* <code>(c:\eclipse_galileo)</code> and confirm if it's pointing to the JDK in which installed in the previous step:

<pre>

-vm

C:/Program Files/Java/jdk1.6.0_23/jre/bin/client/jvm.dll

</pre>

# Launch the *Eclipse IDE* <code>(c:\eclipse_galileo\eclipse.exe)</code> and choose the *workspace* <code>(c:\eclipse_mcom)</code> that extracted in the previous step

# Navigate to _[Window -> Preferences -> Java -> Installed JREs]_ and make sure the workspace is using *JDK*, not JRE, and it's pointing to the JDK location that installed in the previous step

# Click on the *CVS Repository* view _(located at the left bottom of the workspace)_ and *update the user* for *all* of the repositories:

** _right click on the repository -> Properties -> User_

# Finally, do a *CVS Update* on all of the project(s)

** _right click on the project -> Team -> Update_

# done

h2. Setup Files

|_.Filename|_.Description|

|"Eclipse Galileo":http://192.168.2.13/download/eclipse_galileo.zip|Eclipse IDE|

|"Eclipse Workspace":http://192.168.2.13/download/eclipse_mcom.zip|The Eclipse workspace|

|"Jboss AS 4.0.4":http://192.168.2.13/download/jboss-4.0.4.GA.zip|Jboss Application Server 4.0.4|

|"Jboss AS 4.2.2":http://192.168.2.13/download/jboss-4.2.2.GA.zip|Jboss Application Server 4.2.2|

|"JDK 5.0 Update 20":http://192.168.2.13/download/jdk-1_5_0_20-windows-i586-p.exe|JDK 5.0 with Update 20 for Windows|

|"JDK 6.0 Update 23":http://192.168.2.13/download/jdk-6u23-windows-i586.exe|JDK 6.0 with Update 23 for Windows|

h1. How to Deploy

h2. Local

# clean and rebuild the <code>mcom-connector</code> project

# open *Java EE* or *Java* perspective

# _[right click on the project]_ and choose _[Debug As -> Run Jetty]_

# if started, you can access the application via:

> http://127.0.0.1:8080/mcom-connector/

h2. Remote 

# clean and rebuild the <code>mcom-connector</code> project

# open *Java EE* or *Java* perspective

# execute the *remote-deploy* Ant target in the *build.xml*

** _existing deployment folder will be overwritten_

# if succeed, you can access the application via:

> http://192.168.2.13:58080/mcom-connector/

h1. How to Debug

# add the desired *breakpoint(s)* on the Java or JSP

# open *Debug* perspective

# _[right click on the project]_ and choose _[Debug As -> Run Jetty]_

# if started, you can access the application via the following URL and begin the debug session:

> http://127.0.0.1:8080/mcom-connector/

*Extra*: Refer to this "link":http://www.vogella.de/articles/EclipseDebugging/article.html for more info about the <code>Debugging in Eclipse IDE</code>.