BlueDragon, BEA WebLogic® Edition 6.2.1 Deploying CFML on WebLogic Server BlueDragon, BEA WebLogic® Edition 6.2.1 Deploying CFML on WebLogic Server Published September, 2006 Copyright © 1995-2006 BEA Systems, Inc. All Rights Reserved. This software is protected by copyright, and may be protected by patent laws. No copying or other use of this software is permitted unless you have entered into a license agreement with BEA authorizing such use. This document is protected by copyright and may not be copied photocopied, reproduced, translated, or reduced to any electronic medium or machine readable form, in whole or in part, without prior consent, in writing, from BEA Systems, Inc. Information in this document is subject to change without notice and does not represent a commitment on the part of BEA Systems. THE DOCUMENTATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA SYSTEMS DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE DOCUMENT IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Copyright © 1995-2006 BEA Systems, Inc. All Rights Reserved. BEA, BEA JRockit, BEA WebLogic Portal, BEA WebLogic Server, BEA WebLogic Workshop, Built on BEA, Jolt, JoltBeans, SteelThread, Top End, Tuxedo, and WebLogic are registered trademarks of BEA Systems, Inc. BEA AquaLogic, BEA AquaLogic Data Services Platform, BEA AquaLogic Enterprise Security, BEA AquaLogic Service Bus, BEA AquaLogic Service Registry, BEA Builder, BEA Campaign Manager for WebLogic, BEA eLink, BEA Liquid Data for WebLogic, BEA Manager, BEA MessageQ, BEA WebLogic Commerce Server, BEA WebLogic Communications Platform, BEA WebLogic Enterprise, BEA WebLogic Enterprise Platform, BEA WebLogic Enterprise Security, BEA WebLogic Express, BEA WebLogic Integration, BEA WebLogic Java Adapter for Mainframe, BEA WebLogic JDriver, BEA WebLogic Log Central, BEA WebLogic Network Gatekeeper, BEA WebLogic Personalization Server, BEA WebLogic Personal Messaging API, BEA WebLogic Platform, BEA WebLogic Portlets for Groupware Integration, BEA WebLogic Server Process Edition, BEA WebLogic SIP Server, BEA WebLogic WorkGroup Edition, Dev2Dev, Liquid Computing, and Think Liquid are trademarks of BEA Systems, Inc. BEA Mission Critical Support, BEA Mission Critical Support Continuum, and BEA SOA Self Assessment are service marks of BEA Systems, Inc. All other names and marks are property of their respective owners. Copyright © 1997-2006 New Atlanta Communications, LLC. All rights reserved. 100 Prospect Place • Alpharetta, Georgia 30005-5445 Phone 678.256.3011 • Fax 678.256.3012 http://www.newatlanta.com BlueDragon is a trademark of New Atlanta Communications, LLC. ServletExec and JTurbo are registered trade- marks of New Atlanta Communications, LLC in the United States. Java and Java-based marks are trademarks of Sun Microsystems, Inc. in the United States and other countries. ColdFusion is a registered trademark of Macrome- dia, Inc. in the United States and/or other countries, and its use in this document does not imply the sponsorship, affiliation, or endorsement of Macromedia, Inc. All other trademarks and registered trademarks herein are the property of their respective owners. This product includes software developed by the Apache Software Foundation (http://www.apache.org). No part of this document may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise without the prior written consent of New Atlanta Communications, LLC. New Atlanta Communications, LLC makes no representations or warranties with respect to the contents of this document and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. BlueDragon, BEA WebLogic Edition Deploying CFML on WebLogic Server i Further, New Atlanta Communications, LLC reserves the right to revise this document and to make changes from time to time in its content without being obligated to notify any person of such revisions or changes. The Software described in this document is furnished under a Software License Agreement (“SLA”). The Software may be used or copied only in accordance with the terms of the SLA. It is against the law to copy the Software on tape, disk, or any other medium for any purpose other than that described in the SLA. BlueDragon, BEA WebLogic Edition Deploying CFML on WebLogic Server ii 1 INTRODUCTION .......................................................................................... 1 1.1 About CFML...........................................................................................................................................1 1.2 Deploying CFML on J2EE Servers with BlueDragon.........................................................................1 1.3 BlueDragon/J2EE Licensing.....................................................................Error! Bookmark not defined. 1.4 About BlueDragon..................................................................................................................................2 1.5 System Requirements.............................................................................................................................3 1.6 Technical Support ..................................................................................................................................4 1.7 Additional Documentation.....................................................................................................................4 2 J2EE WEB APPLICATIONS........................................................................ 5 2.1 Webapp Directory Structure.................................................................................................................5 2.2 URL Context Path ..................................................................................................................................6 2.2.1 Choosing an Alternative Context Path ........................................................................................6 2.3 web.xml Deployment Descriptor...........................................................................................................7 2.4 WAR Files ...............................................................................................................................................7 3 DEPLOYING CFML AS A J2EE WEB APPLICATION................................ 8 3.1 Creating and Deploying a CFML webapp ...........................................................................................8 3.2 Creating WAR Files .............................................................................................................................10 3.3 Options to Consider Before Production Deployment........................................................................10 3.3.1 Setting the BlueDragon Working Directory..............................................................................10 3.3.2 Setting the BlueDragon Administration Console Password ......................................................11 3.3.3 Removing the BlueDragon Administration Console.................................................................11 3.3.4 Preventing the Auto-load of ODBC DataSources on Windows Servers ...................................12 3.3.5 Configuring Datasources in the J2EE Server ............................................................................12 3.3.6 Deploying CFML Without Source Code...................................................................................12 4 RELATIVE URLS WITHIN HTML TAGS.................................................... 13 5 PROTECTING CFINCLUDE/CFMODULE TEMPLATES........................... 14 BlueDragon, BEA WebLogic Edition Deploying CFML on WebLogic Server iii 1 Introduction BlueDragon for J2EE Servers (BlueDragon/J2EE) allows CFML applications to be deployed as standard J2EE web applications in either open directories or as web applica- tion archive (WAR) files. While most web applications on J2EE servers are built with servlets, JSPs, EJBs, and other components of the J2EE specification, BlueDragon makes it possible to deploy CFML applications on J2EE servers as native J2EE components, and to integrate CFML and native J2EE components. This document offers a brief overview of J2EE web applications, explaining both the benefits of CFML (for J2EE developers) and the benefits of J2EE deployment (for CFML developers). It then describes how to create standard J2EE web application components that include the BlueDragon CFML runtime. CFML pages are then added to these web applications, which can be deployed onto any standard J2EE application server without requiring the installation of proprietary Allaire/Macromedia ColdFusion Server soft- ware. 1.1 About CFML ColdFusion® Markup Language (CFML) is a popular server-side markup language for building dynamic database-driven web sites. Unlike scripting-based alternatives such as ASP or PHP, CFML is based primarily on HTML-like markup tags (CFML also contains a scripting language component). CFML is characterized by its low learning curve and ease-of-use, particularly for web developers who do not have a technical background in programming languages such as C/C++ or Java. CFML was originally developed by Allaire Corporation in the late