Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel

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

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

  1. 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
    
  2. Open the sais-moves-web maven project in your IDE.
    1. Open the sais-moves-web project pom.xml for editing.
    2. 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.
    3. 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.
    4. 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.
    5. 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
      titleOPTIONAL

      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.&nbsp;&nbsp;They are *NOT* to be deployed to the development, test or production servers. {warning} ## Download and install the *
  1. Download the following files:
Panel

Anchor
The Moves Development Environment Setup
The Moves Development Environment Setup

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.

  1. Download and install the
    1. sais-moves-web.properties
*
    1. file
    1. (
[
    1. right
    1. click
    1. on
    1. this
    1. link
| ^sais-moves-web.properties]
    1. then
    1. select
*
    1. Save
    1. target/link
    1. as...
*.&nbsp;&nbsp;Navigate to the *
    1. .  Navigate to the ${user.home}
*
    1. directory
    1. and
    1. click
*
    1. Save
*
    1. )
##
    1. Click
    1. here
    1. to
[
    1. Download
    1. the
    1. sais-moves-web.properties
    1. file
| ^sais-moves-web.properties].&nbsp;&nbsp;Select *Save as* to your $\
    1. .  Select Save as to your ${user.home}
    1. directory.
##
    1. Click
    1. here
    1. to
[
    1. Download
    1. the
    1. sais-moves-web-build.properties
    1. file
| ^sais-moves-web-build.properties].&nbsp;&nbsp;Select *Save as* to your $\
    1. .  Select Save as to your ${user.home}
    1. directory.
\\ ## Open the

    1. Open the sais-moves-web-build.properties
    1. file
    1. for
    1. editing
    1. and
    1. change
    1. the
    1. following
    1. properties:
\\ ##* *

      • mit.maven.release.plugin.version=2.0.21
*&nbsp;&nbsp;Change the version number
      •   Change the version number (2.0.21)
      • to
      • the
      • mit-release-plugin
      • version
      • number
      • that
      • you
      • selected
      • in
      • section
      • 1.
##* *
      • maven.system.property.cargo.hostname=esvm-1xx.mit.edu
*&nbsp;&nbsp;Change the hostname
      •   Change the hostname (esvm-1xx.mit.edu)
      • to
      • your
      • vm's
      • hostname.
\\ \\ # Configure your moves build directories \\ ## Create the following directories: \\ ##* *


  1. Configure your moves build directories
    1. Create the following directories:
      • C:\tmp\movesbuild\build\sais-common-conf\.m2\repository
* ##* *
      • 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.&nbsp;&nbsp;To create the .m2 directory, you must open a cmd window, cd to the
      • 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

      • directory

      • and

      • use

      • mkdir

      • to

      • create

      • the

      • .m2

      • directory.

{note} ## Open a *cmd window* and *cd* to the *
    1. Open a cmd window and cd to the C:\tmp\movesbuild\build\sais-common-conf\.m2
*
    1. directory.
&nbsp;&nbsp;Execute the following command: {code}
    1.   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.

&nbsp;&nbsp;Deleting or Renaming the repository directory will delete your local maven repository.&nbsp;&nbsp;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 *
    1. 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...
*.&nbsp;&nbsp;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 *


      • Change the property value for <oc4j.j2eeHome>
*
      • to:
{
      • Code Block
}
      • 
        /oracle-oc4j-10.1.3.5.0-server/j2ee/home
        
{code} ##* Change the property value for *
      • Change the property value for <oc4j.password>
*
      • to:
{
      • Code Block
}
      • 
        oc4jadmin
        
{code} ## In a cmd window, *cd* to the *
    1. In a cmd window, cd to the C:\tmp\movesbuild\build\sais-common-conf\servers
*
    1. directory.
&nbsp;&nbsp;Execute the following command: {code}
    1.   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.

&nbsp;&nbsp;Deleting or Renaming the oc4j directory will delete your local oracle server.&nbsp;&nbsp;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: \\ ##* *
  1. Configure your moves ui directories
    1. Create the following directories:
      • C:\tmp\movesbuild\ui\sais-common-conf\.m2\repository
* ##* *
      • 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.&nbsp;&nbsp;To create the .m2 directory, you must open a cmd window, cd to the
      • 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

      • directory

      • and

      • use

      • mkdir

      • to

      • create

      • the

      • .m2

      • directory.

{note} ## Open a *cmd window* and *cd* to the *
    1. Open a cmd window and cd to the C:\tmp\movesbuild\ui\sais-common-conf\.m2
*
    1. directory.
&nbsp;&nbsp;Execute the following command: {code}
    1.   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.

&nbsp;&nbsp;Deleting or Renaming the repository directory will delete your local maven repository.&nbsp;&nbsp;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 *
    1. 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...
*.&nbsp;&nbsp;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 *


      • Change the property value for <oc4j.j2eeHome>
*
      • to:
{
      • Code Block
}
      • 
        /oracle-oc4j-10.1.3.5.0-server/j2ee/home
        
{code} ##* Change the property value for *
      • Change the property value for <oc4j.password>
*
      • to:
{
      • Code Block
}
      • 
        oc4jadmin
        
{code} ## In a cmd window, *cd* to the *
    1. In a cmd window, cd to the C:\tmp\movesbuild\ui\sais-common-conf\servers
*
    1. directory.
&nbsp;&nbsp;Execute the following command: {code}
    1.   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.

&nbsp;&nbsp;Deleting or Renaming the oc4j directory will delete your local oracle server.&nbsp;&nbsp;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} h4. {color:green}The Moves Development Environment Setup is now complete{color}

The Moves Development Environment Setup is now complete

Panel

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

Step 4: Debugging the mit-release-plugin

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