Manually editing the plug-in configuration

Why and when to perform this task

Regenerating the plug-in configuration file does not guarantee a correct configuration for advanced configuration scenarios. If your use of the WebSphere Application Server product requires a plug-in configuration more advanced than what is provided with the default plug-in configuration, or if the plug-in does not behave as properly after the configuration file is regenerated, you can manually edit the configuration file to obtain the proper plug-in behavior for your environment.

Steps for this task

  1. Find the plug-in configuration files. By default, the working or active versions of the plugin-cfg.xml file reside in the directory install_root/config/cells.
  2. Manually edit the plug-in configuration files.
    A plugin-cfg.xml file is created using either the Update Web Server Plug-in Configuration page in the Application Server administrative console, or by running the GenPluginCfg.sh script. If the file is created in a distributed platform environment, it will be in ASCII format, which is the required format for a distributed platform Web server plug-in.

    To edit a plugin-cfg.xml file, open the file in a text editor, change the plug-in settings as needed, and save the file.

    CAUTION: If the plug-in configuration is regenerated, your manual edits to the plug-in configuration file will be overwritten. Therefore, you should maintain a record of any manual changes you make for future reference.

  3. If you edited the plugin-cfg.xml files on federated nodes, turn off automatic synchronization of nodes on the File Synchronization Service page to prevent the edited files from being overwritten. Because a plugin-cfg.xml file on a Network Deployment machine is stored in the configuration repository, the plugin-cfg.xml file is overwritten on all federated nodes in your network whenever the Network Deployment machine updates the configuration repository on these nodes. If you need to regenerate the plugin-cfg.xml file on the Network Deployment machine:
    1. Save your edited plugin-cfg.xml files on the federated nodes.
    2. Force node synchronization of each federated node.
    3. Replace the updated plugin-cfg.xml file with the saved copy or merge the customized pieces of the saved copy into the new plugin-cfg.xml file.

Related concepts
Situations requiring manual editing of the plug-in configuration
Related tasks
Configuring Web server plug-ins
Related reference
plugin-cfg.xml file



Searchable topic ID:   trun_plugin_edit
Last updated: Jun 21, 2007 4:55:42 PM CDT    WebSphere Application Server Network Deployment, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/twsv_plugin_edit.html

Library | Support | Terms of Use | Feedback