Page History

...

Warning

The instruction contain on this page are designed to be implemented on a Educational Systems supplied VM. All the software components that are needed have been preconfigured on the VM.

If you are using a workstation which is not a pre-configured Educational Systems VM, then you will probably need to install additional software on your workstation.

The

Section 2: Setting mit-release-plugin

-parent Maven Project ReconfigurationStep 1: The

debugging break points
This section is designed to assist the first time user in setting debugging break points.
Section 3: Debugging the mit-release-plugin

-parent Maven Project ReconfigurationCheck-out the maven project for

This section is designed to assist the first time user in debugging the mit-release-plugin.

Panel

Quick Links to:

Table of Contents

minLevel	3
maxLevel	3

Panel

Anchor

	overview
	overview

OVERVIEW

To setup the development environment for working with the mit-release-plugin for MOVES, there are 3 steps that must be completed. These 3 steps are:

Section 1 - Step 1: The mit-release-plugin-parent Maven Project Reconfiguration
Reconfigure the POM.XML for the mit-release-plugin-parent and it's children.
There is nothing new here and you should know how to do the above relative to the IDE that you are using.
Section 1 - Step 2: The sais-moves-web Maven Project Reconfiguration
Reconfigure the POM.XML for the sais-moves-web Maven project.
Again, there is nothing new here and you should know how to do the above relative to the IDE that you are using.
Section 1 - Step 3: The Moves Development Environment Setup
This step explains how to setup the MOVES Development Environment.
It explains how to obtain and configure the Moves properties files as well as how to construct and configure the directory structure that is used by Moves.

It should take you approximately 15 - 20 minutes to complete all the 3 above steps.

Panel

Anchor

The mit-release-plugin-parent Maven Project Reconfiguration

svn+ssh://svn.mit.edu/sais-sis-common/maven/plugins/

Panel

Anchor

	The mit-release-plugin-parent Maven Project Reconfiguration
	The

The SVN repository is:

Code Block

mit-release-plugin

/trunk Open the mit-release-plugin maven project in your IDE.

-parent Maven Project Reconfiguration

Section 1 - Step 1: The

Open the pom.xml's for each of the following projects:

mit-release-plugin-parent Maven Project Reconfiguration

mit-release-plugin

Check-out the maven project for the

mit-release-plugin

-common

. The SVN repository is:

Code Block
svn+ssh://svn.mit.edu/sais-sis-common/maven/plugins/mit-release-plugin/trunk

Open the mit-release-plugin maven project in your IDE.
1. Open -integration-testsIn each of the pom.xml's for each of the following projects:
  - mit-release-plugin-parent
  - mit-release-plugin
  - mit-release-plugin-common
  - mit-release-plugin-integration-tests
2. In each of the pom.xml's for the above, remove the above, remove all occurances of -SNAPSHOT from the <version> tags.
  There are a total of 7 occurances that have to be changed.
  - EXAMPLE: <version>2.0.21-SNAPSHOT</version> becomes <version>2.0.21</version>

When you are satisfied that everything is correct, save the changes that you made to the pom.xml's.

The mit-release-plugin-parent Maven Project Reconfiguration is now complete.

Panel

Anchor

	The sais-moves-web Maven Project Reconfiguration
	The sais-moves-web Maven Project Reconfiguration

Section 1 - Step 2: The sais-moves-web Maven Project Reconfiguration

Check-out the maven project for the sais-moves-web. The SVN repository is:
Code Block
svn+ssh://svn.mit.edu/sais-sis-common/sais-moves-web/trunk

Open the sais-moves-web maven project in your IDE.

Open the sais-moves-web project pom.xml for editing.
In the <dependencies> section, add the following dependency:
Code Block
<dependency> <groupId>edu.mit.maven.plugins</groupId> <artifactId>mit-release-plugin</artifactId> <version>2.0.21</version> </dependency>
Change the <version>, in the above, to the mit-release-plugin version that you selected in Section 1.
The above dependency makes the source code for the mit-release-plugin available to the IDE's debugger.
In the <dependencies> section, find the following dependency:
Code Block
<dependency> <groupId>edu.mit.maven.plugins</groupId> <artifactId>mit-release-plugin-common</artifactId> <version>[0.0.0,999.999.999)</version> </dependency>
Change the <version>, in the above, to the mit-release-plugin version that you selected in Section 1.
In the <plugins> section of the pom.xml, find the following plugin with the following groupId and artifactId:
NOTE The version number may be differ from 2.0.21.
Code Block
<plugin> <groupId>edu.mit.maven.plugins</groupId> <artifactId>mit-release-plugin</artifactId> <version>2.0.21</version> . . </plugin>
Change the <version> for the above plugin to the mit-release-plugin version that you selected in Section 1.

