WebSphere Commerce Version or later

Upgrading WebSphere Commerce Developer to Java 8

In this task you will upgrade an existing WebSphere Commerce Developer to use Java 8. Upgrading to a newer version of Java and WebSphere Application Server will allow you to ensure compatibility and continue receiving product support. The specific version of Java that is run on your SDK will be IBM SDK Java Technology Edition Version 8.0 for WebSphere Application Server.

Before you begin

  • You can only update to use IBM SDK Java Technology Edition Version 8 if your existing WebSphere Commerce runtime instance is on WebSphere Commerce or greater. For information about installing fix packs, see Installing maintenance for WebSphere Commerce.
    Note: If you have already upgraded your environment to Java 8 before installing this fix pack, you must update the references to Java in your utilities after applying the fix pack (Step 6).


  1. Upgrade your existing WebSphere Application Server to version or greater.
  2. Change the WebSphere Application Server profile in your WebSphere Commerce Developer environment to use the new Java version.
    1. Stop the WebSphere Commerce Test Server.
    2. Obtain the WebSphere Application Server Profile name. Open the WCDEInstallDir\wasprofile\logs\AboutThisProfile.txt text file and locate the name. For example, WCDE_E~1_145207.
    3. In a command prompt, run the following commands:
      1. Set your existing profile to use the Java version 8.0 SDK.
        WASInstallDir\bin\managesdk.bat -enableProfile -profileName profileName -sdkName 1.8_64

        Where profileName is the profile name from the previous step.

        For example:
        W:\WebSphere\AppServer\bin\managesdk.bat -enableProfile -profileName WCDE_E~1_145207 -sdkName 1.8_64
  3. Update the WebSphere Commerce Test Server runtime environment.
    1. Start WebSphere Commerce Developer.
    2. Open Window > Preferences.
    3. On the list of preferences, open Server > Runtime Environments.
    4. Select WebSphere Commerce Runtime and click Edit. A window is displayed.
    5. Change the JRE for the runtime environment to WebSphere Application Server traditional JRE 1.8. The location of the JRE is WASInstallDir\java\jre
    6. Click Finish.
    • If a warning is displayed about migrating your project facets to Java 1.8:
      1. Click yes to accept and migrate your project facets automatically.
    • If a migration warning is not displayed, you must migrate your project facets to Java 1.8 manually. For each project in your workspace:
      1. Open the WCDE_installdir\workspace\projectname\.setting\org.eclipse.wst.common.project.facet.core.xml file for editing, where projectname is the folder specific to each project.
      2. Find and replace the reference:
        <installed facet="jst.java" version="1.7"/>
        <installed facet="jst.java" version="1.8"/>
      3. Save the file.
  4. Restart and then republish the WebSphere Commerce Server and Search server applications.
  5. Replace the references to Java within your environment.
    • WebSphere Commerce Version or laterIf you are using WebSphere Commerce Developer version or greater.
      1. Navigate to the WC_installdir\bin\ directory.
      2. Run the updateJava8.bat utility script.
      3. WebSphere Commerce Version you are using WebSphere Commerce Developer version, you must manually edit the setenv.bat utility script. This is not required to be done on,, or any subsequent fix packs.
        1. Navigate to the WC_installdir\bin\ directory.
        2. Open the setenv.bat utility script file for editing.
        3. Locate and replace the following two lines in the utility script:
          1. Replace this line:
            for /d %%i in ("%WED_HOME%\rcp\eclipse\plugins\com.ibm.rcp.base_
            With the following line:
            for /d %%i in ("%WED_HOME%\rcp\eclipse\plugins\com.ibm.rcp.base_*") do set RCP_BASE=%%i
          2. Replace this line:
            for /d %%i in ("%WED_HOME%\rcp\eclipse\plugins\com.ibm.rcp.j2se.win32.x86_
            With the following line:
            for /d %%i in ("%WED_HOME%\rcp\eclipse\plugins\com.ibm.rcp.j2se.win32.x86_*") do set RCP_JRE=%%i\jre
        4. Save and close the file.
    • If you are using WebSphere Commerce Developer version

      Manually update the references from java_1.7_64 to java_1.8_64 in the following files:

      • WCDE_installdir\bin\setenv.bat
      • WCDE_installdir\setup\setup.xml
      • WCDE_installdir\install\wc_default.properties
      • WCDE_installdir\wcbd\deploy\server\wcbd-setenv.bat.template
      • WCDE_installdir\wcbd\deploy\server\wcbd-setenv.template
      • WCDE_installdir\wcbd\wcbd-setenv.bat.template
      • WCDE_installdir\wcbd\wcbd-setenv.template


Your programming environment is upgraded to use Java 1.8 on a newer version of WebSphere Application Server. This version of Java and WebSphere Application Server ensures continued product support.
Restriction: If you want to restore your development environment to default through the use of the restoreDefault.bat utility script, you must first reverse the process completed in Step 6. Once you have restored your environment to default, you can once again upgrade to Java 1.8 by following this task.