Contents

This page contains some notes about management of cocoon-vm.apache.org.

SSH Access

Preconditions:

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

  2. fire a ticket on JIRA to infra to create an account for you

Environment setup

Maven 3.0

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

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-vm.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 /opt/apache-tomcat-7.0.

The reverse proxy configuration is located at /etc/apache2/mods-enabled/proxy.conf

        <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 /var/www

Cocoon 3.0 samples

Once built,

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 /opt/apache-tomcat-7.0/webapps/cocoon22.war

Cocoon 2.1 samples

Once built,

sudo cp build/cocoon-2.1-samples.war /opt/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 /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.

sudo service apache2 [start | status | stop]

and

sudo service tomcat [start | status | stop]

Note

After INFRA-4685, a script /usr/local/bin/restartCocoonServices.sh has been configured (via /etc/crontab) to restart apache2 and tomcat services once a day.