UNDER CONSTRUCTION

{color:green}Help is available by sending an email to [mailto:csf-support@mit.edu]{color}

Quick Links to:

Picking a projectName and a projectArtifactId

The first thing that must be done is to pick a projectName and a projectArtifactId.  These will be used throughout the life time of your project.

The projectName is a short acronym that is used to uniquely identify your project.
The projectArtifactId is the application context under which your project war file will be deployed to the OC4J server.

Once the projectName and projectArtifactId have been selected, they should not be changed.

Here are a few examples of what other project have used in the past:

projectName

projectArtifactId

project description

ssb

sfs-ssb

student sponsored billing

ogs

ogs

online grade submission

onlinereg

onlinereg

online registration

iap

iap

individual activities period

Setup of the project war component using the war-template

  1. Run Eclipse.  Go to File > New > Other....
    Scroll down to Maven and expand then select Checkout Maven Projects from SCM as shown in the following panel. 
    !setupWarTemplate002.jpg!
    When satisfied that everything is correct, click Next.
  2. From the SCM URL: dropdown, select snv.
    Uncheck Checkout All Projects.
    The URL for the war-template is : 
    svn+ssh://svn.mit.edu/es-projects/es-project-template/war-template/trunk
    Copy and pasted the above URL into the SCM URL: input field.
    When done the panel should be identical to the following: 
    !setupWarTemplate004.jpg!
    When satisfied that everything is correct, click Next.
  3. If you want the change the Workspace location, uncheck the Use default Workspace location and enter the path to the desired workspace. 
    !setupWarTemplate006.jpg!
    When satisfied that everything is correct, click Finish.
  4. Verify the Maven Project that is being imported. The Import Maven Projects panel should be identical to the following panel. 
    !setupWarTemplate008.jpg!
    When satisfied that everything is correct, click Finish.
  5. When the project is opened, your Eclipse - Project Explorer Perspective should look as follows: 
    !setupWarTemplate010.jpg!
    Right click on the project and select Team > Disconnect
  6. When following Confirm Disconnect from SVN is displayed, select Also delete the SVN meta-information from the file system.. 
    !setupWarTemplate012.jpg!
    When satisfied that everything is correct, click Yes.
  7. The Eclipse - Project Explorer Perspective should look as follows: 
    !setupWarTemplate014.jpg!
    Right click on the project and select Refactor > Rename....
    Replace projectArtifactId with the projectArtifactId that you have previously selected. 
    *Note*:  You might want to append a *-war* to the projectArtifactId to denote that this is the war component of your project.

    For example: If my projectArtifactId was att, then my panel would look like the following: 
    !setupWarTemplate016.jpg!
    When satisfied that everything is correct, click OK.
  8. The Eclipse - Project Explorer Perspective should look similar to the following: 
    !setupWarTemplate018.jpg!
    Right click on the project and select Team > Share Project...
  9. Select SVN as shown below: 
    !setupWarTemplate020.jpg!
    When satisfied that everything is correct, click Next.
  10. Select Create a new repository location as shown below: 
    !setupWarTemplate022.jpg!
    When satisfied that everything is correct, click Next.
  11. Enter a desired SVN URL for your project.
    For example: 
    Keep in mind that there are at least 2 component for every project, a WAR and a JAR.
You Should keep all project components grouped together in the same SVN directory.  A logical grouping
would be by the projectName that you selected.  If my projectName were *att*, then the SVN
URL would be *svn+ssh://svn.mit.edu/es-projects/att*.  This would mean that my war project
would be created under the *es-projects/att* directory in the SVN repository.  This is shown
in the following panel:

    !setupWarTemplate024.jpg!
    Don't forget to enter your User name and Password,
    When satisfied that everything is correct, click Finish.

check out the es-project-template/war-template
disconnect
rename project
share