IBM Support

PI55136: WASPREUGRADE JAVA.IO.IOEXCEPTION WHEN VARIABLE HAS ":" AND -MACHINECHANGE IS SET TO TRUE

Fixes are available

8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • This only happens on Microsoft Windows operating systems for
WASPreUpgrade with -machineChange true because migration needs
to determine the correct case of all paths.  This case
sensitivity becomes important in case WebSphere Application
Server is being  migrated to a Unix operating system. Thus
migration does some extra processing of variables with
paths and  thus this particular corner case where a variable
has a ":" value causes the entire variable set to not get
loaded correctly.

Local fix

  • Before running WASPreUpgrade, open the admin console and find
that variable and temporarily set it to a value without the
":".
This will cleanup the
  java.io.IOException: The filename, directory name, or volume
label syntax is incorrect.
from the log files.

It will also allow all the other variables to be resolved
correctly.
Thus allowing the migration code to process all the paths
correctly.

Once the WASPostUpgrade has completed, you can open the new
admin console and switch this variable back to having a value
of ":".

Problem summary

  • ****************************************************************
* USERS AFFECTED:  All users of IBM WebSphere Application      *
*                  Server WASPreUpgrade command running on     *
*                  Microsoft Windows and migrating to another  *
*                  machine.                                    *
****************************************************************
* PROBLEM DESCRIPTION: Common variables are not being          *
*                      resolved correctly, causing the         *
*                      migration to not process paths          *
*                      properly.                               *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Microsoft Windows processed all variables as if they are
paths. Whenever the value of the variable has a ":" not as the
second character migration fails to process all the other
variable values correctly.  This is causing faulty path
look-ups to occur when running WASPreUpgrade on Microsoft
Windows with the -machineChange true option.

Problem conclusion

  • Running WASPreUpgrade on Microsoft Windows with the
-machineChange true option causes an extra lookup on variable
values, in order to preserve the exact case of paths when
migrating to another machine. However, when a variable's
value has a ":" character that is not in the second position,
Microsoft Windows throws the java.io.exception.  This causes
the rest of the variables to not get processed, thus causing
problems finding correct paths to files and directories.

Code has been corrected to handle variable values which contain
a ":" not in the second position.
The fix for this APAR is currently targeted for inclusion in
fix pack 8.5.5.10.  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 number
    PI55136
    • 

  • Reported component name
    WEBS APP SERV N
    • 

  • Reported component ID
    5724H8800
    • 

  • Reported release
    850
    • 

  • Status
    CLOSED  PER
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    NoSpecatt / Xsystem
    • 

  • Submitted date
    2016-01-11
    • 

  • Closed date
    2016-03-07
    • 

  • Last modified date
    2016-03-07
    • 





    

  • 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
    WEBS APP SERV N
    • 

  • Fixed component ID
    5724H8800
    • 



Applicable component levels


    

  • R850  PSY
       UP
    • 








      
              
                            

              

              [{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.5","Line of Business":{"code":"LOB45","label":"Automation"}}]
              

                          

          
 
        

      

    

      

        

          

            
Document Information


            

            


                        

            Modified date:
            

            11 January 2022
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback