tmn/tmn-home.git

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
  PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--#config errmsg="" --><!-- saved from url=(0022)http://help.adobe.com/ -->
<html lang="en-us">
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
    <meta name="lang" content="en-us" />
    <meta name="area" content="livedocs" />
    <title>Adobe&#160;ColdFusion&#160;10 * Packaging applications in J2EE archive files</title>
    <link rel="shortcut icon" href="images/ColdFusionLinkIndicator.png" />
    <meta name="book" content="Configuring and Administering ColdFusion 10" />
    <meta name="product" content="ColdFusion" />
    <meta name="keywords" content="" /><!--<PageMap><DataObject type="document"><Attribute name="product" value="ColdFusion"></Attribute><Attribute name="book" value="Configuring and Administering ColdFusion 10"></Attribute><Attribute name="keywords" value=""></Attribute></DataObject></PageMap>-->
    
    <script type="text/javascript" language="Javascript" charset="UTF-8"><!--[CDATA[
        var currentTreeNode = "WSc3ff6d0ea77859461172e0811cbf364104-7fd1.html";
    document.cookie = "topicId=" + "WSc3ff6d0ea77859461172e0811cbf364104-7fd1.html";
// ]]--></script>
<script src="terms.js" type="text/javascript" language="Javascript" charset="UTF-8">...</script> <script src="help.js" type="text/javascript" language="Javascript" charset="UTF-8">...</script>  <script src="utilities.js" type="text/javascript" language="Javascript" charset="UTF-8">...</script> <script src="event.js" type="text/javascript" language="Javascript" charset="UTF-8">...</script> <script src="treeview.js" type="text/javascript" language="Javascript" charset="UTF-8">...</script> <script src="toc.js" language="Javascript" type="text/javascript" charset="UTF-8">..</script> <script src="swfobject.js" language="Javascript" type="text/javascript" charset="UTF-8">..</script>  <script src="booklist.js" language="Javascript" type="text/javascript" charset="UTF-8">..</script>
<script type="text/javascript">
<!--[CDATA[
var topictype = "topic";
var headId = document.getElementsByTagName("head")[0];         
if (use_ie_6_behavior) {
  var linkId = document.createElement("link");
  linkId.href = "content-ie6.css";
  linkId.rel = "stylesheet";
  linkId.type = "text/css";
  headId.appendChild(linkId);
}
function initRoboHelpDOM() {
  if (use_chm_behavior) {
    hideElement("search");
  }
  if (use_robohelp_behavior) {
    hideElement("search");
    hideElement("productmenu");
    //hideElement("notyourversion");
  }
  if(!use_chc_behavior) {
    //document.getElementById("notyourversion").style.display = "inline";;
  }
}
var dirname = location.pathname.match( /.*\// );    
function setSearchUserPref(){
  if ( document.cookie.indexOf( "ah_searchpref" ) > -1 ) {
    if ( document.cookie.indexOf( dirname ) > 0 ) {
      document.search.gsa.checked = true ;
    }else{
      document.search.gsa.checked = false ;            
    }
  }
}
YAHOO.util.Event.onDOMReady(initRoboHelpDOM);
YAHOO.util.Event.onDOMReady(setSearchUserPref);
// ]]-->
</script>
<!--#include virtual="/ssi/globalheader.ssi" -->
<!--#include virtual="/en_US/ssi/localheader.ssi" -->
<!--#include virtual="header.ssi" -->
    <link rel="stylesheet" type="text/css" href="tree.css" />
    <link rel="stylesheet" type="text/css" href="content.css" />
    <link rel="stylesheet" type="text/css" href="localeSpecific.css" />
  </head>
  <body id="content_body" onload="window.focus();">
    <a name="top" shape="rect"><!--LeaveCommentHere--></a>
    
    <div id="mnemonic">
      <div class="ColdFusion"><div class="banner"><a href="WSf01dbd23413dda0e51f089d212047ee7a02-8000.html">Adobe&#160;ColdFusion&#160;10</a></div></div>
    </div>
    
    <div id="searchbar">
<table id="searchbartable">
<tr>
<td colspan="2">
      <div id="pdf"><img src="images/PDF.gif" width="16" height="16" hspace="10" />&#160;
           <a title="View Help PDF" href="http://help.adobe.com/en_US/ColdFusion/10.0/Admin/coldfusion_10_admin.pdf">View Help PDF (adobe.com)</a></div>
</td>
</tr>
</table>
    </div>
 
<!-- BEGIN SEARCH CONTENT -->
<form id="search" name="search" action="search.html" target="_self">
<script type="text/javascript">
<!--[CDATA[
if ( !use_chc_behavior ){
    if (typeof(terms_AHV_SEARCH_CONSTRAINT) != "undefined" && 
        terms_AHV_SEARCH_CONSTRAINT.length > 0 && 
        document.location.href.indexOf(".adobe.com") > 0){
        if ( typeof(terms_SEARCH_THIS_HELP_ONLY) != "undefined" && terms_SEARCH_THIS_HELP_ONLY == "ON" ) {
            document.write('<div id="searchscope"> \
                <input onchange="setAHSearchPref();" \
                class="gsa" \
                name="gsa" \
                id="gsa" \
                type="checkbox" \
                checked="checked" \
                value="1" ><\/input>'); 
                
        // Leave the "Search this help system only" checkbox unckecked
        }else{    
            document.write('<div id="searchscope"> \
                <input onchange="setAHSearchPref();" \
                class="gsa" \
                name="gsa" \
                id="gsa" \
                type="checkbox" \
                value="1" ><\/input>'); 
        }
        document.write('<span class="gsalabel">' + terms_AHV_SEARCH_CONSTRAINT + '<\/span><\/div>'); 
    }
    document.write('<input class="searchinput" \
        name="q" \
        id="q" \
        type="text" \
        maxlength="256" \
        value="' + terms_AHV_SEARCH_BUTTON + '" \
        onclick="clearSearch()"><\/input><input \
        type="button" \
        name="searchbutton" \
        class="searchbutton" \
        onclick="submit()"><\/input>'); 
} 
 
/* 
 * Start Functions 
 */
function clearSearch(){
    if (document.search.q.value == terms_AHV_SEARCH_BUTTON){document.search.q.value = ""}; 
}
 
// set search preferences
function setAHSearchPref(){
    if (document.search.gsa.checked == 1){
        setAHSearchCookie( dirname );
    }else{
        setAHSearchCookie( "community" );
    }
}
 
// Set search preferences cookie
function setAHSearchCookie( p ){
    // set cookie ah_searchpref with a value of the document path
    var expire=new Date();
    expire.setDate(expire.getDate()+365); // Cookie expires after 1 year (365 days) 
    document.cookie="ah_searchpref=" +p+ "; expires=" +expire.toGMTString()+ ";";
}
 
// ]]-->
</script> 
 </form>
<!-- END SEARCH CONTENT -->    
 
 
 
<!-- BEGIN PAGE CONTENT WRAPPER -->
    <div id="page_content_wrapper">
<!-- BEGIN PAGE WRAPPER -->
<table id="page_content_table">
<tr>
<!--#include virtual="recommendations_topic.ssi" -->
<td id="col2">
<!-- BEGIN CONTENT WRAPPER -->
<!-- BEGIN BREADCRUMBS -->
 
      
      <div id="breadcrumb">
        
<ul class="navigation"><li class="prev"><a accesskey="p" class="prev" href="WSc3ff6d0ea77859461172e0811cbf364104-7fd3.html" title="Packaging applications in CAR files"><img src="images/blank.gif" alt="Previous" width="17" height="17" /></a></li><li class="next"><a accesskey="n" class="next" href="WSc3ff6d0ea77859461172e0811cbf364104-7fd0.html" title="Using the cfcompile utility"><img src="images/blank.gif" alt="Next" width="17" height="17" /></a></li></ul><div class="hierarchy" id="hierarchy"><a href="WSf01dbd23413dda0e51f089d212047ee7a02-8000.html"><b>Home</b></a> / <a href="WSf01dbd23413dda0e51f089d212047ee7a02-8000.html"><b>Configuring and Administering ColdFusion 10</b></a> / <a href="WSc3ff6d0ea77859461172e0811cbf363af9-7ff6.html"><b>Deploying ColdFusion Applications</b></a> 
     </div>
 
      </div>
<!-- END BREADCRUMBS -->
      <div id="content_wrapper">
<!-- BEGIN PAGE TITLE -->
        <h1>Packaging applications in J2EE archive files</h1>
<!-- END PAGE TITLE -->
<!-- BEGIN IONCOMMENTCOUNT -->
        <div id="ionCount">
        </div>
<!-- END IONCOMMENTCOUNT -->
<table id="inner_content_table" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td>
          <div style="border-top:#ccc solid 1px;"><p> </p>
          </div>
<!--#include virtual="contentheader.ssi" -->
 
          <div id="minitoc"><div class="t"><div class="b"><div><ul id="minitoc-links"><li><p><a href="#WS266BD1DC-4627-4f06-8F43-7710098E9960"><span class="topictitle1">Application packaging</span>
</a></p><ul><li><p><a href="#WS2F273ACE-D288-44d4-BB15-91F68748C970"><span class="topictitle2">Add a new archive definition and create an archive file</span>
</a></p></li></ul></li><li><p><a href="#WSc3ff6d0ea77859461172e0811cbf363af9-7ff8"><span class="topictitle1">Deployment considerations</span>
</a></p></li><li><p><a href="#WSc3ff6d0ea77859461172e0811cbf363af9-7ff7"><span class="topictitle1">Post-deployment considerations</span>
</a></p></li></ul></div></div></div></div><div><p>When running ColdFusion
in the multiserver and J2EE configurations, you deploy the ColdFusion
application, in enterprise application archive (EAR) or web application
archive (WAR) format, on a J2EE application server. You then create
your ColdFusion application, configuring resources (such as data
sources), and storing CFM, CFC, and CFR files in the web application
root or in the web server root. In earlier ColdFusion versions,
your J2EE administrator had to redo each of these steps when deploying
your ColdFusion application onto a production J2EE server.</p>
<p>The ColdFusion Administrator lets
you create an EAR or WAR file that contains the entire application.
This archive file contains the ColdFusion web application, settings
for ColdFusion (such as data source definitions), and the CFM, CFC,
and CFR files that your application uses.</p>
<div class="tip"><img src="images/tip_help.png" />If you are using the multiserver configuration,
you can combine J2EE archiving with the instance creation functionality
of the ColdFusion Administrator Enterprise Manager. First, create
an EAR file that contains your application and all of its settings. Use
that EAR file in the Create From EAR/WAR option of the Instance
Manager. For more information on the Enterprise Manager, see <a href="WSc3ff6d0ea77859461172e0811cbf364104-7fd4.html">Defining additional server instances</a><i xmlns:fn="http://www.w3.org/2005/xpath-functions" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xs="http://www.w3.org/2001/XMLSchema">.</i></div><ul class="navlinklist"></ul>
</div>
<div id="WS266BD1DC-4627-4f06-8F43-7710098E9960" class="nochunk"><a name="WS266BD1DC-4627-4f06-8F43-7710098E9960"><!-- --></a><h2 class="topictitle2">Application packaging</h2><div><p>The
J2EE Archive feature lets you quickly create an archive file that
a J2EE administrator can use to deploy your ColdFusion application.</p>
</div><div id="WS2F273ACE-D288-44d4-BB15-91F68748C970" class="nochunk"><a name="WS2F273ACE-D288-44d4-BB15-91F68748C970"><!-- --></a><h3 class="topictitle3">Add a new archive definition and create an archive file</h3><div><ol><li><p>Open
the ColdFusion Administrator.</p>
</li>
<li><p>Specify a unique name for the archive file (no extension)
in the Archive Name field.</p>
</li>
<li><p>Click Add. The Add New Archive screen appears.</p>
</li>
<li><p>Specify archive settings on the Add New Archive screen.</p>
</li>
<li><p>Click Create. ColdFusion
creates an EAR or WAR file in the specified application distribution
directory.</p>
</li>
</ol>
<p>The following table describes the settings you make when creating
or modifying an archive:</p>
 
<div class="tablenoborder"><table border="1" cellpadding="4" cellspacing="0"><thead align="left"><tr><th valign="top" width="NaN%" id="d16e12659"><p>Setting</p>
</th>
<th valign="top" width="NaN%" id="d16e12662"><p>Description</p>
</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="NaN%" headers="d16e12659 "><p>Archive Type</p>
</td>
<td valign="top" width="NaN%" headers="d16e12662 "><p>Select EAR or WAR.</p>
</td>
</tr>
<tr><td valign="top" width="NaN%" headers="d16e12659 "><p>Context Root (EAR only)</p>
</td>
<td valign="top" width="NaN%" headers="d16e12662 "><p>Each
J2EE web application running in a server is rooted at a unique base
URL, called a context root (or context path). The J2EE application
server uses the initial portion of the URL (that is, the portion
immediately following http://hostname) to determine which web application
services an incoming request.</p>
<p>For example, if you are running
ColdFusion with a context root of <i xmlns:fn="http://www.w3.org/2005/xpath-functions" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xs="http://www.w3.org/2001/XMLSchema">cfmx</i>, you display the Administrator using
the URL http://<i xmlns:fn="http://www.w3.org/2005/xpath-functions" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xs="http://www.w3.org/2001/XMLSchema">hostname</i>/cfmx/CFIDE/administrator/index.cfm.
Most J2EE application servers allow one application in each server
instance to use a forward slash (/) for the context root. The Remote Development
Services (RDS) web application is not required if you use a context
root of /.</p>
</td>
</tr>
<tr><td valign="top" width="NaN%" headers="d16e12659 "><p>Serial Number</p>
</td>
<td valign="top" width="NaN%" headers="d16e12662 "><p>Specifies
a ColdFusion Enterprise Edition serial number. If you do not specify
a valid ColdFusion Enterprise Edition serial number when creating
the archive file, it is deployed as an Enterprise Edition evaluation
version, which reverts to the Developer Edition after 30 days.</p>
</td>
</tr>
<tr><td valign="top" width="NaN%" headers="d16e12659 "><p>COM Support</p>
</td>
<td valign="top" width="NaN%" headers="d16e12662 "><p>If your application doesn’t use COM support,
you can reduce the size of the archive file by omitting the supporting
files.</p>
</td>
</tr>
<tr><td valign="top" width="NaN%" headers="d16e12659 "><p>Debugging</p>
</td>
<td valign="top" width="NaN%" headers="d16e12662 "><p>If the current ColdFusion server is running
with debugging enabled, you can disable debugging in the application
contained in the archive file.</p>
</td>
</tr>
<tr><td valign="top" width="NaN%" headers="d16e12659 "><p>Include CFML Source</p>
</td>
<td valign="top" width="NaN%" headers="d16e12662 "><p>You
can optionally deploy Java bytecode instead of CFML source code.
For more information, see <a href="WSc3ff6d0ea77859461172e0811cbf364104-7fd2.html">Sourceless distribution</a>.</p>
</td>
</tr>
<tr><td valign="top" width="NaN%" headers="d16e12659 "><p>ColdFusion Administrator</p>
</td>
<td valign="top" width="NaN%" headers="d16e12662 "><p>If your application does not require modification
by using the ColdFusion Administrator, you can reduce archive size
and reduce security issues by omitting the Administrator files.</p>
</td>
</tr>
<tr><td valign="top" width="NaN%" headers="d16e12659 "><p>Data sources</p>
</td>
<td valign="top" width="NaN%" headers="d16e12662 "><p>Specifies the data source definitions to
include in the archive file.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div></div></div>
<div id="WSc3ff6d0ea77859461172e0811cbf363af9-7ff8" class="nochunk"><a name="WSc3ff6d0ea77859461172e0811cbf363af9-7ff8"><!-- --></a><h2 class="topictitle2">Deployment considerations</h2><div><p>After the archive file is created, you deploy by using
standard ColdFusion J2EE configuration deployment techniques. For
more information, see <a href="http://help.adobe.com/en_US/ColdFusion/10.0/Installing/WSc3ff6d0ea77859461172e0811cdec18c28-7fda.html" target="_self">Installing
an EAR file or WAR files</a> in <a href="http://help.adobe.com/en_US/ColdFusion/10.0/Installing/WSc3ff6d0ea77859461172e0811cdec18c28-7fff.html" target="_self">Installing
the J2EE Configuration</a> of <i xmlns:fn="http://www.w3.org/2005/xpath-functions" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xs="http://www.w3.org/2001/XMLSchema">Installing ColdFusion</i>.</p>
</div></div>
<div id="WSc3ff6d0ea77859461172e0811cbf363af9-7ff7" class="nochunk"><a name="WSc3ff6d0ea77859461172e0811cbf363af9-7ff7"><!-- --></a><h2 class="topictitle2">Post-deployment considerations</h2><div><p>Depending
on your application, the resources that it uses, and the environment in
which it is deployed, you may need to perform post-deployment configuration,
as follows:</p>
<dl><dt class="dlterm">Mappings</dt>
<dd xmlns:fn="http://www.w3.org/2005/xpath-functions" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xs="http://www.w3.org/2001/XMLSchema">The
ColdFusion mappings in the archived application refer to directories
on the original computer. If those directories do not exist on the deployment
computer, modify the ColdFusion mappings by using the ColdFusion
Administrator or the Administrator API.</dd><p class="dlseparator"></p><dt class="dlterm">Serial number</dt>
<dd xmlns:fn="http://www.w3.org/2005/xpath-functions" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xs="http://www.w3.org/2001/XMLSchema">J2EE deployment is a ColdFusion Enterprise feature. To upgrade to
the Enterprise Edition, use the ColdFusion Administrator or the
Administrator API to enter a serial number.<p>For more information
on the Administrator API, see <a href="WSc3ff6d0ea77859461172e0811cbf364104-7fcf.html">Administrator API</a>.</p>
</dd><p class="dlseparator"></p></dl>
</div></div>
 
 
<!-- BEGIN USER PREFERENCES -->
          <div id="userprefs">
          </div>
<!-- END USER PREFERENCES -->
 
          <div id="related">
            
            
            <div class="separator"><a href="#top"><img src="images/BTT.jpg" /></a>&#160;</div>
          </div>
          <div id="footer">
<!-- BEGIN IONCOMMENTS -->
            <div id="ionComHere">
            </div>
<!-- END IONCOMMENTS -->
<!--#include virtual="/ssi/ionComments.ssi" -->
            <p id="creativecommons"><a href="http://creativecommons.org/licenses/by-nc-sa/3.0/" id="creativecommons_text"><img id="creativecommons_img" src="images/CC.png" alt="This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License" /></a>&nbsp;Twitter™ and Facebook posts are not covered under the terms of Creative Commons.</p>
          </div>
</td>
<td width="10px"></td>
<td id="inner_rightcolumn">
<!--#include virtual="rightcolumn.ssi" -->
</td></tr></table>
      </div>
<!-- BEGIN BREADCRUMBS -->
      <div id="breadcrumb">
        
<ul class="navigation"><li class="prev"><a accesskey="p" class="prev" href="WSc3ff6d0ea77859461172e0811cbf364104-7fd3.html" title="Packaging applications in CAR files"><img src="images/blank.gif" alt="Previous" width="17" height="17" /></a></li><li class="next"><a accesskey="n" class="next" href="WSc3ff6d0ea77859461172e0811cbf364104-7fd0.html" title="Using the cfcompile utility"><img src="images/blank.gif" alt="Next" width="17" height="17" /></a></li></ul><div class="hierarchy" id="hierarchy"><a href="WSf01dbd23413dda0e51f089d212047ee7a02-8000.html"><b>Home</b></a> / <a href="WSf01dbd23413dda0e51f089d212047ee7a02-8000.html"><b>Configuring and Administering ColdFusion 10</b></a> / <a href="WSc3ff6d0ea77859461172e0811cbf363af9-7ff6.html"><b>Deploying ColdFusion Applications</b></a> 
     </div>
 
      </div>
<!-- END BREADCRUMBS -->
<!-- END CONTENT WRAPPER -->
<!--#include virtual="contentfooter.ssi" -->
</td>
<td id="col3">
    <div>
        <img src="images/adobe-lq.png" />
    </div>
</td>
</tr>
</table>
    </div>
<!-- END PAGE CONTENT WRAPPER -->
<script type="text/javascript">
<!--[CDATA[
scrollToNameAnchor();
// ]]-->
</script> 
<!--#include virtual="/en_US/ssi/productmenu.ssi" -->
<style>
#legal-notices{ 
    margin:10px 40px; 
    font-size:11px;
}
</style>
 
<p id="legal-notices">
<script language="javascript">
var pageLoc = "en_US";
var metaElements = document.all ?
document.all.tags('meta') :
document.getElementsByTagName ?
document.getElementsByTagName ('meta') : new Array();
for (var m = 0; m < metaElements.length; m++) {
    if (metaElements[m].name == "lang") {
        pageLoc = metaElements[m].content;
        break;
    }
}
var ptn = /(..)-(..)/;
if (ptn.test(pageLoc)) {
    var languageCode = pageLoc.replace(ptn, "$1");
    var countryCode = pageLoc.replace(ptn, "$2");
    pageLoc = languageCode + "_" + countryCode.toUpperCase();
}
 
var legalLoc = "en_US";
var legalText = "Legal Notices";
var legalPath = legalLoc;
var legalArray=[
"ar_AE", "إشعارات قانونية",
"bg_BG", "Юридически бележки",
"cs_CZ", "Právní upozornění",
"da_DK", "Juridiske meddelelser",
"de_DE", "Rechtliche Hinweise",
"el_GR", "Σημειώσεις νομικού περιεχομένου",
"es_ES", "Avisos legales",
"et_EE", "Juriidilised teated",
"fi_FI", "Lakisääteiset ilmoitukset",
"fr_FR", "Mentions légales",
"he_IL", "הצהרות משפטיות",
"hr_HR", "Pravne napomene",
"hu_HU", "Jogi közlemények",
"it_IT", "Informazioni legali",
"ja_JP", "法律上の注意",
"ko_KR", "법적 고지 사항",
"lt_LT", "Teisinės pastabos",
"lv_LV", "Juridisks paziņojums",
"nb_NO", "Juridiske merknader",
"nl_NL", "Juridische kennisgevingen",
"pl_PL", "Informacje prawne",
"pt_BR", "Aspectos jurídicos",
"ro_RO", "Prevederi legale",
"ru_RU", "Юридическая информация",
"sk_SK", "Právne upozornenie",
"sl_SI", "Pravni pouk",
"sv_SE", "Upphovsrätt",
"tr_TR", "Yasal uyarılar",
"uk_UA", "Юридична інформація",
"zh_CN", "法律声明",
"zh_TW", "法律注意事項"
];
 
for (var i = 0; i < legalArray.length; i+=2) {
    if (pageLoc == legalArray[i]) {
        legalLoc = pageLoc;
        legalText = legalArray[i+1];
        legalPath = legalLoc;
        break;
    }
}
document.write('<a target="_blank" href="http://help.adobe.com/'+legalPath+'/legalnotices/index.html">'+legalText+'</a>');
</script>
</p>
 
<!--#include virtual="/en_US/ssi/localfooter.ssi" -->
<!--#include virtual="footer.ssi" -->
<!--#include virtual="/ubi/analytics/analytics_ssi.html" -->
  </body>
</html>