ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatz_5.4.0.1/51/admin/acahot.htm

63 lines
5.8 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
<title>Use hot deployment and dynamic reloading</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h4><a name="acahot"></a>Use hot deployment and dynamic reloading</h4>
<p>You can change applications and their contents without stopping and restarting the application server that hosts the application. This process is called hot deployment and dynamic reloading. Hot deployment is the process of adding new application components to an application server while the application server is running. Dynamic reloading refers to the ability of an application to integrate changes while it is running. Dynamic reloading applies to these changes:</p>
<ul>
<li>Changes to the implementation of a component of an application. For example, changes to the implementation of a servlet.</li>
<li>Changes to the settings of the application. For example, changes to the deployment descriptor for a Web module.</li>
</ul>
<p>If the application you are updating is deployed on a server that has its application class loader policy set to SINGLE, you might not be able to dynamically reload your application. In this case, you must restart the server after you update the application.</p>
<p>To update an application without stopping and restarting the application server, follow these steps:</p>
<ol>
<li><p>Locate the expanded application files. The application files are located in the directory that you specify when you install the application. If you do not specify a target directory, the application files are located in the default target directory, /QIBM/UserData/WebASE51/ASE/<em>instance</em>/installedApps/<em>cell</em>/<em>appEARfile</em>, where <em>instance</em> is the name of your instance, <em>cell</em> is the name of your cell, and <em>appEARfile</em> is the name of the application EAR file.</p>
<p>If you cannot locate the expanded application files, look up the application binaries location with the administrative console.</p>
<ol type="a">
<li>In the administrative console topology tree, expand <strong>Applications</strong> and click <strong>Enterprise Applications</strong>.</li>
<li>Click the name of the application that you want to update.</li>
<li>The value specified in the Application Binaries field is the location of the expanded application files.</li>
</ol>
<p><strong>Note:</strong> The variable <em>application_root</em> represents the directory that contains the expanded application files.</p></li>
<li><p>Locate application metadata files. The metadata files include the deployment descriptors, such as web.xml, and application.xml; the bindings files, such as ibm-web-bnd.xmi and ibm-app-bnd.xmi; and the extensions files, such as ibm-web-ext.xmi and ibm-app-ext.xmi. Metadata XML files for an application can be loaded from either of these locations:</p>
<ul>
<li>The application EAR file directory: <em>application_root</em>/META-INF.</li>
<li>The application deployment directory: /QIBM/UserData/WebASE51/ASE/<em>instance</em>/config/cells/<em>cell</em>/applications
<br>/<em>appEARfile</em>/deployments/<em>appName</em>/META-INF, where <em>instance</em> is the name of your instance, <em>cell</em> is the name of your cell, <em>appEARfile</em> is the name of the application EAR file, and <em>appName</em> is the name of the deployed application.</li>
</ul>
<p>The value of the useMetadataFromBinary attribute, which is specified when you install an application, determines which location is used. To determine which location is used, follow these steps:</p>
<ol type="a">
<li>In the administrative console topology tree, expand <strong>Applications</strong> and click <strong>Enterprise Applications</strong>.</li>
<li>Click the name of the application that you want to update.</li>
<li>If the Use Metadata From Binaries field is selected, the metadata files are loaded from the application EAR file directory. If it is not selected, the metadata files are loaded from the application deployment directory.</li>
</ol>
<p><strong>Note:</strong> The variable <em>metadata_root</em> represents the location of the metadata files for the specified application or module.</p></li>
<li><p>(Optional) Examine the values specified for <strong>Reload Enabled</strong> and <strong>Reload Interval</strong> on the settings page for your enterprise application. For more information about these settings, see <a href="help/urun_rapp_inst.html">Enterprise application settings</a>. <img src="help.gif" width="18" height="15" alt="Go to Help documentation" border="0"> If reloading of application files is enabled and the reload interval is greater than zero (0), the application's files are reloaded after the application is updated. For Web modules such as servlets and JavaServer Pages (JSP) files, a Web container reloads a Web module only when the IBM extension reloadingEnabled in the ibm-web-ext.xmi file is also set to true. You can set reloadingEnabled to true when you edit your Web module's extended deployment descriptors with an assembly tool.</p></li>
<li><p>Change or add components or modules. For more information, see these topics:</p>
<ul>
<li><a href="acahotapp.htm">Change or add application files</a></li>
<li><a href="acahotwar.htm">Change or add WAR files</a></li>
<li><a href="acahothttp.htm">Change the HTTP plug-in configuration</a></li>
</ul>
<p><strong>Note:</strong> Some of these changes specify that you must restart the application before the changes take effect. If you need to restart the application, see <a href="guimngapp.htm">Manage installed applications</a> for instructions.</p></li>
</ol>
</body>
</html>