IBM Support

IT14134: GREP ERROR REPORTED WHEN INSTALLING IBM MQ v8.0.0.4 ON SOLARIS

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When installing IBM MQ 8.0.0.4 on Solaris, the following output
    is seen:
    
    ========================================================
    Agreement accepted: Proceed with install.
    Licensed Materials - Property of IBM
     5724-H72
     (C) Copyright IBM Corporation 1994, 2015
    US Government Users Restricted Rights - Use, duplication or
    disclosure
    restricted by GSA ADP Schedule Contract with IBM Corp.
    grep: illegal option -- F
    grep: illegal option -- F
    Usage: grep -hblcnsviw pattern file . . .
    Usage: grep -hblcnsviw pattern file . . .
    ### Installing runtime license
    ========================================================
    
    The install then completes successfully despite the reported
    error from the "grep" command
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users installing IBM MQ 8.0.0.4 packages on
    the Solaris platform.
    
    
    Platforms affected:
    Solaris x86-64, Solaris SPARC
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    APAR IT10662 introduced additional checks to determine if the
    installation location for MQ was empty.  This check was
    performed using the "grep" command in combination with the '-F'
    argument:
    
      grep -F
    
    which is not a valid option on Solaris when using the default
    the version of grep found in "/usr/bin".
    
    If the path was configured such that this version of grep
    ("/usr/bin/grep") was invoked when performing this check during
    installation, the following error messages were reported to
    standard error:
    
    grep: illegal option -- F
    grep: illegal option -- F
    Usage: grep -hblcnsviw pattern file . . .
    Usage: grep -hblcnsviw pattern file . . .
    
    and the installation proceeded.  The effect of this code defect
    was that even if the directory was not empty, the installation
    scripts would not abort the installation.
    

Problem conclusion

  • While the Solaris binary "/usr/xpg4/bin/grep" does support the
    '-F' option, this binary is not guaranteed to be available on
    every Solaris system.  To resolve the problem therefore, the
    Solaris installation scripts have been updated such that the
    '-F' flag is not used.
    
    One consequence of this is that the optional environment
    variable introduced by APAR IT10662:
    
      AMQ_IGNORE_SNAPDIRNAME
    
    is now treated as a regular expression during installaton - ON
    SOLARIS ONLY.
    
    For example, if the following commands are used prior to
    installation:
    
    AMQ_IGNORE_SNAPDIRNAME=".*myfile"
    export AMQ_IGNORE_SNAPDIRNAME
    
    any files located in the chosen installation directory which
    match this as a regular expression will be ignored by the
    installation scripts.  This means that if the following files
    are present in the chosen installation directory of "/opt/mqm"
    the installation will proceed regardless of the fact that the
    installation directory is not empty:
    
      /opt/mqm/a_myfile
      /opt/mqm/b_myfile
      /opt/mqm/myfile_c
    
    
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.5
    
    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

    IT14134

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-03-04

  • Closed date

    2016-04-19

  • Last modified date

    2016-05-04

  • 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 BASE MULTIP

  • Fixed component ID

    5724H7251

Applicable component levels

  • R800 PSY

       UP

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

Document Information

Modified date:
04 May 2016