IBM Support

PI41464: ENDPOINT DETECTION OF THE ADMINISTRATION SERVICE CAN FAIL IN WAS ND BECAUSE A WRONG VIRTUAL HOST IS DETECTED

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The Worklight runtime is not initialized  because it cannot
    invoke the administration service when it starts
    

Local fix

  • 1) Add the http and https port numbers of the WAS servers in the
    'default_host' virtual host in order that the automatic endpoint
    detection works.
    2) Define manually the endpoint on the JVM of each server.
    In the WAS console click Servers > Server Types > WebSphere
    application servers > server_name, and then, under Server
    Infrastructure, click Java and process management > Process
    definition > Java virtual machine > Custom properties
    Add the 3 following properties :
    
    ibm.worklight.admin.proxy.protocol value : http (or https)
    ibm.worklight.admin.proxy.host value : hostname of this cluster
    member
    ibm.worklight.admin.proxy.port value : http or https port number
    of this cluster member
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * MFP console users                                            *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * The automatic endpoint detection of the Worklight            *
    * administration service can fail in WebSphere ND because it   *
    * doesn't take correctly the virtual host associated with the  *
    * administration service application.                          *
    *                                                              *
    * When the virtual host mapping is changed after the           *
    * application deployment the ibm-web-bnd.xml file of the war   *
    * file deployed inside the profiles/<profile                   *
    * name>/installedApps directory is not updated. What is        *
    * updated is another ibm-web-bnd.xml file that is deployed in  *
    * the profiles/<profile name/config/cells/<cell                *
    * name>/applications/<worklightadmin ear                       *
    * file>/deployments/<worklightadmin war>/<worklightadmin war   *
    * file>/WEB-INF directory and so the automatic endpoint        *
    * detection of the Worklight administration service fails      *
    * since it uses the virtual host mapped during the deployment. *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * -                                                            *
    ****************************************************************
    

Problem conclusion

  • The right virtual host mapping is fetched by using JMX and the
    WAS admin MBeans.
    
    Important : it requires that the WAS admin credentials be set in
    the ibm.worklight.admin.jmx.user and ibm.worklight.admin.jmx.pwd
    JNDI properties associated with the Administration Services
    application since the WAS admin MBeans are secured.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI41464

  • Reported component name

    WL/MFPF CONSUME

  • Reported component ID

    5725I4301

  • Reported release

    620

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2015-05-20

  • Closed date

    2015-10-21

  • Last modified date

    2015-10-21

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    WL/MFPF CONSUME

  • Fixed component ID

    5725I4301

Applicable component levels

  • R620 PSY

       UP

  • R630 PSY

       UP

  • R700 PSY

       UP

  • R710 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSZH4A","label":"IBM Worklight"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"620","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
14 October 2021