Open the log4j.xml (located in the resources folder) for editing and add the following <logger>:

Code Block
<logger name="edu.mit.moves.shell.logging"> <level value="INFO" /> </logger>

Tip

title	OPTIONAL

If you are only interested in debugging the mit-release-plugin, you might want to changed the <level> of all the other <logger>s to FATAL. If you do this, all output to the system console will be surpress except for the output from the mit-release-plugin.

When you are satisfied that everything is correct, save the changes that you made.

The sais-moves-web Maven Project Reconfiguration is now complete.

{anchor:The Moves Development Environment Setup} h3. Step 3: The Moves Development Environment Setup # Download the following files: {warning} The following 2 properties files are the be used solely and exclusively in the software development environment on an Educational Systems VM.  They are *NOT* to be deployed to the development, test or production servers. {warning} ## Download and install the *

Download the following files:

Panel

Anchor

	The Moves Development Environment Setup
	The Moves Development Environment Setup

Section 1 - Step 3: The Moves Development Environment Setup

Wiki Markup

Warning
The following 2 properties files are the be used solely and exclusively in the software development environment on an Educational Systems VM. They are NOT to be deployed to the development, test or production servers.

Download and install the

1. sais-moves-web.properties

*

1. file

1. (

[

1. right

1. click

1. on

1. this

link | ^sais-moves-web.properties] then select *Save

1. link then select Save target/link

1. as...

*.  Navigate to the *

1. . Navigate to the ${user.home}

*

1. directory

1. and

1. click

*

1. Save

*) ## Click here to [Download the

1. )
2. Download and install the sais-moves-web-build.properties

file | ^sais-moves-web.properties].  Select *Save as* to your $\

1. file (right click on this link then select Save target/link as.... Navigate to the ${user.home}

directory. ## Click here to [Download the

1. directory and click Save)
2. Open the sais-moves-web-build.properties

file | ^sais-moves-web-build.properties].  Select *Save as* to your $\{user.home} directory. \\ ## Open the sais-moves-web-build.properties file for editing and change the following properties: \\ ##* *mit.maven.release.

1. file for editing and change the following properties:
  - mit.maven.release.plugin.version=2.0.21

*  Change the version number

1. - Change the version number (2.0.21)

1. - to

1. - the

1. - mit-release-plugin

1. - version

1. - number

1. - that

1. - you

1. - selected

1. - in

1. - section

1. - 1.

##* *

1. - maven.system.property.cargo.hostname=esvm-1xx.mit.edu

*  Change the hostname

1. - Change the hostname (esvm-1xx.mit.edu)

1. - to

1. - your

1. - vm's

1. - hostname.

\\ \\ # Configure your moves build directories \\ ## Create the following directories: \\ ##* *

Configure your moves build directories
1. Create the following directories:
  - C:\tmp\movesbuild\build\sais-common-conf\.m2\repository

* ##* *

1. - C:\tmp\movesbuild\build\sais-common-conf\servers\oc4j

* {note} Please note that the .m2 directory {color:red}cannot{color} be created using Windows Explorer.  To create the .m2 directory, you must open a cmd window, cd to the

1. - Note
    Please note that the .m2 directory cannot be created using Windows Explorer. To create the .m2 directory, you must open a cmd window, cd to the sais-common-conf

1. - directory

1. - and

1. - use

1. - mkdir

1. - to

1. - create

1. - the

1. - .m2

1. - directory.

{note} ## Open a *cmd window* and *cd* to the *

2. Open a cmd window and cd to the C:\tmp\movesbuild\build\sais-common-conf\.m2

*

1. directory.

  Execute the following command: {code}

Execute the following command:

Code Block
linkd repository c:\Users\esuser\.m2\repository

{code}

1. The

1. above

1. command

1. will

1. link

