Deploy a simple HCL Commerce authoring environment to create an
environment where site administrators and business users can update the store catalog or store
configurations by using HCL Commerce tools.With this simple authoring
environment deployment, you prepare a search container as the search_master
node.
The live environment that you use with this authoring environment should include a
search_repeater
and search_slave
that communicates with the
search_master
in the authoring environment.
Procedure
-
Install Docker.
-
Install Docker Version 17.06 or later.
-
Install Docker Compose Version 1.10 or
later.
-
Consider creating a Docker Unix group.
-
Download the following sample Docker Compose file based on how the database is
configured.
Option | Docker Compose sample |
---|
Database running inside a Docker container |
Download the following file: Note: If the link does not prompt you to
save, right-click and save the file. Open the file
in a source code editor to view and edit in the
proper YAML format. The YAML files are samples that assume that
you are using a Db2 Docker image. Ensure that you update all the
parameters that are in angle brackets <>. The
sample files are commented with descriptions of
the parameters. |
Database running on a standard server (not in a Docker container) |
Download the following file: Note: If the link does not prompt you to
save, right-click and save the file. Open the file
in a source code editor to view and edit in the
proper YAML format. Ensure that you update all the
parameters that are in angle brackets <>. The
sample files are commented with descriptions of
the parameters. |
Download the Oracle JDBC driver java/ojdbc8.jar file from the Oracle
installation folder, and put it under the directory where you saved the Docker Compose file.
-
In a command line interface, go to where you saved the Docker Compose file.
-
Run the applicable command to deploy the Docker containers based on the
Docker Compose file that you have.
Note:
- If the images are not already on your machine, the command downloads Docker images from your
registry. The images are approximately 10 GB in total so the duration of this command depends on
your Internet connection.
- Whenever your Docker virtual machine is restarted, you need to manually restart the Docker
containers by rerunning this docker-compose -f <file> up -d command.
-
If you loaded sample data in your database, then build the search index.
-
Send the following REST request (POST) and add
basic authentication with login as
spiuser and the password
for the spiuser.
You can build the search index
by using one of the following methods:
- By using the
curl utility. Use the following
curl command with the spiuser
plain text password.
curl -k -u spiuser:spiuserPassword -X POST https://transaction_server_hostname:5443/wcs/resources/admin/index/dataImport/build?masterCatalogId=10001
- By using a browser plug-in
such as HttpRequester (for Mozilla Firefox) or
Postman (for Google Chrome). Use the following URL
and authenticate with user
spiuser and the
spiuser plain text
password.
https://transaction_server_hostname:5443/wcs/resources/admin/index/dataImport/build?masterCatalogId=10001
Note the jobstatusId
that you get in the response, for example,
{"jobstatusId":"xxxxx"}.
-
Use the jobstatusId and send the following REST request (GET) to check
the request execution status.
Again, use basic
authentication with spiuser
and the spiuser
password.https://<search_server_hostname>:3738/search/admin/resources/index/build/status?jobStatusId={jobstatusId}
When
successful, you will get a
Status: 200 OK
and response similar to the
following:
response content: {
"finishTime":"2017-08-01 06:49:31.395759",
"lastUpdate":"2017-08-01 06:49:31.395759",
"progress":"100%",
"jobStatusId":"14003",
"startTime":"2017-08-01 06:48:17.369909",
"message":"Indexing job started for masterCatalogId:10,001. Indexing job finished successfully for masterCatalogId:10001.",
"jobType":"SearchIndex",
"properties":"[]",
"status":"0"}
-
Ensure that you can log in to Management Center.
- https://<transaction_server_hostname>:8000/lobtools/cmc/ManagementCenter
-
If you loaded sample data into your authoring database, ensure that you can visit the sample
Aurora store.
- https://<store_server_hostname>:8443/wcs/shop/en/auroraesite