You can change or add application files on application
servers without having to stop the server and start it again.
About this task
The following note applies to the xmi file references
in this topic:
支援的配置: 對於 IBM® 延伸和連結檔而言,.xmi 或 .xml 副檔名取決於您是使用 Java EE 5 之前的應用程式或模組,或 Java™ EE 5 或更新版本的應用程式或模組。
IBM 延伸或連結檔稱為 ibm-*-ext.xmi 或 ibm-*-bnd.xmi,其中 * 是延伸或連結檔的類型,例如:app、application、ejb-jar 或 web。
適用的條件如下:
- 如果應用程式或模組使用第 5 版之前的 Java EE,副檔名必須是 .xmi。
- 如果應用程式或模組使用 Java EE 5 或更新的版本,副檔名必須是 .xml。
如果 .xmi 檔是隨附在應用程式或模組,則本產品會忽略 .xmi 檔。
不過,即使應用程式含有 Java EE 5 之前的檔案,且所用的副檔名是 .xmi,其中也可以有 Java EE 5 或更新版本的模組。
ibm-webservices-ext.xmi、ibm-webservices-bnd.xmi、ibm-webservicesclient-bnd.xmi、ibm-webservicesclient-ext.xmi 和 ibm-portlet-ext.xmi 檔會繼續使用 .xmi 副檔名。
sptcfg
![[Solaris]](../images/solaris.gif)
Restriction: The hot deployment and
dynamic reloading function is supported when the product is running
on these operating systems only when JVM system property
sun.zip.disableMemoryMapping is
set to
true. The Java archive (JAR) files within
the associated Java Development Kit (JDK) are memory mapped. If these
JAR files are updated by the hot deployment and dynamic reloading
functionality when they are being used by the Java virtual machine
(JVM), the files become inconsistent, which results in an application
server crash. When you make changes to an application on these operating
systems and JVM system property
sun.zip.disableMemoryMapping is
not set to
true, do not use the hot deployment
and dynamic reloading functionality. Instead, restart the application
to reflect the changes.
There are several changes that you
can make to deployed application files without stopping the server
and starting it again.
Important: See
Ways to update enterprise application files and determine whether hot deployment
is the appropriate way for you to update your application files. Other
ways are easier and hot deployment is appropriate only for experienced
users. You can
use
the update wizard of the administrative console to make the
changes without having to stop and restart the server.
The
following table lists the changes that you can make by manipulating
an application file on the server where the application is deployed.
The table also states whether you use hot deployment or dynamic reloading
to make the changes.
- Update an existing application on a running server
by providing a new EAR file.
Reinstall an updated application
using the administrative
console or the wsadmin $AdminApp install command with
the -update option.
Both reinstallation methods enable
you to update an existing application using any of the other steps
listed in this file, including changing classes, adding modules, removing
modules, changing modules, or changing metadata files. The application
reinstallation methods detect the changes in your application and
prompt you for additional binding data that might be needed to install
the application. The reinstallation process automatically stops and
restarts your application on the appropriate servers.
- Add a new application to a running server.
Install an application using the administrative console or
the wsadmin install command.
- Remove an existing application from a running
server.
Stop the application and then uninstall it from
the server. Use the administrative console to stop the application and
then uninstall it.
Or use the stopApplication attribute of the AdminControl
object with the wsadmin tool and then run the uninstall command.
- Change or add files to existing EJB or web modules.
- Update the application files in the application_root location.
- Restart the application.
Use the administrative
console to restart
the application. Or use the startApplication and stopApplication attributes
of the AdminControl object with the wsadmin tool.
- Change the application.xml file for
an application.
Restart the application. Automatic reloading
will not detect the change. Use the administrative console to restart the application.
Or use the startApplication and stopApplication attributes
of the AdminControl object with the wsadmin tool.
- Change the ibm-app-ext.xmi file for
an application.
Restart the application. Automatic reloading
will not detect the change. Use the administrative console to restart the application.
Or use the startApplication and stopApplication attributes
of the AdminControl object with the wsadmin tool.
- Change the ibm-app-bnd.xmi file for an
application.
Restart the application. Automatic reloading
will not detect the change. Use the administrative console to restart the application.
Or use the startApplication and stopApplication attributes
of the AdminControl object with the wsadmin tool.
- Change a non-module Jar file contained in the
EAR file.
- Update the non-module Jar file in the application_root location.
- If automatic reloading is not enabled, restart the application.
Use the administrative console to restart the application. Or use the startApplication and stopApplication attributes
of the AdminControl object with the wsadmin tool.
If
automatic reloading is enabled, you do not need to take further action.
Automatic reloading will detect the change.