Setting up the HCL Commerce Solr-based Nextjs Store development environment

The Orchestration service acts as a bridge between Ruby applications that can only recognize Elastic-based search formats, and Solr-based search services. If you plan to develop for Ruby applications for use with a Solr-based search solution, you must configure the Orchestration service to test your storefronts in an HCL Commerce development environment.

For more information on the Orchestration service, see Orchestration service.

Before you begin

Before you can enable the use of the Orchestration service and test your site using the Solr-based search solution, you must:

Set up an HCL Commerce development environment:
- Install or upgrade to HCL Commerce Developer 9.1.16.0 or greater.
- Configure your HCL Commerce Developer Legacy environment for use with the Solr-based search solution. For more information on the Solr-based search solution, see Using Apache Solr as your search solution.
- Set up an HCL Commerce Developer Next.js Store environment.
Ensure that your environment meets both hardware and software requirements:
- For software requirements, review Supported software levels, fixes, and settings for HCL Commerce.
- For hardware requirements, review ../refs/rigrechw.html.
If you are using Microsoft Windows:

Procedure

Clone the HCL_Commerce_DevOps_9.1.x.x.bundle git bundle.

Ensure that your STORECONF database table is correctly configured.

Ensure that wc.search.priceMode.compatiblePriceIndex is set to 0 for your store.
```
update storeconf set VALUE='0' where NAME='wc.search.priceMode.compatiblePriceIndex';
```

Ensure that hcl.imagePath is set to your image path for your store.

For the default Next.js sample store, use the following SQL to set it to /hclstore.

INSERT INTO WCS.STORECONF (STOREENT_ID, NAME, VALUE) VALUES(41, 'hcl.imagePath', '/hclstore'); 
INSERT INTO WCS.STORECONF (STOREENT_ID, NAME, VALUE) VALUES(42, 'hcl.imagePath', '/hclstore');

Ensure that headlessStore is set to true for your store.

For the default Next.js sample store, use the following SQL to set it to true.

INSERT INTO WCS.STORECONF (STOREENT_ID, NAME, VALUE) VALUES(41, 'headlessStore', 'true'); 
INSERT INTO WCS.STORECONF (STOREENT_ID, NAME, VALUE) VALUES(42, 'headlessStore', 'true');

Download, load, and deploy the HCL Commerce Elasticsearch-based search data and orchestration Docker images for your HCL Commerce development environment.
Review the following task and deployment reference information:
- ../../search/tasks/tsdelasticdeployDevEnv.html.
- The Docker Compose deployment env.sh configuration file.
Using the following env.sh configuration to enable orchestration within your HCL Commerce development environment.
```
SEARCH_ENGINE=solr 
DEPLOY_TYPE=toolkit 
REACT_STORE_ENABLED=false

LICENSE_ACCEPTED=accept 
ENV_TYPE=auth 

TOOLKIT_HOST=<toolkitHost> 
TOOLKIT_HOST_IP=<toolkitHostIP> 
TOOLING_HOST=<toolingHost>

ORCHESTRATION_ENABLED=true
ORCHESTRATION_IMAGE=<orchestrationImage> 

SPIUSER_PWD_ENCRYPTED=<encryptedSpiUserPassord>
```
Verify that all of the containers are up and healthy.
Run the HCL Commerce Developer Nextjs store configuration script.
1. Navigate to the WCDE_Installdir\bin\ directory.
2. Run the following command script.
```
configureSolrNextjsStore.bat orchestrationHost orchestrationPort nextjsStoreHost nextjsStorePort transactionHost transactionPort toolingSDKInstallDir nextjsStoreSDKInstallDir
```
  Where:
  
  orchestrationHost
  
  The hostname or IP address of the Orchestration server. Specifying localhost does not work.
  
  orchestrationPort
  
  The port number for the Orchestration server. For example, 19443.
  
  nextjsStoreHost
  
  The hostname or IP address of the Nextjs Store server. For example, localhost.
  
  nextjsStorePort
  
  The port number for the Nextjs Store server. For example, 3343.
  
  transactionHost
  
  The hostname or IP address of the Transaction server.
  
  transactionPort
  
  The port number for the Transaction server. For example, 443.
  
  toolingSDKInstallDir
  
  The installation directory for the Tooling SDK.
  
  nextjsStoreSDKInstallDir
  
  The installation directory for the Nextjs Store SDK.
  For example:
```
configureSolrNextjsStore.bat orchestration.commerce.com 19443 localhost 3343 localhost 443 C:\HCL_Commerce_Tooling C:\HCL_Commerce_Nextjs
```

Results

Your HCL Commerce development environment is now configured and deployed with the Orchestration service. You can now test Ruby applications using the Solr-based search solution.

What to do next

Enable the HCL Commerce Cache Manager application.

Note: the Cache Manager application can be deployed more easily by updating your deployment env.sh file and setting the CACHE_ENABLED and CACHE_APP_IMAGE parameters.