IBM Support

Changes to plug-in properties are not being reflected in the global plugin-cfg.xml file

Troubleshooting


Problem

You are attempting to update plugin-cfg.xml properties like ServerIOTimeout and ConnectTimeout for a particular WebSphere Application Server. You expect the function "Update Global Web server Plug-in configuration" to update the associated values in the global plugin-cfg.xml file located in the config/cells directory, however, the plug-in properties are not updated.

Cause

Since WebSphere Application Server V6.0, the strategic direction for the WebSphere plugin-cfg.xml file has been to associate a plugin-cfg.xml file with each web server mapped and defined in the administrative console. The plugin-cfg.xml file can be generated, and in some cases, propagated to the IBM HTTP Server web server directly from the web server collection panel.

Since WebSphere Application Server V6.0, the function "Update Global Web server Plug-in Configuration" has changed. This function no longer updates the values to existing plug-in properties in the global plugin-cfg.xml file. The global plugin-cfg.xml is located in config/cells directory. Any changes to the WebSphere repository that affect plug-in properties (VirtualHost, URIs or other property values) that are already initialized in the existing global plugin-cfg.xml will not be updated with new values. Only newly added plug-in properties will be added to the global plugin-cfg.xml file as a result of "Update Global Web server Plug-in configuration" function. This functions is located at Environment > Update Web server Plug-in configuration

We discourage use of global plugin generation and it will be deprecated in the future; it really is a old artifact from before users could map to a web servers so if users want to have generate pick up custom properties, they should look at generating to a web server instead of global generation.

Environment

Affects users who use the global plugin-cfg.xml file located in config/cells

Resolving The Problem

  • Manually delete the existing plugin-cfg.xml file in the config/cells directory. In order to update plugin-in property values in the existing global plugin-cfg.xml file, you must first delete the global plugin-cfg.xml located in config/cells directory. Then issue the GenPluginCfg.sh(bat) command.

  • Create wrapper script/bat files to delete the existing plugin-cfg.xml file (and save) before the generation of a new plugin-cfg.xml file.

    Here is an example of a wrapper script for Windows (bat) that can be used to create your own wrapper (sh)(bat) in the DMGR/bin directory:

    • @echo off
    SETLOCAL
    call "%~dp0\setupCmdLine.bat"

    REM Start of added  lines
    ECHO "USER INSTALL ROOT " %USER_INSTALL_ROOT%
    ECHO "COPY OLD plugin-cfg.xml to  plugin-cfg.xml.old"
    set PLGPATH=%USER_INSTALL_ROOT%\config\cells
    set PLGFILE=%PLGPATH%\plugin-cfg.xml
    set NEWPLGFILE=%PLGPATH%\plugin-cfg.xml.old
    ECHO "PLGPATH " %PLGPATH%
    ECHO "PLGFILE " %PLGFILE%
    ECHO "NEWPLGFILE " %PLGFILE%
    copy %PLGFILE%  %NEWPLGFILE%
    erase %PLGFILE%
    REM End of added lines

    call "%WAS_HOME%\bin\GenPluginCfg.bat" %*
    ENDLOCAL & set MYERRORLEVEL=%ERRORLEVEL%
    if defined PROFILE_CONFIG_ACTION (exit %MYERRORLEVEL%) else exit /b %MYERRORLEVEL%

    This script will saved the current pluign-cfg.xml as plugin-cfg.xml.old, erase the current plugin-cfg.xml and then call GenPluginCfg.bat to generate a new plugim-cfg.xml in the config/cells directory based on the current values in the WebSphere repository.

[{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Plug-in","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0","Edition":"Base;Network Deployment","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21441220

Page Feedback