Contents
This page contains some notes about management of cocoon-vm.apache.org
.
SSH Access
Preconditions:
- your SSH public key checked in at https://svn.apache.org/repos/infra/infrastructure/trunk
- 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:
- 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
.
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.