JR54184: MIGRATION FROM WPS 6.2 TO BPM 8.5.5 SHOULD COVER THE WAS PRE-PLATFORM SCAN ENABLEMENT.

8.5.5.0-WS-BPM-IFJR54184
Version 8.5 Refresh Pack 7 for the IBM Business Process Manager products

APAR status

• Closed as program error.

Error description

• After migration from WPS 6.2 to BPM 8.5.5 Advanced, web service
  application cannot be run successfully.
  Client tried to hit the application url in the browser and got
  the  error.
  Error: 404 javax.servlet.UnavailableException: SRVE0201E:
  Servlet [sca.webservice.provider.XXXXXXXXXXXXX]: not
  a servlet class
  Client tried to login to WAS admin console and found that the
  Service providers/ Listeners are not in the started state.
  When attempted to start the listener, we get the message "The
  specified application module does not contain any web service"
  Also client is unable to view the wsdl document, getting error
  "WSWS4004E: The wsdl-file for module
  XXX_XXXX_XX_0_0Web.war was not found in the
  module."
  

Local fix

• 1. Uninstall the "bad" application from target environment.
  2. Update the ear file extracted from source environment as
  below:
     - Locate two META-INF/MANIFEST.MF files; one is under ear
  folder,  another is under war package.
     - Add the property UseWSFEP61ScanPolicy to true in the
     META-INF/MANIFEST.MF of a WAR file or EJB module to true.
     - For example:
          Manifest-Version: 1.0
          UseWSFEP61ScanPolicy: true
  3. Manually install the application(s) to target environment.
  

Problem summary

• This issue occurs because the default behavior for IBM WebSphere
  Application Server V7.0 and later releases is to not scan
  pre-Java EE 5 modules for annotations while installing an
  application or starting the server. For more information, see
  "JAX-WS annotations"
  (http://www.ibm.com/support/knowledgecenter/SSAW57_8.5.5/com.ibm
  .websphere.nd.doc/ae/rwbs_jaxwsannotations.html?lang=en)
  

Problem conclusion

• A fix is available for IBM BPM V8.5.5.0 that sets
  UseWSFEP61ScanPolicy property to "true" in the
  META-INF/MANIFEST.MF file of a WAR file or EJB module of an EAR
  file.
  
  On Fix Central (http://www.ibm.com/support/fixcentral), search
  for JR54184:
  
  1. Select the IBM Business Process Manager with your edition
  from the product selector, the installed version to the fix pack
  level, and your platform, and click Continue.
  2. Select APAR or SPR, enter JR54184, and click Continue.
  
  When you download fix packages, also download the readme file
  for each fix. Review each readme file for additional
  installation instructions and information about the fix.
  

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

  BPM ADVANCED

• Fixed component ID

  5725C9400

Applicable component levels

• R855 PSY

     UP