IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IC94204

  • Reported component name

    WMQ FILE TRANSF

  • Reported component ID

    5724R1000

  • Reported release

    704

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-07-17

  • Closed date

    2013-09-10

  • Last modified date

    2013-11-27

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEP7X","label":"WebSphere MQ File Transfer Edition"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.4","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
27 November 2013