1. your

1. local

1. maven

1. repository

1. to

1. the

1. directory

1. C:\tmp\movesbuild\build\sais-common-conf\.m2\repository.

{

1. Warning

}

1. Do

1. not

1. delete

1. or

1. rename

1. the

1. repository

1. directory.

  Deleting or Renaming the repository directory will delete your local maven repository.  Unlink the repository directory before you delete or rename. {warning} {tip} You can unlink the repostory directory with the following command: {code}

1. Deleting or Renaming the repository directory will delete your local maven repository. Unlink the repository directory before you delete or rename.
  Tip
  You can unlink the repostory directory with the following command:
  Code Block
  linkd repository /D

{code}

1. You

1. must

1. be

1. in

1. the

*

1. .m2

1. directory

*

1. when

1. you

1. execute

1. the

1. above

1. command.

{tip} ## Download and install the *

2. Download and install the settings.xml

*

1. (

[

1. right

1. click

1. on

1. this

1. link

| Install Maven^settings.xml]

1. then

1. select

*

1. Save

1. target/link

1. as...

*.  Navigate to the *.m2* directory

1. . Navigate to the .m2 directory you've

1. just

1. created

1. and

1. click

*

1. Save

*) \\ \\ Open the *

1. )
  
  Open the settings.xml

*

1. for

1. editing

1. and

1. change

1. the

1. following:

\\ \\ ##* Change the property value for *

1. - Change the property value for <oc4j.j2eeHome>

*

1. - to:

{

1. - Code Block

}


/oracle-oc4j-10.1.3.5.0-server/j2ee/home

{code} ##* Change the property value for *

1. - Change the property value for <oc4j.password>

*

1. - to:

{

1. - Code Block

}

1. - oc4jadmin

{code} ## In a cmd window, *cd* to the *

2. In a cmd window, cd to the C:\tmp\movesbuild\build\sais-common-conf\servers

*

1. directory.

  Execute the following command: {code}

Execute the following command:

Code Block
linkd oc4j c:\oracle-oc4j-10.1.3.5.0-server

{code}

1. The

1. above

1. command

1. will

1. link

1. your

1. local

1. oracle

1. server

1. to

1. the

1. directory

1. C:\tmp\movesbuild\build\sais-common-conf\servers\oc4j.

{

1. Warning

}

1. Do

1. not

1. delete

1. or

1. rename

1. the

1. oc4j

1. directory.

  Deleting or Renaming the oc4j directory will delete your local oracle server.  Unlink the oc4j directory before you delete or rename. {warning} {tip} You can unlink the oc4j directory with the following command: {code}

1. Deleting or Renaming the oc4j directory will delete your local oracle server. Unlink the oc4j directory before you delete or rename.
  Tip
  You can unlink the oc4j directory with the following command:
  Code Block
  linkd oc4j /D

{code}

1. You

1. must

1. be

1. in

1. the

*

1. servers

1. directory

*

1. when

1. you

1. execute

1. the

1. above

1. command.

{tip} # Configure your moves ui directories \\ ## Create the following directories: \\ ##* *

Configure your moves ui directories
1. Create the following directories:
  - C:\tmp\movesbuild\ui\sais-common-conf\.m2\repository

* ##* *

1. - C:\tmp\movesbuild\ui\sais-common-conf\servers\oc4j

* {note} Please note that the .m2 directory {color:red}cannot{color} be created using Windows Explorer.  To create the .m2 directory, you must open a cmd window, cd to the

1. - Note
    Please note that the .m2 directory cannot be created using Windows Explorer. To create the .m2 directory, you must open a cmd window, cd to the sais-common-conf

1. - directory

1. - and

1. - use

1. - mkdir

1. - to

1. - create

1. - the

1. - .m2

1. - directory.

{note} ## Open a *cmd window* and *cd* to the *

2. Open a cmd window and cd to the C:\tmp\movesbuild\ui\sais-common-conf\.m2

*

1. directory.

  Execute the following command: {code}

Execute the following command:

Code Block
linkd repository c:\Users\esuser\.m2\repository

{code}

1. The

1. above

1. command

1. will

1. link

1. your

1. local

1. maven

1. repository

1. to

1. the

1. directory

1. C:\tmp\movesbuild\ui\sais-common-conf\.m2\repository.

