Update the global web server plug-in configuration setting

Use this page to create or update a global plug-in configuration file. The configuration settings this file contains are based on the topology of the cell that contains the applications servers that use this web server plug-in. The web server plug-in configuration file settings determine whether an application server or the web server handles user requests.

A global web server plug-in configuration file must be regenerated whenever:
  • You change the configuration settings for an application server, cluster, web container transport, or virtual host alias that is contained in the cell.
  • You add a new application server, cluster, web container transport, or virtual host alias to the cell.
The generated plugin-cfg.xml file is placed in the %was_profile_home%/config/cells directory. If your web server is located on a remote machine, you must manually move this file to that machine.
Avoid trouble: Topology-centric, or global, plug-in configuration is deprecated. New features are not supported when using topology-centric generation and topology-centric plug-in configuration support may be removed in the future. Configurations should be migrated to application-centric as described in Implementing a web server plug-in.

When using a topology-centric configuration, custom properties may need to be added manually to the generated plugin-cfg.xml. Generation will not modify existing values in plugin-cfg.xml. To generate a new configuration without existing modifications, the file config/cells/plugin-cfg.xml must be removed prior to global plug-in configuration generation.

When working with an existing topology-centric configuration, you can update the global plugin-cfg.xml file using the administrative console or running the GenPluginCfg command for all of the clusters in a cell. However, you must delete the config/cells/plugin-cfg.xml file before you update the global plugin-cfg.xml file. Be aware that if you do not delete the config/cells/plugin-cfg.xml file, only the new properties and their values are added to the global plugin-cfg.xml file. Any updates to existing plug-in property values are not added to the global plugin-cfg.xml file.

To view this administrative console page, click Environment > Update global web server plug-in configuration.

Click OK to update the global plugin-cfg.xml file.

Click View or download the current web server plug-in configuration file if you want to:
  • View the current version of the file before you update it.
  • View the file after it is updated.
  • Download a copy of this file to a remote machine.