Deploy OpenBlueDragon on Tomcat 6 in a virtual host environment

This article describes how to deploy OpenBlueDragon server on Tomcat in a virtual hosts environment. Please read my Apache Tomcat 6 Article for the base setup.

If you install the BlueDragon server in seperate virtual hosts, each will have an own coldfusion administrator with own settings.

1. Download

Download “J2EE WAR Distribution” from http://www.openbluedragon.org/download.cfm.

2. Prepare system

2.1 Modify the virtual host in tomcat

vim /opt/tomcat/conf/server.xml

<!-- www.testsrv.local -->
<host name="www.testsrv.local" appBase="/var/www/vhost1/htdocs" unpackWARs="true" autoDeploy="true">
    <context path="" docBase="openbluedragon" debug="0" reloadable="true"/>
    <valve className="org.apache.catalina.valves.AccessLogValve" directory="/var/www/vhost1/logs"  prefix="tomcat_access_" suffix=".log" pattern="common" resolveHosts="false"/>
</host>

2.2 Modify the virtual host in apache

vim /etc/apache2/sites-enabled/vhost1

<virtualhost www.testsrv.local:80>
    JkMount /*.cfm default
    JkMount /*.cfc default
    JkMount /*.cfchart default
    DirectoryIndex index.cfm index.html index.htm
    ServerName www.testsrv.local
    ServerAdmin servermaster@testsrv.local
    DocumentRoot /var/www/vhost1/htdocs/openbluedragon
    ErrorLog /var/www/vhost1/logs/error.log
    CustomLog /var/www/vhost1/logs/access.log common
    <directory /var/www/vhost1/htdocs/openbluedragon>
        Options -Indexes
    </directory>
    <directory /var/www/vhost1/htdocs/openbluedragon/WEB-INF>
        Options -Indexes
        AllowOverride None
        deny from all
    </directory>
</virtualhost>

3. Deploy the WAR file to a virtual host

Copy the downloaded openbluedragon.war file into /var/www/vhost1/htdocs/

Note: Tomcat will unpack this WAR file and create the cfusion diretory. After that, you can delete the WAR file.

4. Apply configuration

/etc/init.d/tomcat restart
/etc/init.d/apache2 reload

5. Test configuration

Now you can test your installation by opening the BlueDragon CFML test page:

http://www.testsrv.local/index.cfm

6. Administration

On http://bdadmin.riaforge.org you can get a web admin for the OpenBlueDragon server.