IBM Support

On WebSphere Application Server for z/OS, web servers with Intelligent Management enabled do not start

Troubleshooting


Problem

On WebSphere Application Server for z/OS, web servers with Intelligent Management enabled do not start. A failure occurs during the initial connection to the Intelligent Management Representational State Transfer (REST) service. The WebSphere web server plug-in falls back to static routes, if they are available in the plugin-cfg.xml configuration file. Otherwise, the web server is unable to serve applications.

Resolving The Problem

  2. Create custom properties to resolve the web server start issue.  In the administrative console,  go to Servers > Server types > Web servers > webserver1 > Plug-in properties > Custom properties, and click New. Configure the following custom properties:

    Name: KeyringLocation
    Value: safkeyring:///WASKeyring2048

    Name: StashfileLocation
    Value: ""

    Name: CertLabel
    Value: MSTONE1WASCert2048.BBOC001

    For more information, see the Web server plug-in custom properties section in the WAS documentation.
  3. Generate and propagate the plugin-cfg.xml file. 
  4. Edit the resulting plugin-cfg.xml file to remove the key database file entries under each connector. For example:

    <Connector host="ZWASC022.Z.BIGBIZ.COM" port="47062" protocol="https">
    <!--Property name="keyring" value="/IBMIHS/webserver1/Plugins/config/webserver1/plugin-key.kdb"/-->
    </Connector>

  5. Restart the web server.  An error message displays:
    ERROR: OdrConnector kdb property NOT set, attempting fallback.

    Attempting fallback indicates that the web server uses the new global properties.

[{"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Not Applicable","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"8.5.5","Edition":"Network Deployment","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Not Applicable","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"8.5.5","Edition":"Network Deployment","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21636467

Page Feedback