Change the HTTP plug-in configuration
We can change the HTTP plug-in configuration without having to stop the server and start it again.
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 JVM (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 the 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 you use hot deployment or dynamic reloading to make the changes.
changes to HTTP plug-in configuration files. Available
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 web.xml 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 you use the GenPluginCfg.bat/sh script. Otherwise, configuration changes do not persist to the plugin-cfg.xml file.gotcha
- 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.
See Web server plug-in properties for information on how to set this property. We can also run the GenPluginCfg.bat/sh script, or issue a wsadmin command to regenerate the plug-in configuration file.
- Change web.xml to add, remove, or modify a servlet mapping.
- Change web.xml.
- If the plug-in configuration property Automatically propagate plug-in configuration file is selected for this plug-in, it is automatically regenerated whenever web.xml changes.
See Web server plug-in properties for information on how to set this property. 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.
See Web server plug-in properties for information on how to set the this property. We can also run the GenPluginCfg.bat/sh script, or issue a wsadmin command to regenerate the plug-in configuration file.
Related tasks
Hot deployment and dynamic reloading Get started with wsadmin scripting
Web server plug-in properties