Versions Compared

Key

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

...

N.B. #2: If you're building on isda-build1 and the UI binaries built from the trunk are appropriate for your build, you can skip the UI build and just have Maven use the autobuild that's already on the system; see below under "BUILDING THE BACK END" for details.

  1. For a QA release, create the release branch:
    svn cp ui/trunk ui/branches/thaliaUI<version>-sprint<num>
    For a production release, create a tag instead:
    svn cp ui/trunk ui/tags/thaliaUI<version>-sprint<num>
  2. ...then build the .swf files that comprise the UI:
    cd thalia/ui/branches/thalia<ver>-sprint<num>
    mvn clean compile
  3. Alternatively, if you just want to build the UI from the trunk:
    cd thalia/ui/trunk
    mvn clean compile
    The .swf files will be in the newly-created (by Maven) target subdirectory.

BUILDING THE BACK END

  1. For a QA release, create the release branch:
    svn cp ime/Trunk/thalia ime/Branches/thalia<version>-sprint<num>
    For a production release, create a tag instead of a branch:
          svn cp ime/Trunk/thalia ime/tags/thalia<version>-sprint<num># If you need to include updated flash files for the UI, do one of:
    1. Copy the files manually.
    2. Invoke the IME build with the -Dincludeui=true option; this will copy the compiled and uncompiled OL code (the IME needs some of each!) from, in order of preference:
      1. The path specified with the -Duipath=/some/path/with/target/and/src/ui/directories option.
      2. The build products from the UI trunk which are part of the same checkout (../../../../../../ui/trunk/target)
      3. The automatic trunk build product directory (only meaningful on isda-build1).
  2. Make a clean build of the .war file:
    cd thalia/ime/Branches/thalia<ver>-sprint<num>
    mvn clean package -Denv=prod1
    This will create or update the target directory and add the file ROOT.war .  Please note that the Thalia maven build has multiple profiles:
    • If you want a development deployment (to thalia-dev.mit.edu), use -Denv=dev.
    • If you want to choose the test profile, use -Denv=test1 or -Denv=test2.  (When packaging, test1 and test2 are exactly the same. When deploying, test1 deploys to isda-thalia2 and test2 deploys to isda-thalia11.)
    • If you want to choose the production profile, use -Denv=prod1 or -Denv=prod2.  (When packaging, prod1 and prod2 are exactly the same. When deploying, prod1 deploys to isda-thalia5 and prod2 deploys to isda-thalia8.)
    • N.B.: Part of the profile definition is in thalia/ime/Trunk/thalia/pom.xml under the profiles section; it specifies which servers to deploy to in each environment. Part of the profile definition is in thalia/ime/Trunk/thalia/src/main/filters*.properties files; it specifies the alfresco server address/port and alfresco passwords for user and admin. To change the development environment, edit dev.properties. To change the test environment, edit test.properites. To change the prodution environment, edit prod.properties.
  3. If you're doing a release and the build completed without error, commit the branch:
    svn commit
  4. Deploy the war:
    • Check that it's ok to deploy.  Start with the thalia-talk@conference.mit.edu jabber chat.  If deploying to QA, check in with the QA contractor in thalia-qa@conference.mit.edu.  If deploying to production, you will already have coordinated the downtime with asst@mit.edu and isda-ops@mit.edu so they will not be alarmed when nagios reports the Thalia failure.
    • There are two ways to deploy: one through the web, and one via maven.  See the DEPLOYING WITH MAVEN or DEPLOYING VIA THE WEB INTERFACE sections following.

...