Step by step process to install HCL Commerce v9.1.11. There are many steps necessary to successfully install the toolkit. It is important to do them in order and don't skip any steps.

1. HCL COMMERCE DEVELOPER V9.1.11
FRANCIS BOOTH, 11/09/2022

2. ● IBM Rational Application Developer for WebSphere Software, Version 9.6
○ CIY03ML.zip
○ CNG4RML.zip
○ CNG4SML.zip
○ CNG4TML.zip
○ CNG4VML.zip
IBM RAD 9.6 Installation Files

3. IBM RAD 9.6 Installation Preparation
Unzip the CIY03ML.zip, CNG4RML.zip, CNG4SML.zip, CNG4TML.zip, CNG4VML.zip) and the rest of the zip files
to an installation folder.
Add the CNG4RMLRAD_SETUPrepository.config to the Installation Manager Repositories List
Click OK

4. IBM RAD 9.6 Installation
Click the Install on Installation Manager

5. IBM RAD 9.6 Installation
Select the IBM RAD for WebSphere -> Version 9.6 Installation
Click Next

6. IBM RAD 9.6 Installation
Turn off Anti-Virus Software
Click Next

7. IBM RAD 9.6 Installation
Set the Shared Resources Directory: C:IBMIBMIMShared
Set the Installation Directory: C:IBMSDP-9.6
Click Next

8. IBM RAD 9.6 Installation
Select Languages / Translations to install
Click Next

9. IBM RAD 9.6 Installation
Select Enterprise developer tools -> Data access and XML
Click Next

10. IBM RAD 9.6 Installation
Notification of installation disks required
Click Install
Prompts will Come up for…
DISK 1 - ~CNG4SMLRADdisk1
DISK 2 - ~CNG4TMLRADdisk2
Click Install

11. IBM RAD 9.6 Installation
Packages successfully installed
Don’t start any programs - click the None radio button
Click Finish

12. IBM RAD 9.6 License Installation
Click Manage Licenses

13. IBM RAD 9.6 License Installation
Select the Import Activation Kit Radio Button
Click Next

14. IBM RAD 9.6 License Installation
Repository: ~/CNG4VML/RAD_AK/RAD96_Lic.jar
Click Next

15. IBM RAD 9.6 License Installation
Accept the License
Click Finish

16. IBM RAD 9.6 License Installation
Click Finish

17. ● IBM WebSphere Application Server and IBM Java SDK 8 - Sign into IBM
○ http://www.ibm.com/software/repositorymanager/V9WASBase
IBM WAS & JDK V8 Installation Files

18. ● Click Install on Installation Manager
● Select IBM WebSphere Application Server 9.0.5.13
○ and dependent IBM SDK v 8.0.7.16
Click Next
IBM WAS & JDK V8 Installation Files

19. ● Install Packages
Click Next
IBM WAS & JDK V8 Installation

20. ● Accept Licenses
Click Next
IBM WAS & JDK V8 Installation

21. ● Installation Directory: C:WebSphereAppServer
Click Next
IBM WAS & JDK V8 Installation

22. ● Installation Directory: C:WebSphereAppServer
Click Next
IBM WAS & JDK V8 Installation

23. Click Next
IBM WAS & JDK V8 Installation

24. Click Next
IBM WAS & JDK V8 Installation

25. ● Click Install
IBM WAS & JDK V8 Installation

26. ● Click the None Radio Button
● Click Finish
IBM WAS & JDK V8 Installation

27. ● Repositories
○ CNPY1MLLiberty_17002_IMrepository.config
○ 22.0.0.6-WS-LIBERTY-BASE-FPrepository.config
● Click Apply
IBM WebSphere Liberty

28. ● Select WebSphere Liberty V8.5.5 Version 22.0.0.6
● Click Next
IBM WebSphere Liberty

29. ● Accept the Licenses
● Click Install
IBM WebSphere Liberty

30. ● Installation Directory: C:WebSphereLiberty
● Click Next
IBM WebSphere Liberty

