depapp.html

Sun Java System Application Server Enterprise Edition 8.1 管理指南

<a name="wp830946"> </a><p class="pParagraph">
在一个应用程序中，不同类型的模块可以具有相同的名称。部署应用程序时，将使用 <code class="cCode">_jar</code>、<code class="cCode">_war</code> 和 <code class="cCode">_rar</code> 后缀来命名保存各个模块的目录。相同类型的模块在一个应用程序内必须具有唯一的名称。此外，数据库架构文件名在一个应用程序内必须是唯一的。
</p>
<a name="wp830948"> </a><p class="pParagraph">
建议将 Java 类似软件包的命名模式用于模块文件名、EAR 文件名、在 <code class="cCode">ejb-jar.xml</code> 文件的 <code class="cCode">&lt;module-name&gt;</code> 部分找到的模块名以及在 <code class="cCode">ejb-jar.xml</code> 文件的 <code class="cCode">&lt;ejb-name&gt;</code> 部分找到的 EJB 名称。使用这种类似软件包的命名模式可以确保不会发生名称冲突。这种命名方式的好处不仅适用于 Sun Java System Application Server，也适用于其他 J2EE 应用程序服务器。
</p>
<a name="wp830952"> </a><p class="pParagraph">
EJB 的 JNDI 查找名称也必须是唯一的。建立一致的命名约定可能会有帮助。例如，将应用程序名和模块名附加到 EJB 名称中是一种确保名称唯一的方式。在这种情况下，mycompany.pkging.pkgingEJB.MyEJB 将是模块 pkgingEJB.jar（该模块封装在应用程序 pkging.ear 中）中的 EJB 的 JNDI 名称。
</p>
<a name="wp830954"> </a><p class="pParagraph">
请确保软件包和文件名称中不包含空格或操作系统视为非法的字符。 
</p>
<a name="wp830958"> </a><h2 class="pHeading1">
<hr />
用于部署应用程序的管理控制台任务
</h2>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp830964"> </a><div class="pSmartList1"><li><a  href="depapp.html#wp831012" tppabs="http://docs.sun.com/source/819-1553/depapp.html#wp831012">部署企业应用程序</a></li></div>
<a name="wp830970"> </a><div class="pSmartList1"><li><a  href="depapp.html#wp831146" tppabs="http://docs.sun.com/source/819-1553/depapp.html#wp831146">部署 Web 应用程序</a></li></div>
<a name="wp830976"> </a><div class="pSmartList1"><li><a  href="depapp.html#wp831238" tppabs="http://docs.sun.com/source/819-1553/depapp.html#wp831238">启动已部署的 Web 应用程序</a></li></div>
<a name="wp830982"> </a><div class="pSmartList1"><li><a  href="depapp.html#wp831306" tppabs="http://docs.sun.com/source/819-1553/depapp.html#wp831306">部署 EJB 模块</a></li></div>
<a name="wp830988"> </a><div class="pSmartList1"><li><a  href="depapp.html#wp831700" tppabs="http://docs.sun.com/source/819-1553/depapp.html#wp831700">部署应用程序客户机模块</a></li></div>
<a name="wp830994"> </a><div class="pSmartList1"><li><a  href="depapp.html#wp831426" tppabs="http://docs.sun.com/source/819-1553/depapp.html#wp831426">部署连接器模块</a></li></div>
<a name="wp831000"> </a><div class="pSmartList1"><li><a  href="depapp.html#wp831584" tppabs="http://docs.sun.com/source/819-1553/depapp.html#wp831584">创建生命周期模块</a></li></div>
<a name="wp831006"> </a><div class="pSmartList1"><li><a  href="depapp.html#wp831700" tppabs="http://docs.sun.com/source/819-1553/depapp.html#wp831700">部署应用程序客户机模块</a></li></div>
</ul></div>
<a name="wp831012"> </a><h3 class="pHeading2">
部署企业应用程序
</h3>
<a name="wp831016"> </a><p class="pParagraph">
企业应用程序封装在 EAR 文件中，此文件是一种包含任何类型的 J2EE 独立模块（如 WAR 文件和 EJB JAR 文件）的归档文件。 
</p>
<a name="wp831018"> </a><p class="pParagraph">
要部署（安装）企业应用程序，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp831020"> </a><div class="pSmartList1"><li>在树组件中，展开“应用程序”节点。</li></div>
<a name="wp831022"> </a><div class="pSmartList1"><li>选择“企业应用程序”节点。</li></div>
<a name="wp831024"> </a><div class="pSmartList1"><li>在“企业应用程序”页面中，单击“部署”。</li></div>
<a name="wp831026"> </a><div class="pSmartList1"><li>在“部署”页面中，指定要部署的 EAR 文件的位置。</li></div>
<a name="wp831028"> </a><p class="pStepParaI1">
服务器是运行应用程序服务器和域管理服务器的主机。客户机是可以用于通过浏览器来查看管理控制台的主机。 
</p>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp831030"> </a><div class="pSmartList2"><li>如果文件位于客户机上或可以从客户机访问，则单击单选按钮以指定软件包文件以上载到 Application Server。</li></div>
<a name="wp831032"> </a><p class="pStepParaI2">
单击“浏览”以找到文件，或键入文件的完整路径。
</p>
<a name="wp831034"> </a><div class="pSmartList2"><li>如果文件位于服务器上，或者要从展开的目录部署未封装的应用程序，则单击单选按钮以指定必须可以从服务器上访问的软件包文件或目录路径。</li></div>
<a name="wp831036"> </a><p class="pStepParaI2">
键入文件或目录的完整路径名。从展开的目录部署适用于高级开发者，但不建议在生产环境下进行此操作。
</p>
</ol></div>
<a name="wp831038"> </a><div class="pSmartList1"><li>单击“下一步”将显示“部署企业应用程序”页面。</li></div>
<a name="wp831040"> </a><div class="pSmartList1"><li>在“部署企业应用程序”页面中，请指定应用程序的设置。</li></div><br>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp831042"> </a><div class="pSmartList2"><li>在“应用程序名称”字段中，既可以保留默认名称（即文件名的前缀），也可以键入其他名称。（如果您选择上载文件，将显示默认名称。）应用程序名称必须唯一。</li></div>
<a name="wp831048"> </a><div class="pSmartList2"><li>默认情况下，部署应用程序之后即可使用该应用程序。要在部署之后禁用应用程序以使其不可用，请选中“已禁用”单选按钮。</li></div>
<a name="wp831050"> </a><div class="pSmartList2"><li>如果已部署应用程序，请选中“重新部署”复选框以对其进行重新部署；否则将显示错误。您也可以选择其他应用程序名称，并以新名称对其进行部署。</li></div>
<a name="wp831052"> </a><div class="pSmartList2"><li>要在部署之前检验文件的结构和内容，请选中“验证器”复选框。大型应用程序的检验会很耗费时间。如果怀疑文件已损坏或不可移植，请检验文件。</li></div>
<a name="wp831054"> </a><div class="pSmartList2"><li>要预编译 JSP 页面，请选中“JSP”复选框。如果未选中此复选框，则首次访问 JSP 页面时会在运行时编译这些页面。由于编译通常很耗费时间，因此在生产环境中请选中此复选框。</li></div>
<a name="wp831056"> </a><div class="pSmartList2"><li>选择高可用性设置。</li></div>
<a name="wp831058"> </a><p class="pStepParaI2">
要启用应用程序的高可用性，请选中“可用性”复选框。如果启用了应用程序的可用性，则必须也在所有更高级别（指配置和 Web 容器或 EJB 容器）启用可用性。
</p>
<a name="wp831060"> </a><div class="pSmartList2"><li>选择要将应用程序部署到的目标。</li></div>
<a name="wp831062"> </a><p class="pStepParaI2">
从可用目标的列表中选择目标，并单击“添加”。目标可以是群集或独立服务器实例。如果不选择目标，应用程序将被部署到默认服务器实例 <code class="cCode">server</code>。
</p>
<a name="wp831068"> </a><p class="pStepParaI2">
如果您要重新部署，请勿选择目标。此时您所作的任何选择都将被忽略。引用已部署的应用程序的所有目标群集或独立服务器实例都将自动引用新的、重新部署的应用程序（如果已启用群集或独立实例的动态重新配置）。有关如何在不中断服务的情况下重新部署应用程序的更多信息，请参见“<a  href="loadb.html#wp698244" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp698244">升级应用程序</a>”。
</p>
<a name="wp831070"> </a><div class="pSmartList2"><li>选择是否生成 RMI 存根。</li></div>
<a name="wp831072"> </a><p class="pStepParaI2">
如果选择生成 RMI 存根，将生成静态 RMI-IIOP 存根并将其添加到 client.jar。
</p>
</ol></div>
<a name="wp831074"> </a><div class="pSmartList1"><li>单击“确定”以部署应用程序。</li></div>
</ol></div>
<a name="wp831076"> </a><p class="pParagraph">
等效的 <code class="cCode">asadmin</code> 命令为：<code class="cCode">deploy</code>
</p>
<a name="wp831146"> </a><h3 class="pHeading2">
部署 Web 应用程序
</h3>
<a name="wp831150"> </a><p class="pParagraph">
Web 应用程序封装在 WAR 文件中，此文件是一种包含组件（如 Servlet 和 JSP 页面）的归档文件。 
</p>
<a name="wp831152"> </a><p class="pParagraph">
要部署（安装）Web 应用程序，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp831154"> </a><div class="pSmartList1"><li>在树组件中，展开“应用程序”节点。</li></div>
<a name="wp831156"> </a><div class="pSmartList1"><li>选择“Web 应用程序”节点。</li></div>
<a name="wp831158"> </a><div class="pSmartList1"><li>在“Web 应用程序”页面中，单击“部署”。</li></div>
<a name="wp831160"> </a><div class="pSmartList1"><li>在“部署”页面中，指定要部署的 WAR 文件的位置。</li></div>
<a name="wp831162"> </a><p class="pStepParaI1">
服务器是运行应用程序服务器和域管理服务器的主机。客户机是可以用于通过浏览器来查看管理控制台的主机。 
</p>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp831164"> </a><div class="pSmartList2"><li>如果文件位于客户机上或可以从客户机访问，则单击单选按钮以指定软件包文件以上载到 Application Server。</li></div>
<a name="wp831166"> </a><p class="pStepParaI2">
单击“浏览”以找到文件，或键入文件的完整路径。
</p>
<a name="wp831168"> </a><div class="pSmartList2"><li>如果文件位于服务器上，或者要从展开的目录部署未封装的应用程序，则单击单选按钮以指定必须可以从服务器上访问的软件包文件或目录路径。</li></div>
<a name="wp831170"> </a><p class="pStepParaI2">
键入文件或目录的完整路径名。从展开的目录部署适用于高级开发者，但不建议在生产环境下进行此操作。
</p>
</ol></div>
<a name="wp831172"> </a><div class="pSmartList1"><li>单击“下一步”以显示“部署 Web 应用程序”页面。</li></div>
<a name="wp831174"> </a><div class="pSmartList1"><li>在“部署 Web 应用程序”页面中，指定应用程序的设置。</li></div><br>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp831176"> </a><div class="pSmartList2"><li>在“应用程序名称”字段中，既可以保留默认名称（即文件名的前缀），也可以键入其他名称。（如果您选择上载文件，将显示默认名称。）应用程序名称必须唯一。</li></div>
<a name="wp831178"> </a><div class="pSmartList2"><li>在“上下文根路径”字段中，输入标识 Web 应用程序的字符串。在 Web 应用程序的 URL 中，上下文根路径要紧跟着端口号 (<code class="cCode">http://host:port/context-root/...</code>)。确保上下文根路径以正斜杠开头，例如：<code class="cCode">/hello</code></li></div>
<a name="wp831184"> </a><div class="pSmartList2"><li>默认情况下，部署应用程序之后即可使用该应用程序。要在部署之后禁用应用程序以使其不可用，请选中“已禁用”单选按钮。</li></div>
<a name="wp831186"> </a><div class="pSmartList2"><li>如果已部署应用程序，请选中“重新部署”复选框以对其进行重新部署；否则将显示错误。您也可以选择其他应用程序名称，并以新名称对其进行部署。</li></div>
<a name="wp831188"> </a><div class="pSmartList2"><li>要在部署之前检验文件的结构和内容，请选中“验证器”复选框。大型应用程序的检验通常会很耗费时间。如果怀疑文件已损坏或不可移植，请检验文件。</li></div>
<a name="wp831190"> </a><div class="pSmartList2"><li>要预编译 JSP 页面，请选中“JSP”复选框。如果未选中此复选框，则首次访问 JSP 页面时会在运行时编译这些页面。由于编译通常很耗费时间，因此在生产环境中请选中此复选框。</li></div>
<a name="wp831192"> </a><div class="pSmartList2"><li>选择高可用性设置。</li></div>
<a name="wp831194"> </a><p class="pStepParaI2">
要启用应用程序的高可用性，请选中“可用性”复选框。如果启用了应用程序的可用性，则必须也在所有更高级别（指配置和 Web 容器或 EJB 容器）启用可用性。
</p>
<a name="wp831196"> </a><div class="pSmartList2"><li>选择要将应用程序部署到的目标。</li></div>
<a name="wp831198"> </a><p class="pStepParaI2">
从可用目标的列表中选择目标，并单击“添加”。目标可以是群集或独立服务器实例。如果不选择目标，应用程序将被部署到默认服务器实例 <code class="cCode">server</code>。
</p>
<a name="wp831204"> </a><p class="pStepParaI2">
如果您要重新部署，请勿选择目标。此时您所作的任何选择都将被忽略。引用已部署的应用程序的所有目标群集或独立服务器实例都将自动引用新的、重新部署的应用程序（如果已启用群集或独立实例的动态重新配置）。有关如何在不中断服务的情况下重新部署应用程序的更多信息，请参见“<a  href="loadb.html#wp698244" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp698244">升级应用程序</a>”。
</p>
<a name="wp831206"> </a><div class="pSmartList2"><li>选择是否生成 RMI 存根。</li></div>
<a name="wp831208"> </a><p class="pStepParaI2">
如果选择生成 RMI 存根，将生成静态 RMI-IIOP 存根并将其添加到 client.jar。
</p>
</ol></div>
<a name="wp831210"> </a><div class="pSmartList1"><li>单击“确定”以部署应用程序。</li></div>
</ol></div>
<a name="wp831212"> </a><p class="pParagraph">
等效的 <code class="cCode">asadmin</code> 命令为：<code class="cCode">deploy</code>
</p>
<a name="wp831238"> </a><h3 class="pHeading2">
启动已部署的 Web 应用程序
</h3>
<a name="wp831242"> </a><p class="pParagraph">
部署完应用程序之后，您可以从管理控制台启动该应用程序。
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp831244"> </a><div class="pSmartList1"><li>在树组件中，展开“应用程序”节点。</li></div>
<a name="wp831246"> </a><div class="pSmartList1"><li>单击“Web 应用程序”。</li></div>
<a name="wp831248"> </a><div class="pSmartList1"><li>单击 Web 应用程序的“启动”链接。</li></div>
<a name="wp831250"> </a><div class="pSmartList1"><li>在“Web 应用程序链接”页面中单击链接以启动应用程序。</li></div>
<a name="wp831252"> </a><p class="pStepParaI1">
服务器和 HTTP 侦听器必须正在运行，应用程序才能启动。
</p>
</ol></div>
<a name="wp831306"> </a><h3 class="pHeading2">
部署 EJB 模块