{

1. Warning

}

1. Do

1. not

1. delete

1. or

1. rename

1. the

1. repository

1. directory.

  Deleting or Renaming the repository directory will delete your local maven repository.  Unlink the repository directory before you delete or rename. {warning} {tip} You can unlink the repostory directory with the following command: {code}

1. Deleting or Renaming the repository directory will delete your local maven repository. Unlink the repository directory before you delete or rename.
  Tip
  You can unlink the repostory directory with the following command:
  Code Block
  linkd repository /D

{code}

1. You

1. must

1. be

1. in

1. the

*

1. .m2

1. directory

*

1. when

1. you

1. execute

1. the

1. above

1. command.

{tip} ## Download and install the *

2. Download and install the settings.xml

*

1. (

[

1. right

1. click

1. on

1. this

1. link

| Install Maven^settings.xml]

1. then

1. select

*

1. Save

1. target/link

1. as...

*.  Navigate to the *.m2* directory

1. . Navigate to the .m2 directory you've

1. just

1. created

1. and

1. click

*

1. Save

*) \\ \\ Open the *

1. )
  
  Open the settings.xml

*

1. for

1. editing

1. and

1. change

1. the

1. following:

\\ \\ ##* Change the property value for *

1. - Change the property value for <oc4j.j2eeHome>

*

1. - to:

{

1. - Code Block

}


/oracle-oc4j-10.1.3.5.0-server/j2ee/home

{code} ##* Change the property value for *

1. - Change the property value for <oc4j.password>

*

1. - to:

{

1. - Code Block

}

1. - oc4jadmin

{code} ## In a cmd window, *cd* to the *

2. In a cmd window, cd to the C:\tmp\movesbuild\ui\sais-common-conf\servers

*

1. directory.

  Execute the following command: {code}

Execute the following command:

Code Block
linkd oc4j c:\oracle-oc4j-10.1.3.5.0-server

{code}

1. The

1. above

1. command

1. will

1. link

1. your

1. local

1. oracle

1. server

1. to

1. the

1. directory

1. C:\tmp\movesbuild\ui\sais-common-conf\servers\oc4j.

{

1. Warning

}

1. Do

1. not

1. delete

1. or

1. rename

1. the

1. oc4j

1. directory.

  Deleting or Renaming the oc4j directory will delete your local oracle server.  Unlink the oc4j directory before you delete or rename. {warning} {tip} You can unlink the oc4j directory with the following command: {code}

1. Deleting or Renaming the oc4j directory will delete your local oracle server. Unlink the oc4j directory before you delete or rename.
  Tip
  You can unlink the oc4j directory with the following command:
  Code Block
  linkd oc4j /D

{code}

1. You

1. must

1. be

1. in

1. the

*

1. servers

1. directory

*

1. when

you execute the above command. {tip} h4. {color:green}The Moves Development Environment Setup is now complete{color}

1. you execute the above command.

The Moves Development Environment Setup is now complete.

Section 1 is now complete.

Panel

Anchor

	Setting mit-release-plugin debugging break points
	Setting mit-release-plugin debugging break points

Section 2: Setting mit-release-plugin debugging break points

Build and install mit-release-plugin-parent.
Build, install and deploy sais-moves-web to your oracle server.
Setting break points.
Attaching the IDE's debugger.

Panel

Anchor

	Debugging the mit-release-plugin
	Debugging the mit-release-plugin

Step 4

Section 3: Debugging the mit-release-plugin

Build and install mit-release-plugin-parent.
Build, install and deploy sais-moves-web to your oracle server.
Setting break points.
Attaching the IDE's debugger.

Child pages

Versions Compared

Old Version 98

New Version Current

Key

OVERVIEW

Section 1 - Step 1: The

mit-release-plugin-parent Maven Project Reconfiguration

The mit-release-plugin-parent Maven Project Reconfiguration is now complete.

Section 1 - Step 2: The sais-moves-web Maven Project Reconfiguration

The sais-moves-web Maven Project Reconfiguration is now complete.

Section 1 - Step 3: The Moves Development Environment Setup

The Moves Development Environment Setup is now complete.

Section 1 is now complete.

Section 2: Setting mit-release-plugin debugging break points

Section 3: Debugging the mit-release-plugin