31. ● Click the Recommend radio Button
● Click the Custom and load the Liberty Plugins
● Add the Java EE 7 Web Profile Bundle ← IMPORTANT!!!!
● Click Next
IBM WebSphere Liberty Java EE7 PACKAGE

32. ● Click Next
IBM WebSphere Liberty

33. ● Click Install
IBM WebSphere Liberty

34. ● Click Finish
IBM WebSphere Liberty

35. ● Repositories
○ HCL_Commerce_Enterprise_V9.1.11.0_Developerrepository.config
● Click Apply
HCL Commerce Developer v9.1.11

36. ● Select HCL Commerce Developer V9.1.11.0
● Click Next
HCL Commerce Developer v9.1.11

37. ● Accept License
● Click Install
HCL Commerce Developer v9.1.11

38. ● Accept License
● Click Install
HCL Commerce Developer v9.1.11

39. ● Select English
● Click Next
HCL Commerce Developer v9.1.11

40. ● Select Enterprise
● Click Next
HCL Commerce Developer v9.1.11

41. ● Install Packages
● Click Install
HCL Commerce Developer v9.1.11

42. ● 99% applyUpdate.bat takes forever ( for some reason mine ran overnight, even though the vm has 4 cores
and 32 GB RAM)
HCL Commerce Developer v9.1.11

43. ● Finally
● Click Finish
HCL Commerce Developer v9.1.11

44. ● Options - DB2 Natively or in Docker
○ DB2 V11.5 Installation -
■ https://www.ibm.com/account/reg/us-en/signup?formid=urx-33669
■ https://help.hcltechsw.com/commerce/9.1.0/install/tasks/tiginstalldb2.html
○ Or use the DB2 Docker instance - HCL_Commerce_Enterprise_9.1.11.0_DB2_Server_x86-64.tgz
■ https://help.hcltechsw.com/commerce/9.1.0/install/tasks/tigusedb2docker_dev.html
IBM Db2 Database Installation

45. ● Create a database windows user (dbuser). For example, wcs.
● Using the “DB2 Command Window - Administrator” goto C:WCDE_V9bin
● C:WCDE_V9bin>create_database_db2.bat COMMERCE db2admin 'Passw0rd!' wcs
● Database creation will take several minutes. Follow its progress in "createdb.db2.log".
Preparing an IBM Db2 Database

46. ● C:WCDE_V9bin>initdb_db2_sample.bat production COMMERCE localhost 50000 db2admin Passw0rd!
wcs wcs1 1a1a1a1a1a1a1a1a2b2b2b2b2b2b2b2b wcsadminSalt1 wcsadminPwd1 spiuserSalt1
abcdefghijklmnopqrstuvwqyzabcdefghijklmnopqrs sampleData opt/utilities/config/keystore.jks hclkey
Installing an Sample Schema and Data

47. ● C:WCDE_V9bin>setSpiuserPassword abcdefghijklmnopqrstuvwqyzabcdefghijklmnopqrs
Updating spiuser password in transaction server ...
Successfully updated spiuser password in transaction server server.xml.
Updating spiuser password in search server jvm.options ...
Successfully updated spiuser password in search server jvm.options.
Updating password in search server userregistry.xml ...
Successfully updated password in search server userregistry.xml.
Updating spiuser password in store server jvm.options ...
Successfully updated spiuser password in store server jvm.options.
Updating password in commerce server userregistry.xml ...
Successfully updated password in commerce server userregistry.xml.
● db2: select salt from userreg where logonid='spiuser'; RESULT: spiuserSalt1
● C:WCDE_V9bin>wcs_password.bat abcdefghijklmnopqrstuvwqyzabcdefghijklmnopqrs spiuserSalt1
1a1a1a1a1a1a1a1a2b2b2b2b2b2b2b2b
Licensed Materials - Property of HCL Technologies
HCL Commerce
(C) Copyright HCL Technologies Limited 1996, 2020
=== Encrypted Password ===
ASCII Format: kWjpG9SwUvQ+yZhwuJXigof746H/G8umEQ/3RAEbm4psS9CyNKI85e5xLwZdjE/xDfQY9U25YrlJdT/N68caJg==
Hex Format:
6B576A70473953775576512B795A6877754A5869676F66373436482F4738756D45512F33524145626D347073533943794E4B4938356535784C775A646A452F78446651593955323559726C4A64542F4E3638
63614A673D3D
● db2: update userreg set
logonpassword=x'6B576A70473953775576512B795A6877754A5869676F66373436482F4738756D45512F33524145626D347
073533943794E4B4938356535784C775A646A452F78446651593955323559726C4A64542F4E363863614A673D3D' where
logonid = 'spiuser';
Setting the spiuser Password

