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.
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
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
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
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
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