
Upgrading WebSphere Commerce (runtime) to Java 8
In this task you will upgrade an existing WebSphere Commerce stand-alone runtime environment 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 runtime will be IBM SDK Java Technology Edition Version 8.0 for WebSphere Application Server.
Before you begin
- Consider using the most recent fix pack for WebSphere Commerce. For upgrading WebSphere Commerce 8.0.4.27 to Java 8, see Upgrading WebSphere Commerce (runtime) to WebSphere Application Server bundled Java 8.
- You can only update to use IBM SDK Java Technology Edition
Version 8 if your existing WebSphere Commerce runtime instance is on
WebSphere Commerce 8.0.4.23 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).
-
Warning:
- WebSphere Commerce instance creation is not supported with WebSphere Commerce fix packs that require Java 8 until version 8.0.4.30. If you need to create a new WebSphere Commerce instance, you must use WebSphere Commerce 8.0.4.30 or greater. Alternatively, you can use an older Java 7 fix pack, such as 8.0.4.25, before upgrading to Java 8 and a more recent WebSphere Commerce fix pack.
New instance creation is not supported on IBM i.
Procedure
-
Upgrade your existing WebSphere Application Server to version 8.5.5.18 or
greater.
Note:
- For information about the latest WebSphere Application Server fix packs, see Fix list for IBM WebSphere Application Server V8.5.
- For WebSphere Application Server fix pack installation instructions, see
- Stop all WebSphere Commerce servers.
-
Navigate to the WASInstallDir/bin
directory and run the following commands. Repeat the second command for each
profile that exists.
managesdk.sh -setCommandDefault -sdkname 1.8_64 managesdk.sh -enableProfile -profileName $WASProfileName -sdkName 1.8_64 -enableServers
For example:
managesdk.sh -enableProfile -profileName demo -sdkName 1.8_64 -enableServers managesdk.sh -enableProfile -profileName demo_solr -sdkName 1.8_64 -enableServers
managesdk.bat -setCommandDefault -sdkname 1.8_64 managesdk.bat -enableProfile -profileName $WASProfileName -sdkName 1.8_64 -enableServers
For example:managesdk.bat -enableProfile -profileName demo -sdkName 1.8_64 -enableServers managesdk.bat -enableProfile -profileName demo_solr -sdkName 1.8_64 -enableServers
Where WASProfileName is the name of the profile you are modifying.
Note: You can use the managesdk utility script to enumerate the profiles, and verify their Java version.managesdk.sh -listEnabledProfileAll
managesdk.bat -listEnabledProfileAll
-
Replace the references to Java within your environment.
If you are using WebSphere Commerce version 8.0.4.24 or greater.
- Navigate to the following directory.
WC_installdir/bin/
WC_installdir\bin\
- Run the updateJava8 utility script.
updateJava8.sh
updateJava8.bat
- Navigate to the following directory.
- If you are using WebSphere Commerce version 8.0.4.23.
Manually update the references from
java_1.7_64
tojava_1.8_64
in the following files:- WC_installdir/bin/setenv.sh
- WC_installdir/bin/dbclean.sh
- WC_installdir/bin/di-preprocess.sh
- WC_installdir/bin/configServerEnv.sh
- WC_installdir/bin/createVirtualHosts.sh
- WC_installdir/bin/dataloadenv.sh
- WC_installdir/bin/di-calculateprice.sh
- WC_installdir/bin/di-parallel-process.sh
- WC_installdir/bin/indexpropEnhance.sh
- WC_installdir/bin/migrateListPrice.sh
- WC_installdir/bin/migratePDC.sh
- WC_installdir/bin/migrateSearchFacet.sh
- WC_installdir/bin/seourlkeywordgen.sh
- WC_installdir/bin/webFeedLoad.sh
- WC_installdir/bin/di-buildindex.sh
- WC_installdir/install/wc_default.properties
- WC_installdir/wcbd/deploy/server/wcbd-setenv.bat.template
- WC_installdir/wcbd/deploy/server/wcbd-setenv.template
- WC_installdir/wcbd/wcbd-setenv.bat.template
- WC_installdir/wcbd/wcbd-setenv.template
- WC_installdir\bin\setenv.bat
- WC_installdir\bin\dbclean.bat
- WC_installdir\bin\di-preprocess.bat
- WC_installdir\bin\configServerEnv.bat
- WC_installdir\bin\createVirtualHosts.bat
- WC_installdir\bin\dataloadenv.bat
- WC_installdir\bin\di-calculateprice.bat
- WC_installdir\bin\di-parallel-process.bat
- WC_installdir\bin\indexpropEnhance.bat
- WC_installdir\bin\migrateListPrice.bat
- WC_installdir\bin\migratePDC.bat
- WC_installdir\bin\migrateSearchFacet.bat
- WC_installdir\bin\seourlkeywordgen.bat
- WC_installdir\bin\webFeedLoad.bat
- WC_installdir\bin\di-buildindex.bat
- WC_installdir\install\wc_default.properties
- WC_installdir\wcbd\deploy\server\wcbd-setenv.bat.template
- WC_installdir\wcbd\deploy\server\wcbd-setenv.template
- WC_installdir\wcbd\wcbd-setenv.bat.template
- WC_installdir\wcbd\wcbd-setenv.template
Update the file permissions for the application by running the wcnonroot utility script.
In a command prompt, run the utility:WC_installdir/bin/wcnonroot.sh