[Cocoon Wiki] Update of "JailManagement" by FrancescoCh icchiricco

Dear Wiki user,

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

The "JailManagement" page has been changed by FrancescoChicchiricco:
http://wiki.apache.org/cocoon/JailManagement?action=3Ddiff&rev1=3D1&rev2=3D2

- Describe JailManagement here.
+ '''Contents'''
+ <<TableOfContents(5)>>
  =

+ This page contains some notes about management of {{{cocoon.zones.apache.=
org}}}.
+ =

+ =3D=3D SSH Access =3D=3D
+ =

+ 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
+ =

+ =3D=3D Environment setup =3D=3D
+ =3D=3D=3D Maven 3.0 =3D=3D=3D
+ {{{
+ alias mvn=3D'/usr/local/share/java/maven3/bin/mvn'
+ }}}
+ =

+ =3D=3D Application sources =3D=3D
+ =

+ Sources for application deployed in jail are available at https://svn.apa=
che.org/repos/asf/cocoon/trunk/jail.
+ =

+ =3D=3D=3D Index page =3D=3D=3D
+ No need to build anything, plain HTML page.
+ =

+ =3D=3D=3D Cocoon 3.0 samples =3D=3D=3D
+ =

+ To build, cd under cocoon3 and launch
+ {{{
+ mvn clean package
+ }}}
+ =

+ =3D=3D=3D Cocoon 2.1 samples =3D=3D=3D
+ =

+ To build, cd under cocoon2.1 and launch
+ {{{
+ ant clean cocoon:get webapp war
+ }}}
+ =

+ =3D=3D Deployment =3D=3D
+ =

+ http://cocoon.zones.apache.org/ is the base URL for reaching an Apache HT=
TPD 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>
+ }}}
+ =

+ =3D=3D=3D Index page =3D=3D=3D
+ {{{
+ sudo cp index.html /usr/local/www/apache22/data
+ }}}
+ =

+ =3D=3D=3D Cocoon 3.0 samples =3D=3D=3D
+ =

+ Once built,
+ {{{
+ sudo cp cocoon3-sample-webapp/target/cocoon3-sample-webapp-3.0.0-beta-1-S=
NAPSHOT.war /usr/local/apache-tomcat-7.0/webapps/cocoon3.war
+ }}}
+ =

+ =3D=3D=3D Cocoon 2.1 samples =3D=3D=3D
+ 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 x=
ercesImpl-*.jar and xml-apis-*.jar from /usr/local/apache-tomcat-7.0/webapp=
s/*/WEB-INF/lib and put the most updated versions of the same JAR files und=
er /usr/local/apache-tomcat-7.0/lib
+ }}}
+ =

+ =3D=3D Service management =3D=3D
+ =

+ 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}}}.
+=20