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

Ensure that you are planning on upgrading to the latest WebSphere Commerce fix pack. If you are using an older version of WebSphere Commerce Developer, see the previous version of this topic Upgrading WebSphere Commerce Developer to Java 8.


  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 the command default to use the bundled Java version 8.0 SDK.
        WASInstallDir\bin\managesdk.bat -setCommandDefault -sdkname 1.8_64_bundled
      2. Set any newly created profiles to default to use the bundled Java version 8.0 SDK.
        WASInstallDir\bin\managesdk.bat -setNewProfileDefault -sdkname 1.8_64_bundled
      3. Set your existing profile to use the bundled Java version 8.0 SDK.
        WASInstallDir\bin\managesdk.bat -enableProfile -profileName profileName -sdkName 1.8_64_bundled

        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_bundled
  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.
    1. Navigate to the WC_installdir\bin\ directory.
    2. Run the updateJava8.bat utility script.


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.