Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Cocoon Wiki" for change 
notification.

The "JailManagement" page has been changed by FrancescoChicchiricco:
http://wiki.apache.org/cocoon/JailManagement?action=diff&rev1=1&rev2=2

- Describe JailManagement here.
+ '''Contents'''
+ <<TableOfContents(5)>>
  
+ This page contains some notes about management of 
{{{cocoon.zones.apache.org}}}.
+ 
+ == SSH Access ==
+ 
+ Preconditions:
+  1. someone with enough administrator rights on the jail created an user for 
you (as indicated in http://apache.org/dev/freebsd-jails.html)
+  1. your SSH public key checked in  at 
https://svn.apache.org/repos/infra/infrastructure/trunk/ssh_keys/people/
+  1. someone from infrastructure listed you in {{{/etc/ssh/ssh_keys}}} on jail 
machine
+ 
+ == Environment setup ==
+ === Maven 3.0 ===
+ {{{
+ alias mvn='/usr/local/share/java/maven3/bin/mvn'
+ }}}
+ 
+ == Application sources ==
+ 
+ Sources for application deployed in jail are available at 
https://svn.apache.org/repos/asf/cocoon/trunk/jail.
+ 
+ === Index page ===
+ No need to build anything, plain HTML page.
+ 
+ === Cocoon 3.0 samples ===
+ 
+ To build, cd under cocoon3 and launch
+ {{{
+ mvn clean package
+ }}}
+ 
+ === Cocoon 2.1 samples ===
+ 
+ To build, cd under cocoon2.1 and launch
+ {{{
+ ant clean cocoon:get webapp war
+ }}}
+ 
+ == Deployment ==
+ 
+ http://cocoon.zones.apache.org/ is the base URL for reaching an Apache HTTPD 
2.2 instance having:
+  * document directory {{{/usr/local/www/apache22/data}}}
+  * configuration directory {{{/usr/local/etc/apache22/httpd.conf}}}
+ 
+ This HTTPD instance is acting as a reverse proxy for an Apache Tomcat 7.0 
instance having CATALINA_HOME at {{{/usr/local/apache-tomcat-7.0}}}.
+ 
+ The reverse proxy configuration is located at the end of HTTPD conf file, and 
it is something like
+ {{{
+         <Location "/cocoon21">
+                 ProxyPass http://localhost:8080/cocoon21
+                 ProxyPassReverse http://localhost:8080/cocoon21
+         </Location>
+         <Location "/cocoon3">
+                 ProxyPass http://localhost:8080/cocoon3
+                 ProxyPassReverse http://localhost:8080/cocoon3
+         </Location>
+ }}}
+ 
+ === Index page ===
+ {{{
+ sudo cp index.html /usr/local/www/apache22/data
+ }}}
+ 
+ === Cocoon 3.0 samples ===
+ 
+ Once built,
+ {{{
+ sudo cp 
cocoon3-sample-webapp/target/cocoon3-sample-webapp-3.0.0-beta-1-SNAPSHOT.war 
/usr/local/apache-tomcat-7.0/webapps/cocoon3.war
+ }}}
+ 
+ === Cocoon 2.1 samples ===
+ Once built,
+ {{{
+ sudo cp build/cocoon-2.1-samples.war 
/usr/local/apache-tomcat-7.0/webapps/cocoon21.war
+ }}}
+ 
+ {{{#!wiki caution
+ '''Note'''
+ 
+ Due to a different handling of SAX parsers, you will need to remove any 
xercesImpl-*.jar and xml-apis-*.jar from 
/usr/local/apache-tomcat-7.0/webapps/*/WEB-INF/lib and put the most updated 
versions of the same JAR files under /usr/local/apache-tomcat-7.0/lib
+ }}}
+ 
+ == Service management ==
+ 
+ Use standard FreeBSD way, i.e.
+ {{{
+ sudo service apache22 [start | status | stop]
+ }}}
+ and
+ {{{
+ sudo service tomcat7 [start | status | stop]
+ }}}
+ 
+ All configurations go in {{{/etc/rc.conf}}}.
+