IC94204: AFTER INSTALLING WEBSPHERE MQ FTE FIXPACK 7.0.4.3 FOR AIX, USERS GET JVMJ9CL005E JVMJ9VM015W AND JVMJ9VM009 ERRORS.

WebSphere MQ File Transfer Edition V7.0 Fix Pack 7.0.4.4

APAR status

• Closed as program error.

Error description

• After installing the WebSphere MQ File Transfer Edition (FTE)
  version 7.0.4.3 fix-pack on AIX, no WebSphere MQ FTE processes
  are able to run. This includes any WebSphere MQ FTE agents
  associated with the installation, commands in the /bin directory
  and the product uninstaller. When attempting to run a
  WebSphere MQ FTE process post fix-pack installation, the
  following errors are returned:
  
  JVMJ9CL005E Incompatible class library version: requires VM v12,
  found v11
  JVMJ9VM015W Initialization error for library jclscar_24(14):
  JVMJ9VM009E J9VMDllMain failed
  Could not create the Java virtual machine.
  
  The WebSphere MQ FTE Installation Log file, named
  "IBM_WebSphere_MQ_File_Transfer_Edition_-_Server_InstallLog.log"
  , also shows multiple "Text file busy" errors such as:
  
  Install File: /opt/IBM/WMQFTE/jre/lib/ppc/j9vm/libjvm.so
  Status: ERROR
  Additional Notes: ERROR - ZeroGlt:
  /opt/IBM/WMQFTE/jre/lib/ppc/j9vm/libjvm.so (Text file busy)
  

Local fix

• There are two local fixes available, one pre and on post
  fix-pack installation.
  
  1) Before running the WebSphere MQ File Transfer Edition
  v7.0.4.3 fix-pack installer to prevent the issue occurring:
  
  Run the "/usr/sbin/slibclean" command. This command removes
  any currently unused modules in kernel and library memory and
  allows the fix-pack installer to correctly update all aspects of
  the JRE shipped with the WebSphere MQ FTE v7.0.4.3 fix-pack.
  
  2) After running the WebSphere MQ File Transfer Edition v7.0.4.3
  fix-pack installer when the issue is occurring:
  
  After the installation of the WebSphere MQ FTE v7.0.4.3 fix-pack
  has completed, the following file is left in the root of the
  product's installation directory:
  pap3260sr12-20121025_01-jre.jar
  This file contains a compressed JRE that WebSphere MQ FTE
  v7.0.4.3 is shipped with. The following instructions detail how
  to use this file to replace the corrupt JRE left after the
  WebSphere MQ FTE v7.0.4.3 fix-pack installation. These
  instructions assume the default installation directory,
  "/opt/IBM/WMQFTE" is used.
  
  1) run the "slibclean" AIX command.
  2) Make a backup of the existing "jre" directory, located in
  the product's installation directory:
  mv /opt/IBM/WMQFTE/jre /opt/IBM/WMQFTE/jre_backup
  3) Create a temporary directory to which the file
  pap3260sr12-20121025_01-jre.jar will be extracted and
  change to that directory.
  mkdir /tmp/fte_7043_jre
  cd /tmp/fte_7043_jre
  4) Extract pap3260sr12-20121025_01-jre.jar into this
  directory:
  jar -xvf /opt/IBM/WMQFTE/pap3260sr12-20121025_01-jre.jar
  5) Move the "jre" directory just extracted into the WebSphere
  MQ FTE product installation directory:
  mv /tmp/fte_7043_jre/jre /opt/IBM/WMQFTE/jre
  6) Ensure the owner and group of the new "jre" directory
  matches that of the existing files and directories of the
  WebSphere MQ FTE product install.
  7) Set the file permissions on the new "jre" directory,
  sub-files and sub-directories to have th numeric value 0775:
  chmod -R 0775 /opt/IBM/WMQFTE/jre
  8) Copy the "notices.txt" file from the extracted JRE into
  the new JRE directory:
  cp /tmp/fte_7043_jre/notices.txt /opt/IBM/WMQFTE/jre/notices.txt
  9) Copy the "copyright" file from the backup JRE directory
  into the new JRE directory:
  cp /opt/IBM/WMQFTE/jre_backup/copyright
  /opt/IBM/WMQFTE/jre/copyright
  
  The JRE used by WebSphere MQ FTE v7.0.4.3 has now been replaced
  with a working, non-corrupt JRE. To test the process has
  worked, try running a WebSphere MQ FTE command such as
  "fteDisplayVersion" which will produce the following output:
  
  # /opt/IBM/WMQFTE/bin/fteDisplayVersion
  5655-U80, 5724-R10 Copyright IBM Corp. 2008, 2011. ALL RIGHTS
  RESERVED
  Name: WebSphere MQ File Transfer Edition Server
  Version: 7.0.4.3
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects all users upgrading a WebSphere MQ File
  Transfer Edition installation with the version 7.0.4.3
  fix-pack on AIX.
  
  
  Platforms affected:
  AIX
  
  ****************************************************************
  PROBLEM SUMMARY:
  AIX caches libraries recently used by running processes, such as
  those used by the JRE used to run WebSphere MQ File Transfer
  Edition (FTE) processes. As a result, when running the WebSphere
  MQ FTE v7.0.4.3 fix-pack installer, the installer was unable
  to update all aspects of the JRE. This resulted in a corrupt JRE
  installation with mixed library versions that in turn, prevented
  the JVM from initialising when attempting to start a WebSphere
  MQ FTE process.
  

Problem conclusion

• The WebSphere MQ File Transfer Edition (FTE) fix-pack
  installer has been updated to attempt to execute the
  "/usr/sbin/slibclean" command prior to updating any WebSphere MQ
  FTE installation files. This command performs privileged
  operation and only privileged users can run privileged
  operations.
  
  As such, if the installer is unable to successfully execute
  the "/usr/sbin/slibclean" command, a warning message is
  displayed to the user and provides them with the choice of
  either continuing, if they have previously run the
  "/usr/sbin/slibclean" command, or exiting the fix-pack installer
  without making any changes to the current WebSphere MQ FTE
  installation.
  
  
  | MDVREGR 7.0.4-WS-MQFTE-JavaVM-FP003-AIX_ppc |
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.0       7.0.4.4
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

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

  WMQ FILE TRANSF

• Fixed component ID

  5724R1000

Applicable component levels

• R704 PSY

     UP