[Cocoon Wiki] Update of "JailManagement" by FrancescoChicchiricco

[Apache Wiki <wi...@apache.org>]

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:
https://wiki.apache.org/cocoon/JailManagement?action=diff&rev1=5&rev2=6

+ '''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}}}.
  
  == SSH Access ==
+ 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/infra/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
  
  == Environment setup ==
  === Maven 3.0 ===
  {{{
- alias mvn='/usr/local/share/java/maven3/bin/mvn'
+ alias mvn=/opt/apache-maven-3.2.5/bin/mvn
  }}}
- 
  == Application sources ==
- 
- Sources for application deployed in jail are available at https://svn.apache.org/repos/asf/cocoon/trunk/jail.
+ Sources for application deployed in jail are available at https://svn.apache.org/repos/asf/cocoon/trunk/jail and checked out in /usr/local/src/cocoon-jail/
  
  === Index page ===
  No need to build anything, plain HTML page.
  
  === Cocoon 3.0 samples ===
+ To build, cd under cocoon3 and launch
  
- To build, cd under cocoon3 and launch
  {{{
  mvn clean package
  }}}
- 
  === Cocoon 2.2 samples ===
- 
  Please follow instructions contained in cocoon2.2/README.
  
  === Cocoon 2.1 samples ===
+ To build, cd under cocoon2.1 and launch
  
- To build, cd under cocoon2.1 and launch
  {{{
  ant clean cocoon:get webapp war
  }}}
+ == Deployment ==
+ [[http://cocoon.zones.apache.org/|http://cocoon-vm.apache.org/]] is the base URL for reaching an Apache HTTPD 2.2 instance having:
  
- == Deployment ==
+  * 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 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 /etc/apache2/mods-enabled/proxy.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>
  }}}
- 
  === Index page ===
  {{{
- sudo cp index.html /usr/local/www/apache22/data
+ sudo cp index.html /var/www
  }}}
+ === Cocoon 3.0 samples ===
+ Once built,
  
- === 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
+ sudo cp cocoon3-sample-webapp/target/cocoon3-sample-webapp-3.0.0-beta-1-SNAPSHOT.war /opt/apache-tomcat-7.0/webapps/cocoon3.war
  }}}
- 
  === Cocoon 2.2 samples ===
  Once built,
+ 
  {{{
- sudo cp core/cocoon-webapp/target/cocoon-webapp.war /usr/local/apache-tomcat-7.0/webapps/cocoon22.war
+ sudo cp core/cocoon-webapp/target/cocoon-webapp.war /opt/apache-tomcat-7.0/webapps/cocoon22.war
  }}}
- 
  === Cocoon 2.1 samples ===
  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/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
+ Due to a different handling of SAX parsers, you will need to remove any xercesImpl-*.jar and xml-apis-*.jar from /opt/apache-tomcat-7.0/webapps/*/WEB-INF/lib and put the most updated versions of the same JAR files under /opt/apache-tomcat-7.0/lib
  }}}
+ == Service management ==
+ Use standard Ubuntu way, i.e.
  
- == Service management ==
- 
- 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 /etc/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 /etc/crontab) to restart apache2 and tomcat services once a day.
  }}}