uPortal3 Maven 2 Distributions

uPortal 3 Distributions

Maven 2 provides the assembly plugin which can be used to produce downloadable distributions in multiple formats.

We might want to offer three distinct distributions for download:

  1. A source distribution consisting of
    • uPortal 3 source code
    • JavaDoc,
    • associated README's and licenses.
  2. A binary distribution consisting of
    • uPortal 3 war file
    • framework portlet wars
    • shared dependencies
    • associated README's and licenses
  3. A quickstart distribution consisting of
    • Tomcat
      • pre-bundled with uPortal 3
      • pre-bundled with framework portlets
      • pre-bundeld with shared dependencies
    • HSQL
      • pre-bundled with an initialized portal db
    • Ant targets/command line tools to
      • deploy portlets
      • start/stop hsql, tomcat

The goal is to use the assembly plugin to produce these downloadable distributions.

Building the distributions

You need to have r11952 or greater of https://developer.ja-sig.org/svn/up3/branches/maven-refactor in order to try this

From the base directory run:

export MAVEN_OPTS=-Xmx128m
mvn -Passembly,make-assemblies install assembly:assembly

Outputs appear in target/:

esm@clue:~/src/maven-refactor$ ls target
archive-tmp  uPortal3-1.0.0-SNAPSHOT-bin.zip  uPortal3-1.0.0-SNAPSHOT-quickstart-bin.zip  uPortal3-1.0.0-SNAPSHOT-src.zip
esm@clue:~/src/maven-refactor$ 
Assembly Plugin Bummers

So the Maven Assembly Plugin isn't all sunshine, puppies, and fuzzy bunnies.

  • The Maven lifecycle is executed multiple times when you run the assembly command. The resulting distributions are viable but it takes 5 minutes to build on my P4 with -Xmx26m.
    • Yes I've tried working around this, but please try if you are so inclined

Running the quickstart

After building the distributions, you should have a target/uPortal3-1.0.0-SNAPSHOT-quickstart-bin.zip file.

  1. cd to target
  2. unzip uPortal3-1.0.0-SNAPSHOT-quickstart-bin.zip
  3. cd to uPortal3-1.0.0-SNAPSHOT
  4. Execute hsqldb/demo/runServer.sh & or hsqldb/demo/runServer.bat as appropriate
  5. cd to apache-tomcat-5.5.23
  6. Execute bin/startup.sh or bin/startup.bat as appropriate
  7. Pause as uPortal starts (check log output as needed)
  8. Web to http://localhost:8080/uP3