Changing the HTTP plug-in configuration
We can change the HTTP plug-in configuration without having to stop the server and start it again.
(Solaris) (HPUX) Restriction: The hot deployment and dynamic reloading function is not supported when the product is running on these operating systems. The 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 we make changes to an application on these operating systems, do not use the hot deployment and dynamic reloading functionality. Instead, restart the application to reflect the changes.
There are several change that we can make to the HTTP plug-in configuration 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 our HTTP plug-in configuration. Other ways are easier and hot deployment is appropriate only for experienced users.
The following table lists the changes that we can make to the HTTP plug-in configuration. The table also states whether we use hot deployment or dynamic reloading to make the changes.
Change Hot deployment Dynamic reloading Change the application.xml file to change the context root of a web application archive (WAR file). Yes No Change the web.xml file to add, remove, or modify a servlet mapping. Yes Yes Change the server.xml file to add, remove, or modify an HTTP transport or change the virtualhost.xml file to add or remove a virtual host or to add, remove, or modify a virtual host alias. Yes Yes The following steps reference the GenPluginCfg.bat/sh script. We must delete the plugin-cfg.xml file in the profile_root/config/cells directory before we use the GenPluginCfg.bat/sh script. Otherwise, configuration changes do not persist to the plugin-cfg.xml file.
Tasks
Change the application.xml file to change the context root of a WAR file.
- Change the application.xml file.
- If the plug-in configuration property Automatically propagate plug-in configuration file is selected for this plug-in, it is automatically regenerated whenever the application.xml file changes.
We can also run the GenPluginCfg.bat/sh script, or issue a wsadmin command to regenerate the plug-in configuration file.
Change the web.xml file to add, remove, or modify a servlet mapping.
- Change the web.xml file.
- If the plug-in configuration property Automatically propagate plug-in configuration file is selected for this plug-in, it is automatically regenerated whenever the web.xml file changes.
We can also run the GenPluginCfg.bat/sh script, or issue a wsadmin command to regenerate the plug-in configuration file.
If the web application has file serving enabled or has a servlet mapping of /, the plug-in configuration does not have to be regenerated. In all other cases a regeneration is required.
Change the server.xml file to add, remove, or modify an HTTP transport or change the virtualhost.xml file to add or remove a virtual host or to add, remove, or modify a virtual host alias.
- Change the server.xml file or the virtualhost.xml file.
- If the plug-in configuration property Automatically propagate plug-in configuration file is selected for this plug-in, it is automatically regenerated whenever the server.xml file changes.
We can also run the GenPluginCfg.bat/sh script, or issue a wsadmin command to regenerate the plug-in configuration file.
Hot deployment and dynamic reloading Get started with wsadmin scripting Web server plug-in properties