PI19435: IN WORKLIGHT STUDIO, THE WORKLIGHT APPLICATION FRAMEWORK MAY USE WRONG IP ADDRESS FOR INTERNAL DOJO LIBRARY

Download for IBM Worklight V6.1.0 Fix Pack 2
Download for IBM Worklight V6.2.0 Fix Pack 1

APAR status

• Closed as program error.

Error description

• The Worklight Application Framework will use an
  internal server to serve Dojo resources from a Dojo library
  project
  if such a project is included in the application.  The
  Framework will reference this internal server by IP address,
  and will choose the first IP address it finds on the system.
  This may not correspond to an IP address or network interface
  that is actually operational, for example, when the system has
  multiple network
  interfaces.
  

Local fix

• There are two possible workarounds:
  
  1)  Place Dojo directly into the application, rather than using
  the
  Dojo library project provided by the Worklight Application
  Framework
  
  2)  Unzip the ".wlapp" file generated by the
  application, modify the application's index.html file to
  reference Dojo via a relative path rather than through the Dojo
  library project, then ZIP the project to create a new
  ".wlapp" file to be deployed to the Worklight Server.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Worklight developers creating Dojo-enabled hybrid            *
  * applications on systems with multiple network interfaces.    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * With systems that have multiple network interfaces, the      *
  * tooling might use an inactive IP address when trying to      *
  * access the Dojo Library Server. If this occurs, Dojo         *
  * functionality within hybrid applications that need the Dojo  *
  * Library Server will not work.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * -                                                            *
  ****************************************************************
  

Problem conclusion

• The code has been modified such that it can be provided a
  hostname to use instead of the code picking an IP address for
  the host. After installing the fix, the user can optionally
  provide a hostname in the Worklight Studio > Dojo Library
  preference page. In addition to accepting the hostname, a full
  or partial IP address can be given. In the case of a partial IP
  address, the code will find an IP address among all network
  interfaces that matches.
  

Temporary fix

Comments

APAR Information

• 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

  WORKLIGHT CONSU

• Fixed component ID

  5725I4301

Applicable component levels

• R600 PSY

     UP

• R610 PSY

     UP

• R620 PSY

     UP