[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:
https://wiki.apache.org/cocoon/JailManagement?action=3Ddiff&rev1=3D5&rev2=
=3D6

+ '''Contents''' <<TableOfContents(5)>>
- '''Contents'''
- <<TableOfContents(5)>>
  =

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

  =3D=3D SSH Access =3D=3D
+ Preconditions:
  =

- 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. your SSH public key checked in  at [[https://svn.apache.org/repos/inf=
ra/infrastructure/trunk/ssh_keys/people/|https://svn.apache.org/repos/infra=
/infrastructure/trunk]]
-  1. someone from infrastructure listed you in {{{/etc/ssh/ssh_keys}}} on =
jail machine
+  1. fire a ticket on JIRA to infra to create an account for you
  =

  =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'
+ alias mvn=3D/opt/apache-maven-3.2.5/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.
+ Sources for application deployed in jail are available at https://svn.apa=
che.org/repos/asf/cocoon/trunk/jail and checked out in /usr/local/src/cocoo=
n-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
  =

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

  =3D=3D=3D Cocoon 2.2 samples =3D=3D=3D
- =

  Please follow instructions contained in cocoon2.2/README.
  =

  =3D=3D=3D Cocoon 2.1 samples =3D=3D=3D
+ To build, cd under cocoon2.1 and launch
  =

- To build, cd under cocoon2.1 and launch
  {{{
  ant clean cocoon:get webapp war
  }}}
+ =3D=3D Deployment =3D=3D
+ [[http://cocoon.zones.apache.org/|http://cocoon-vm.apache.org/]] is the b=
ase URL for reaching an Apache HTTPD 2.2 instance having:
  =

- =3D=3D Deployment =3D=3D
+  * document directory {{{/var/www}}}
+  * configuration directory {{{/etc/apache22}}}
  =

+ This HTTPD instance is acting as a reverse proxy for an Apache Tomcat 7.0=
 instance having CATALINA_HOME at {{{/opt/apache-tomcat-7.0}}}.
- 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 /etc/apache2/mods-enabled/p=
roxy.conf
  =

- 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
@@ -66, +60 @@

                  ProxyPassReverse http://localhost:8080/cocoon3
          </Location>
  }}}
- =

  =3D=3D=3D Index page =3D=3D=3D
  {{{
- sudo cp index.html /usr/local/www/apache22/data
+ sudo cp index.html /var/www
  }}}
+ =3D=3D=3D Cocoon 3.0 samples =3D=3D=3D
+ Once built,
  =

- =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
+ sudo cp cocoon3-sample-webapp/target/cocoon3-sample-webapp-3.0.0-beta-1-S=
NAPSHOT.war /opt/apache-tomcat-7.0/webapps/cocoon3.war
  }}}
- =

  =3D=3D=3D Cocoon 2.2 samples =3D=3D=3D
  Once built,
+ =

  {{{
- sudo cp core/cocoon-webapp/target/cocoon-webapp.war /usr/local/apache-tom=
cat-7.0/webapps/cocoon22.war
+ sudo cp core/cocoon-webapp/target/cocoon-webapp.war /opt/apache-tomcat-7.=
0/webapps/cocoon22.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
+ sudo cp build/cocoon-2.1-samples.war /opt/apache-tomcat-7.0/webapps/cocoo=
n21.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
+ Due to a different handling of SAX parsers, you will need to remove any x=
ercesImpl-*.jar and xml-apis-*.jar from /opt/apache-tomcat-7.0/webapps/*/WE=
B-INF/lib and put the most updated versions of the same JAR files under /op=
t/apache-tomcat-7.0/lib
  }}}
+ =3D=3D Service management =3D=3D
+ Use standard Ubuntu way, i.e.
  =

- =3D=3D Service management =3D=3D
- =

- Use standard FreeBSD way, i.e.
  {{{
- sudo service apache22 [start | status | stop]
+ sudo service apache2 [start | status | stop]
  }}}
  and
+ =

  {{{
- sudo service tomcat7 [start | status | stop]
+ sudo service tomcat [start | status | stop]
  }}}
- =

- All configurations go in {{{/etc/rc.conf}}}.
- =

  {{{#!wiki caution
  '''Note'''
  =

- After [[https://issues.apache.org/jira/browse/INFRA-4685|INFRA-4685]], a =
script /usr/local/bin/restartCocoonServices.sh has been configured (via /et=
c/crontab) to restart apache22 and tomcat7 services every two hours. =

+ After [[https://issues.apache.org/jira/browse/INFRA-4685|INFRA-4685]], a =
script /usr/local/bin/restartCocoonServices.sh has been configured (via /et=
c/crontab) to restart apache2 and tomcat services once a day.
  }}}
 =20