48. ● C:WCDE_V9bin>setdbtype.bat db2 IBMSQLLIB COMMERCE db2admin Passw0rd! wcs wcs1 localhost 50000
1 file(s) copied.
1 file(s) copied.
setdbtype completed. Check C:WCDE_V9logssetdbtype.log for any errors.
● cat setdbtype.log
/C/WCDE_V9/logs
$ cat setdbtype.log
1 file(s) copied.
WASX7357I: By request, this scripting client is not connected to any server process. Certain configuration and application operations will be available in local mode.
40 File(s) copied
refreshEAR start
HeadlessWorkspaceSettings: INITIAL autoBuild=false maxFile=-1
HeadlessWorkspaceSettings: TEMP autoBuild=false maxFile=-1
Buildfile: C:WCDE_V9setuprefreshEAR.xml
refresh:
[publishEar] Error publishing the application: "Publishing failed"
[publishEar] Published WC to WebSphere Commerce Test Server
BUILD SUCCESSFUL
BUILD SUCCESSFUL
Total time: 5 minutes 25 seconds
HeadlessWorkspaceSettings: RESTORED autoBuild=false maxFile=-1
refreshEAR finished
Set the Database - setDBType

49. When integrating HCL Commerce with an external system, it is required to add the third party certificates to
the HCL Commerce trust store. This allows HCL Commerce to make HTTPS requests to an external system.
No Action Taken
Adding Certificates to your HCL Commerce Developer Environment Trust Store

50. ● Start the Developer Toolkit: C:WCDE_V9bin>startWCToolkit.bat
● From within Rational Application Developer, start the servers in the following order.
○ WebSphere Commerce test server
○ Search server
○ Store server
$ curl --user spiuser:abcdefghijklmnopqrstuvwqyzabcdefghijklmnopqrs --insecure -X POST
https://localhost:443/wcs/resources/admin/index/dataImport/build?masterCatalogId=10001
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 22 0 22 0 0 419 0 --:--:-- --:--:-- --:--:-- 431{"jobStatusId":"1001"}
$ curl --user spiuser:abcdefghijklmnopqrstuvwqyzabcdefghijklmnopqrs --insecure -X GET
https://localhost:443/wcs/resources/admin/index/dataImport/status?jobStatusId=1001
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 378 0 378 0 0 11374 0 --:--:-- --:--:-- --:--:--
11812{"status":{"finishTime":"2022-11-10 10:18:57.263","lastUpdate":"2022-11-10
10:18:57.263","progress":"100%","jobStatusId":"1001","startTime":"2022-11-10 10:18:28.219","message":"Full
indexing job started for masterCatalogId:10,001.rnIndexing job finished successfully for
masterCatalogId:10001.rn","jobType":"SearchIndex","properties":"[masterCatalogId=10001]","status":"0"}}
Configuring your HCL Commerce Developer Legacy for Solr-based Search Solution

51. Publish Commerce to the WAS Traditional
Verify the installation:
https://localhost:8443/wcs/shop/en/auroraesite
https://localhost:8443/wcs/shop/en/aurorab2besite
https://localhost:8000/lobtools/cmc/ManagementCenter (wcsadmin/wcsadmin)
Verifying your HCL Commerce Developer Installation

52. THANK YOU