| This is some quick info about the Mavenization (m10n) of Cocoon 2.2. |
| |
| There are also some Daisy documentation pages about this, for more "stable" information: |
| |
| http://cocoon.zones.apache.org/daisy/documentation/g2/756.html |
| http://cocoon.zones.apache.org/daisy/documentation/g1/798.html |
| |
| |
| PREREQUISITES |
| ------------- |
| You need a JDK, 1.4.x, 1.5.x, 1.6.x, or 1.7.x. |
| When experimenting with trunk, 1.5.x is probably the best bet. |
| |
| Maven 2 must be installed (at least 2.0.9). |
| |
| |
| MAVEN REPOSITORY MIRRORS |
| ------------------------ |
| Using a Maven mirror isn't necessary anymore. |
| |
| |
| HOW TO BUILD THE COCOON WEBAPP |
| ------------------------------ |
| |
| Since Cocoon release 2.2, Cocoon relies on Maven 2 for its build |
| process. |
| |
| To build Cocoon, use the following command: |
| |
| $ ./build.sh install |
| |
| In case of any failures, repeat command as necessary till you see |
| the message: |
| |
| BUILD SUCCESSFUL |
| |
| If you have consistent build failures due to a missing cocoon-rcl |
| artefact, then run first |
| |
| $ cd ../tools |
| $ mvn clean install |
| |
| If you have build failures due to out-of-memory conditions, increase |
| the JVM maximum memory limit in build.sh: |
| |
| $ MAVEN_OPTS="-Xmx256m" |
| |
| |
| HOW TO MOUNT THE PROJECTS IN ECLIPSE |
| ------------------------------------ |
| |
| from /trunk, run |
| |
| $ ./build.sh eclipse:clean eclipse:eclipse |
| |
| Next go to eclipse, and make sure you haven't got trunk mounted as a |
| project already. Also remove .classpath and .project files possibly |
| remaining in /trunk from a previous project mount. |
| Do File-Import->Existing projects into workspace, then |
| point to your trunk directory and it should detect the newly created |
| blocks as projects. |
| |
| Note that you need to declare the M2_REPO classpath variable in your |
| workspace, it should point to your local m2 repository. |
| |
| You can also get eclipse to download the sources of the dependent libraries and attach them |
| to the jars in eclipse : |
| |
| $ mvn -Declipse.downloadSources=true eclipse:eclipse |
| |
| For further information about the maven eclipse plugin visit |
| |
| http://maven.apache.org/plugins/maven-eclipse-plugin/ |
| |
| |
| HOW TO MOUNT THE PROJECTS IN INTELLIJ |
| ------------------------------------ |
| |
| First, build all the projects as described above. |
| Next, from /trunk, run |
| |
| $ mvn -P allblocks idea:idea |
| |
| In IntelliJ select File - Open Project... Navigate to the trunk directory and select cocoon.ipr. |
| |
| For further information about the maven idea plugin visit |
| |
| http://maven.apache.org/plugins/maven-idea-plugin/ |
| |
| |
| HOW TO START THE COCOON WEBAPP |
| ------------------------------ |
| |
| Checkout complete trunk and build it. If clean rebuild is desired, |
| use command: |
| |
| $ ./build.sh clean install |
| |
| Call this until you get "BUILD SUCCESSFUL" - sometimes downloads from maven |
| repositories are temporarily unaccessible and cause the build to fail. |
| |
| To start Cocoon within Jetty, use command: |
| |
| $ cocoon.sh |
| |
| Point your browser to http://localhost:8888/ |
| |
| (Don't use jetty:run-exploded as in this case the jetty6 plugin will |
| alter the webapp build by the Cocoon deployer again!) |
| |
| |
| HOW TO DEBUG THE COCOON WEBAPP |
| ------------------------------ |
| |
| To start Cocoon with JVM debug enabled, use command: |
| |
| $ cocoon.sh debug |
| |
| Then tell your IDE to connect to JVM debug on port localhost:5005. |