Contents

Contents

  1. SSH Access
  2. Environment setup
    1. Maven 3.0
  3. Application sources
    1. Index page
    2. Cocoon 3.0 samples
    3. Cocoon 2.2 samples
    4. Cocoon 2.1 samples
  4. Deployment
    1. Index page
    2. Cocoon 3.0 samples
    3. Cocoon 2.2 samples
    4. Cocoon 2.1 samples
  5. Service management

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)

  2. your SSH public key checked in at https://svn.apache.org/repos/infra/infrastructure/trunk/ssh_keys/people/

  3. 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.2 samples

Please follow instructions contained in cocoon2.2/README.

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:

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 "/cocoon22">
                ProxyPass http://localhost:8080/cocoon22
                ProxyPassReverse http://localhost:8080/cocoon22
        </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.2 samples

Once built, 

sudo cp core/cocoon-webapp/target/cocoon-webapp.war /usr/local/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

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.

Note

After INFRA-4685, a script /usr/local/bin/restartCocoonServices.sh has been configured (via /etc/crontab) to restart apache22 and tomcat7 services every two hours.