PI31801: HTTP 500 ERROR MENTIONING DMH.KEYSTORE IS DISPLAYED AFTER UPGRADING RAAZ TO 6.1.0.6 LEVEL.

readme.htm
RAAzInstallRepository
RAAzInstall
Rational Asset Analyzer for System z Fix Pack 7 (6.1.0.7) for 6.1
Rational Asset Analyzer for System z Fix Pack 8 (6.1.0.8) for 6.1
Rational Asset Analyzer for System z Fix Pack 9 (6.1.0.9) for 6.1
Rational Asset Analyzer for System z Fix Pack 10 (6.1.0.10) for 6.1
Rational Asset Analyzer for System z Fix Pack 11 (6.1.0.11) for 6.1
Rational Asset Analyzer for System z Fix Pack 12 (6.1.0.12) for 6.1
Rational Asset Analyzer for System z Fix Pack 13 (6.1.0.13) for 6.1
Rational Asset Analyzer for System z Fix Pack 14 (6.1.0.14) for 6.1
Rational Asset Analyzer for System z Fix Pack 15 (6.1.0.15) for 6.1
Rational Asset Analyzer for System z Fix Pack 16 (6.1.0.16) for 6.1
Rational Asset Analyzer for System z Fix Pack 17 (6.1.0.17) for 6.1
Rational Asset Analyzer for System z Fix Pack 18 (6.1.0.18) for 6.1
Rational Asset Analyzer for System z Fix Pack 19 (6.1.0.19) for 6.1
Rational Asset Analyzer for System z Fix Pack 20 (6.1.0.20) for 6.1
Rational Asset Analyzer for System z Fix Pack 21 (6.1.0.21) for 6.1
Rational Asset Analyzer for System z Fix Pack 22 (6.1.0.22) for 6.1
Rational Asset Analyzer for System z Fix Pack 23 (6.1.0.23) for 6.1

APAR status

• Closed as documentation error.

Error description

• When attempting to access RAAz after installing or upgrading to
  6.1.0.6, user receives message similar to:
  Error 500: com.ibm.dmh.cfgmgr.ConfigRuntimeException:
  ConfigRuntimeException: Unexpected exception caught in
  ConfigMgr.getConfigFile(Common.cfg):
  msg=[ConfigRuntimeException: Errors occurred while trying to
  load config file [Common.cfg]. [1] - ConfigRuntimeException:
  Could not encode value for prop [password] at line [137] of
  [Common.cfg]. Msg=[java.io.FileNotFoundException:
  <path>/dmh/dmh.keystore
  

Local fix

• Page 23 of the RAAz Installation Guide could be updated with:
  
  When you provide the DB2 user ID and password on the ISPF setup
  panel, they are saved in the user Common.cfg file. When the
  application server is started, the Rational Asset Analyzer for
  System z servlet encrypts any password stored in the Common.cfg
  file. To encrypt those passwords, it may create or update a
  dmh.keystore file. Therefore, the user ID for the application
  server must have the proper authority to update the Common.cfg
  file and to create or update a dmh.keystore file.
  
  To allow the application server to write to these files, you
  can change the permissions for the directory and files by
  making the ID under which the application server runs be the
  owner of the HFS configuration directory and files. For example:
  
  find /etc/dmh -name '*' | xargs -i chown
  WebSphere-Application-Server-userid '{}'
  
  You must also ensure that WebSphere-Application-Server-userid
  has the authority to read any parent directories of the HFS
  configuration directory.
  

Problem summary

• RAAz Installation Guide didn't have updates related to enhanced
  security features related to passwords.
  

Problem conclusion

• Documentation was updated, and planned to be available in same
  timeframe as PTF for RAAz 6.1.0.7.
  

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

Applicable component levels