First off, this post is long, and hideous. It really lacks visual clarity. Only read if really desperate.<\/p>\n
Here’s how you put apache2 on port 80, define virtual hosts, proxypass requests over ajp port 8009 to a tomcat6 server running on port 8080 with multiple apps each on their on vhost.
\nLet me break that down into steps and explain why you’d want to do it like this. Or why I’d want to do it like this.<\/p>\n
At work we use some atlassian applications, like jira3, jira4, crowd, fisheye, crucible, and will probably start using bamboo, etc. Most of these come in an easy to install, prepackaged with a tomcat stack. The java-vm that tomcat runs on takes roughly ~130MB per instance, 4-5 instances that’s 500MB on just java-vms. Add the memory consumption per application on top of that. So running 3-4 tomcat instances on one machine does seem wasteful. But wait, there’s more! Each of these tomcat instances need a socket\/port to listen for traffic. So, you’ll end up with jira3 on 8080, jira4 on 8081, crowd on 8082, etc. Do you really care to remember a port per application? Think your co-workers are able to?<\/p>\n
Shortcut 1! Install apache2, create virtual hosts, and redirect or proxypass to the correct port. That way, you can just type http:\/\/fisheye.mycompany.com\/ and it’ll do the rest. Fixed forever!<\/p>\n
No? Ok, so say we manage to run them all under one tomcat instance. The typical solution would be to give each application it’s own .xml-file in \/etc\/tomcat6\/Catalina\/localhost\/ Now you can access each application under http:\/\/mycompany.com:8080\/jira4. Even better, add port 80 to your \/etc\/tomcat6\/server.xml and forget about the portnumbers all together. You’re all set!<\/p>\n
Not professional enough? You want those fancy http:\/\/crucible.mycompany.com\/ URLs, without the \/crucible\/ after. For this there’s vhosts. Each application will get it’s own host-entry in \/etc\/tomcat6\/server.xml Each application will get it’s own directory for additional configuration under \/etc\/tomcat6\/Catalina\/ And each application will deploy to it’s own separate directory, under \/var\/lib\/tomcat6\/webapps\/<\/p>\n
So with tomcat running on port 80, properly defined vhosts, there’s really no need for apache2 at all? Well, yeah. But! Say you really want to push your luck, and install some normal web application. Like phpBB, phpPgAdmin, drupal, sugarcrm, etc. You want it to be the ultimate complete mary-jane-piss-in-your-face webserver. Then you’ll want apache2 aswell.<\/p>\n
Below I’ll give a rough outline on vhost on tomcat, and proxypass from apache2. I might even explain what you need to do for the easier paths mentioned.<\/p>\n
You might not need sun-java6, but if you do uncomment the “partner” repo in \/etc\/apt\/sources.list<\/p>\n
\n
aptitude install tomcat6 libtcnative-1 sun-java6-jre sun-java6-jdk<\/code>\n<\/p><\/blockquote>\nIt’ll probably start up by default.<\/p>\n
\n
service tomcat6 stop<\/code>\n<\/p><\/blockquote>\nChange default java (you’ll want the “java-6-sun” entry.)<\/p>\n
\n
update-alternatives --config java<\/code>\n<\/p><\/blockquote>\nChange it for tomcat also;
\/etc\/default\/tomcat6<\/code><\/p>\n\n
JAVA_HOME=\/usr\/lib\/jvm\/java-6-sun<\/code>\n<\/p><\/blockquote>\nDepending on the database you’ll be using;<\/p>\n
\n
aptitude install libmysql-java libpg-java<\/code>\n<\/p><\/blockquote>\nIf you’re running PostgreSQL 9.0 or higher, maybe you’ll want newer versions. XXX Maybe you need symlinks from tomcat. \/usr\/share\/tomcat6\/lib\/mysql-connector-java.jar -> ..\/..\/java\/mysql-connector-java.jar
\nIn \/etc\/tomcat6\/server.xml, I like to modify this line with the addition of \/localhost, as it keeps everything neat.<\/p>\n\n
<Host name=\"localhost\" appBase=\"webapps\/localhost<\/strong>\"<\/code>\n<\/p><\/blockquote>\nYou’ll also want create a localhost directory, and to move the ROOT directory there, plus set the correct permissions.<\/p>\n
\n\nmkdir \/var\/lib\/tomcat6\/webapps\/localhost\nmkdir \/var\/lib\/tomcat6\/webapps\/jira3\nmkdir \/var\/lib\/tomcat6\/webapps\/jira4\n\nmv \/var\/lib\/tomcat6\/webapps\/ROOT \/var\/lib\/tomcat6\/webapps\/localhost\/\n\nchown -R tomcat6:tomcat6 \/var\/lib\/tomcat6\/webapps\n<\/pre>\n<\/blockquote>\nNow we can create the vhosts. (To skip this step, just create application.xml file in \/etc\/tomcat6\/Catalina\/localhost\/) We start by adding entries in \/etc\/tomcat6\/server.xml (Add as many aliases as you’d like.)<\/p>\n
\n\n<Host name=\"jira3\" appBase=\"webapps\/jira3\"\n unpackWARs=\"true\" autoDeploy=\"true\"\n xmlValidation=\"false\" xmlNamespaceAware=\"false\">\n <Alias>jira.mycompany.com<\/Alias>\n <Alias>jira3.mycompany.com<\/Alias>\n<\/Host>\n\n<Host name=\"jira4\" appBase=\"webapps\/jira4\"\n unpackWARs=\"true\" autoDeploy=\"true\"\n xmlValidation=\"false\" xmlNamespaceAware=\"false\">\n <Alias>jira4.mycompany.com<\/Alias>\n<\/Host>\n<\/pre>\n<\/blockquote>\nNext, we need to create directories and configurations under \/etc\/tomcat6\/Catalina<\/p>\n
\n\nmkdir \/etc\/tomcat6\/Catalina\/jira3\nln -s \/usr\/src\/atlassian-jira-professional-3.8\/dist-tomcat\/tomcat-5.5\/jira.xml \/etc\/tomcat6\/Catalina\/jira3\/ROOT.xml\n\nmkdir \/etc\/tomcat6\/Catalina\/jira4\nln -s \/usr\/src\/atlassian-jira-enterprise-4.2\/dist-tomcat\/tomcat-6\/jira.xml \/etc\/tomcat6\/Catalina\/jira4\/ROOT.xml\n<\/pre>\n<\/blockquote>\natlassian jira<\/h2>\n
Step by step for configuring, compiling and running war\/ear jira3 and jira4.<\/p>\n
Jira 3.8 Documentation<\/a>
\nJira 4.2 Documentation<\/a><\/p>\nI’ll be providing some gotcha’s and troubleshooting information along the way.
\nOne thing common for both jiras are the need for additional libraries. jira3 guide will provide with a link tojira-jars-tomcat5.zip<\/code>, jira4 will providejira-jars-tomcat6.zip<\/code> The files in both are the same, but jira4 has additional ones, so you might aswell just getjira-jars-tomcat6.zip<\/code><\/p>\n\n
cp \/usr\/share\/jira-jars-tomcat6\/* \/usr\/share\/tomcat6\/lib\/<\/code>\n<\/p><\/blockquote>\nYou’ll also need to link up your database connector.<\/p>\n
\ncd \/usr\/share\/tomcat6\/lib\/
\nln -s ..\/..\/java\/mysql-connector-java.jar
\nln -s ..\/..\/java\/postgresql.jar\n<\/p><\/blockquote>\nGive your tomcat instance lots more memory. And pass a few more options to the JVM. \/etc\/default\/tomcat6<\/p>\n
\n\n# You may pass JVM startup parameters to Java here. If unset, the default\n# options (-Djava.awt.headless=true -Xmx128m) will be used.\nJAVA_OPTS=\"-Djava.awt.headless=true -Xmx2048m -XX:+CMSClassUnloadingEnabled -XX:MaxPermSize=768m\"\n\n# Use a CMS garbage collector for improved response time\nJAVA_OPTS=\"${JAVA_OPTS} -XX:+UseConcMarkSweepGC\"\n\n# Atlassian JIRA Tweaks\nJAVA_OPTS=\"${JAVA_OPTS} -Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true -Dmail.mime.decodeparameters=true\"\n<\/pre>\n<\/blockquote>\njira3<\/h2>\n
edit-webapp\/WEB-INF\/classes\/entityengine.xml For mysql you’ll need\/want to remove the schema-name line.<\/p>\n
\n\n<datasource name=\"defaultDS\" field-type-name=\"mysql\"\n helper-class=\"org.ofbiz.core.entity.GenericHelperDAO\"\n check-on-start=\"true\"\n use-foreign-keys=\"false\"\n use-foreign-key-indices=\"false\"\n check-fks-on-start=\"false\"\n check-fk-indices-on-start=\"false\"\n add-missing-on-start=\"true\"\n check-indices-on-start=\"true\">\n <jndi-jdbc jndi-server-name=\"default\" jndi-name=\"java:comp\/env\/jdbc\/Jira3DS\"\/>\n<\/datasource>\n<\/pre>\n<\/blockquote>\nFor postgresql7.2 and above, use postgres72.<\/p>\n
\n\n<datasource name=\"defaultDS\" field-type-name=\"postgres72\"\n schema-name=\"public\"\n helper-class=\"org.ofbiz.core.entity.GenericHelperDAO\"\n check-on-start=\"true\"\n use-foreign-keys=\"false\"\n use-foreign-key-indices=\"false\"\n check-fks-on-start=\"false\"\n check-fk-indices-on-start=\"false\"\n add-missing-on-start=\"true\"\n check-indices-on-start=\"true\">\n <jndi-jdbc jndi-server-name=\"default\" jndi-name=\"java:comp\/env\/jdbc\/Jira3DS\"\/>\n<\/datasource>\n<\/pre>\n<\/blockquote>\nYou’ll note I’ve changed the jndi-name for our source to Jira3DS.
\nHere’s a little workaround. If you see the atlassian-jira.log<\/p>\ncp webapp\/WEB-INF\/classes\/log4j.properties edit-webapp\/WEB-INF\/classes\/log4j.properties<\/p>\n
Edit the file, look for this line and modify it.<\/p>\n
log4j.appender.filelog.File=\/var\/local\/jira3\/log\/atlassian-jira.log<\/p>\n
Have a look at etc\/tomcat-6-jira.xml and perhaps etc\/jira.xml<\/p>\n
Then create a symlink from dist-tomcat\/tomcat-5.5\/jira.xml, to \/etc\/tomcat6\/Catalina\/jira3\/ROOT.xml
\nmysql version<\/p>\n\n\n<!--\nA sample configuration file for Tomcat 5.5\nCustomize the docBase attribute, drop in your $CATALINA_HOME\/conf\/Catalina\/localhost\/jira.xml\nNote the JOTM dependencies; you'll need to copy various jars to Tomcat's common\/lib\/ directory.\n-->\n<Context path=\"\/jira3\" docBase=\"\/usr\/src\/atlassian-jira-professional-3.8\/dist-tomcat\/atlassian-jira-3.8.war\" debug=\"0\">\n\n <!-- NOTE: If you use a database other than hsqldb:\n * delete the minEvictableIdleTimeMillis and timeBetweenEvictionRunsMillis attributes\n * change the database type in atlassian-jira\/WEB-INF\/classes\/entityengine.xml\n -->\n <Resource name=\"jdbc\/Jira3DS\" auth=\"Container\" type=\"javax.sql.DataSource\"\n username=\"jira3db\"\n password=\"jira3db-password\"\n driverClassName=\"org.gjt.mm.mysql.Driver\"\n url=\"jdbc:mysql:\/\/localhost\/jira3db?useUnicode=true&characterEncoding=UTF8\"\n maxActive=\"20\"\n validationQuery=\"select 1\"\/>\n<!-- driverClassName=\"org.mysql.jdbc.Driver\" -->\n\n <Resource name=\"UserTransaction\" auth=\"Container\" type=\"javax.transaction.UserTransaction\"\n factory=\"org.objectweb.jotm.UserTransactionFactory\" jotm.timeout=\"60\"\/>\n<!--<Manager className=\"org.apache.catalina.session.PersistentManager\" saveOnRestart=\"false\"\/>-->\n <Manager pathname=\"\"\/>\n\n<\/Context>\n<\/pre>\n<\/blockquote>\npostgres version<\/p>\n
\n\n<!--\n A sample configuration file for Tomcat 5.5\n Customize the docBase attribute, drop in your $CATALINA_HOME\/conf\/Catalina\/localhost\/jira.xml\n Note the JOTM dependencies; you'll need to copy various jars to Tomcat's common\/lib\/ directory.\n -->\n<Context path=\"\/jira3\" docBase=\"\/usr\/src\/atlassian-jira-professional-3.8\/dist-tomcat\/atlassian-jira-3.8.war\" debug=\"0\">\n\n <!-- NOTE: If you use a database other than hsqldb:\n * delete the minEvictableIdleTimeMillis and timeBetweenEvictionRunsMillis attributes\n * change the database type in atlassian-jira\/WEB-INF\/classes\/entityengine.xml\n -->\n <Resource name=\"jdbc\/Jira3DS\" auth=\"Container\" type=\"javax.sql.DataSource\"\n username=\"jira3db\"\n password=\"jira3db-password\"\n driverClassName=\"org.postgresql.Driver\"\n url=\"jdbc:postgresql:\/\/localhost\/jira3db\"\/>\n\n <Resource name=\"UserTransaction\" auth=\"Container\" type=\"javax.transaction.UserTransaction\"\n factory=\"org.objectweb.jotm.UserTransactionFactory\" jotm.timeout=\"60\"\/>\n <Manager className=\"org.apache.catalina.session.PersistentManager\" saveOnRestart=\"false\"\/>\n<\/Context>\n<\/pre>\n<\/blockquote>\nNOTE: jira3 does not have the “jira.home” entry in jira-application.properties, whilst jira4 does. You’ll be able to specify the jira.home locations during setup of jira3. I recommend the following; (jira4 defaults.)<\/p>\n
\n\n\/var\/local\/jira3\/caches\/indexes # indexing\n\/var\/local\/jira3\/data\/attachments # attachments\n\/var\/local\/jira3\/export # backups\n<\/pre>\n<\/blockquote>\nThe reasonable thing to do is to create two directories, and give ownership to tomcat6. \/var\/local has default group “staff”.<\/p>\n
\n\nmkdir \/var\/local\/jira3\nmkdir \/var\/local\/jira4\n\nchown -R tomcat6:staff \/var\/local\/jira*\n<\/pre>\n<\/blockqquote><\/p>\n
jira4<\/h2>\n
For postgresql7.2 and above, use postgres72.<\/p>\n
\n\n<datasource name=\"defaultDS\" field-type-name=\"postgres72\"\n schema-name=\"public\"\n helper-class=\"org.ofbiz.core.entity.GenericHelperDAO\"\n check-on-start=\"true\"\n use-foreign-keys=\"false\"\n use-foreign-key-indices=\"false\"\n check-fks-on-start=\"false\"\n check-fk-indices-on-start=\"false\"\n add-missing-on-start=\"true\"\n check-indices-on-start=\"true\">\n <jndi-jdbc jndi-server-name=\"default\" jndi-name=\"java:comp\/env\/jdbc\/Jira4DS\"\/>\n<\/datasource>\n<\/pre>\n<\/blockquote>\nYou’ll note I’ve changed the jndi-name for our source to Jira4DS.<\/p>\n
Editing edit-webapp\/WEB-INF\/classes\/jira-application.properties<\/p>\n
jira.home = \/var\/local\/jira4
\nHave a look at etc\/tomcat-6-jira.xml and perhaps etc\/jira.xml<\/p>\n\n\n<!--\nA sample configuration file for Tomcat 6\nCustomize the docBase attribute, drop in your $CATALINA_HOME\/conf\/Catalina\/localhost\/jira.xml\nNote the JOTM dependencies; you'll need to copy various jars to Tomcat's common\/lib\/ directory.\n-->\n<Context path=\"\/jira4\" docBase=\"\/usr\/src\/atlassian-jira-enterprise-4.2\/dist-tomcat\/tomcat-6\/atlassian-jira-4.2.war\" debug=\"0\" useHttpOnly=\"true\">\n\n <!-- NOTE: If you use a database other than hsqldb:\n * delete the minEvictableIdleTimeMillis and timeBetweenEvictionRunsMillis attributes\n * change the database type in atlassian-jira\/WEB-INF\/classes\/entityengine.xml\n -->\n <Resource name=\"jdbc\/Jira4DS\" auth=\"Container\" type=\"javax.sql.DataSource\"\n username=\"jira4db\"\n password=\"jira4db-password\"\n driverClassName=\"org.postgresql.Driver\"\n url=\"jdbc:postgresql:\/\/localhost\/jira4db\"\n maxActive=\"20\"\n validationQuery=\"select 1\"\/>\n<!-- driverClassName=\"org.mysql.jdbc.Driver\" -->\n\n <Resource name=\"UserTransaction\" auth=\"Container\" type=\"javax.transaction.UserTransaction\"\n factory=\"org.objectweb.jotm.UserTransactionFactory\" jotm.timeout=\"60\"\/>\n<!--<Manager className=\"org.apache.catalina.session.PersistentManager\" saveOnRestart=\"false\"\/>-->\n <Manager pathname=\"\"\/>\n<\/Context>\n<\/pre>\n<\/blockquote>\nand build the damn thing.<\/p>\n
cd \/usr\/src\/atlassian-jira-enterprise-4.2\/ .\/build.sh
\nNext thing is to configure your jira.xml context. I pretty much just edit the dist-tomcat\/tomcat-6\/jira.xml, and create a symlink to it called \/etc\/tomcat6\/Catalina\/jira4\/ROOT.xml<\/p>\nHopefully you’ll notice I’ve replaced driverClassName. To determine this, I extracted \/usr\/share\/java\/mysql-connector-java.jar (it’s a normal zip file), and found mysql-connector-java\/org\/gjt\/mm\/mysql\/Driver.class<\/p>\n
apache2<\/h2>\n
\n\naptitude install apache2 apache2-mpm-prefork<\/code>\na2enmod proxy proxy_ajp\n<\/pre>\n<\/blockquote>\nadd jira3 and jira4 to
\/etc\/hosts<\/code><\/p>\n\n\n127.0.0.1 jira3.mycompany.com jira3\n127.0.0.1 jira4.mycompany.com jira4\n<\/pre>\n<\/blockquote>\nThis will enable the vhost on tomcat to respont correctly when apache2 proxypasses. \/etc\/apache\/sites-available\/jira3<\/p>\n
\n\n<VirtualHost *:80>\n ServerName jira3.mycompany.com\n ServerAlias jira.mycompany.com\n\n <Proxy *>\n Order deny,allow\n Allow from all\n <\/Proxy>\n\n# ProxyPreserveHost on\n ProxyRequests off\n\n ProxyPass \/ ajp:\/\/jira3:8009\/\n ProxyPassReverse \/ ajp:\/\/jira3:8009\/\n<\/VirtualHost>\n<\/pre>\n<\/blockquote>\nRemember to enable the ajp connector in \/etc\/tomcat6\/server.xml<\/p>\n
\n\n<!-- Define an AJP 1.3 Connector on port 8009 -->\n<Connector port=\"8009\" protocol=\"AJP\/1.3\" redirectPort=\"8443\" \/>\n<\/pre>\n<\/blockquote>\n","protected":false},"excerpt":{"rendered":"First off, this post is long, and hideous. It really lacks visual clarity. Only read if really desperate. Here’s how you put apache2 on port 80, define virtual hosts, proxypass requests over ajp port 8009 to a tomcat6 server running on port 8080 with multiple apps each on their on vhost. Let me break that … Continue reading apache2 ajp tomcat6<\/span>