PK46489: ON UNIX/LINUX SYSTEMS SET TO ISO-8859-1 LOCALES, INSTALL ROOTS WITH NON-ENGLISH CHARACTERS MAY CAUSE PROFILE CREATION PROBLEMS

Java SDK 1.5 SR8 Cumulative Fix for WebSphere Application Server
Java SDK 1.5 SR8 Cumulative Fix for WebSphere Application Server
Java SDK 1.5 SR10 Cumulative Fix for WebSphere Application Server
6.1.0.31: Java SDK 1.5 SR11 FP1 Cumulative Fix for WebSphere Application Server
6.1.0.33: Java SDK 1.5 SR12 FP1 Cumulative Fix for WebSphere
6.1.0.29: Java SDK 1.5 SR11 Cumulative Fix for WebSphere Application Server
6.1.0.35: Java SDK 1.5 SR12 FP2 Cumulative Fix for WebSphere
6.1.0.37: Java SDK 1.5 SR12 FP3 Cumulative Fix for WebSphere
6.1.0.39: Java SDK 1.5 SR12 FP4 Cumulative Fix for WebSphere Application Server
6.1.0.41: Java SDK 1.5 SR12 FP5 Cumulative Fix for WebSphere Application Server
6.1.0.43: Java SDK 1.5 SR13 Cumulative Fix for WebSphere Application Server
6.1.0.45: Java SDK 1.5 SR14 Cumulative Fix for WebSphere Application Server
6.1.0.47: WebSphere Application Server V6.1 Fix Pack 47
6.1.0.47: Java SDK 1.5 SR16 Cumulative Fix for WebSphere Application Server

APAR status

• Closed as program error.

Error description

• On UNIX/Linux platforms where the locale/character set being
  used by the OS is ISO-8859-1 and non-english characters
  (character codes shared between ISO-8859-1 and UTF-8) were
  used in the install path of WebSphere Application Server, the
  Profile Management tool may have problems in determining free
  space and report insufficient free space back to the user.
  This will fail the creation of a profile.
  
  The error seen by Profile Management Tool is a
  'com.ibm.io.file.exception.FileNotFoundException'.   This
  error occurs because the filepath passed down to the operating
  system was not correctly translated from Java's UTF-8 to the
  native character set being used by the operating system locale
  and as such, the native operating system APIs cannot locate
  the specified file path.
  

Local fix

• Most all current UNIX like operating systems (especially Linux)
  use UTF-8 as the normal character set for all locales.
  Leaving the operating system in the UTF-8 character set locale
  will avoid the problem.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM WebSphere Application Server version 6.1 *
  *                 users on the Linux Operating System          *
  ****************************************************************
  * PROBLEM DESCRIPTION: On UNIX/Linux platforms where the       *
  *                      locale/character set being              *
  *                      used by the Operating System is         *
  *                      ISO-8859-1 and non-English characters   *
  *                      (character codes not shared between     *
  *                      ISO-8859-1 and UTF-8) were              *
  *                      used in the install path of WebSphere   *
  *                      Application Server, the                 *
  *                      Profile Management tool may have        *
  *                      problems in determining free            *
  *                      space and report insufficient free      *
  *                      space back to you.                      *
  *                      This will fail the creation of a        *
  *                      profile.                                *
  ****************************************************************
  * RECOMMENDATION: Most all current UNIX like operating         *
  *                 systems (especially Linux) use UTF-8 as      *
  *                 the normal character set for all locales.    *
  *                 Leaving the operating system in the UTF-8    *
  *                 character set locale will avoid the          *
  *                 problem.                                     *
  ****************************************************************
  On UNIX/Linux platforms where the locale/character set being
  used by the Operating System is ISO-8859-1 and non-English
  characters (character codes not shared between ISO-8859-1 and
  UTF-8) were used in the install path of WebSphere Application
  Server, the Profile Management tool may have problems in
  determining free space and report insufficient free space back
  to you.
  This will fail the creation of a profile.
  
  The error seen by the Profile Management Tool is a
  FileNotFoundException. This error occurs because the filepath
  passed down to the operating system was not correctly
  translated from Java's UTF-8 to the native character set being
  used by the operating system locale and as such, the native
  operating system APIs cannot locate the specified file path.
  

Problem conclusion

• The NativeFile native library was corrected to properly convert
  the non-english characters from UTF-8 to the ISO-8859-1 when
  the operating system is running in that specific codepage.
  This fix has been included in ServicePack 6.1.0.11
  Please refer to the recommended updates page for delivery
  information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  

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

  WEBSPH APP SERV

• Fixed component ID

  5724J0800

Applicable component levels

• R61A PSY

     UP

• R61H PSY

     UP

• R61I PSY

     UP

• R61S PSY

     UP