IT34002: IBM MQ adding/removing features from a Windows installation can damage the Web Console installation.

APAR status

• Closed as program error.

Error description

• If one removes certain components from a Windows 9.1 LTS
  installation (e.g., MFT), this can make the web console
  unusable.
  

Local fix

• MQ v9.1 - Uninstall and reinstall the web feature or look to
  modify Installation again, but do not change anything.  This
  should put back the WebConsole/REST API binary files.
  MQ v9.2 - Uninstall and reinstall the web feature or look to
  update the file <MQ_program_directory>\web\etc\server.env reads:
  
  ########
  # comment block
  ########
  WLP_SKIP_UMASK=true
  
  and needs to have two lines added at the end:
  
  JAVA_HOME=<MQ_program_directory>\java\jre
  WLP_USER_DIR=<MQ_data_directory>\MQ\web\installations\<MQ_instal
  lation_name>
  
  eg.  The file contents need to look like:
  ########
  # comment block
  ########
  WLP_SKIP_UMASK=true
  JAVA_HOME=C:\Program Files\IBM\MQ\java\jre
  WLP_USER_DIR=C:\ProgramData\IBM\MQ\web\installations\Installatio
  n1
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of the IBM MQ on Windows and if they
  are modifying an existing installation adding/removing features
  from the installation.
  
  
  Platforms affected:
  Windows
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  If you install MQ Server on Windows, and then look to modify the
  installation by adding/removing features. The result is that the
  MQ WebConsole binary files are removed or will no longer run.
  
  eg.
  
  C:\dspmqweb
  'dspmqweb' is not recognized as an internal or external command,
  operable program or batch file.
  
  or
  
  C:\dspmqweb
  '"java"' is not recognized as an internal or external command,
  operable program or batch file.
  "java"
  '"java"' is not recognized as an internal or external command,
  operable program or batch file.
  "java"
  

Problem conclusion

• The Installation process has been updated to prevent the Web
  Console binary files being removed or them being unable to run
  after modifying an existing installation adding/removing
  features from the installation.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 LTS   9.1.0.7
  v9.2 LTS   9.2.0.2
  
  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

  IBM MQ BASE MP

• Fixed component ID

  5724H7271

Applicable component levels