Configuring your for use with the Solr-based search solution

After installation, your is configured by default for use with the newer Elasticsearch-based search solution that was introduced in . Complete the following steps to revert your to maintain or develop sites that use the Solr-based search solution.

Procedure

  1. Start .
    Navigate to the WCDE_installdir/bin/ directory and run the following command in a command prompt.
    .\StartWCtoolkit.bat
  2. From within , start the servers in the following order.
    1. test server
    2. Search server
    3. Store server
  3. Build the Solr search index for the Aurora sample store.
    1. Start the search index build. This command is assuming the default spiuser and password, as well as the default master catalog.
      curl --user spiuser:passw0rd --insecure -X POST https://localhost:443/wcs/resources/admin/index/dataImport/build?masterCatalogId=10001
      Note the job status ID that is returned, for use in the next step.
    2. Observe the status of the search index build. Use the status ID that was returned in 3.a.
      curl --user spiuser:passw0rd --insecure -X GET https://localhost:443/wcs/resources/admin/index/dataImport/status?jobStatusId=1502

    For more detailed information about how to build the Solr search index, see ../../search/tasks/tsdsearchbuildindex.html.

  4. Optional: If you are running an Aurora-based storefront with Solr-based search and you are not using contract-based pricing, you must  complete the following to ensure that prices are reflected in the storefront.
    1. Run the following SQL statement against your database.
      update storeconf set VALUE='0' where  NAME='wc.search.priceMode.compatiblePriceIndex';
    2. Refresh your registry manually, or by restarting the . In , select Configuration > Registry > Update All.
  5. Update the JNDI and JNDI settings to point to your Solr-based .
    1. Open the configuration file located at Liberty_installdir\usr\servers\crsServer\configDropins\overrides\jndi.xml for editing.
    2. Add or update the following entries with the hostname and port number.
      <jndiEntry jndiName="com.ibm.commerce.foundation.server.services.search.hostname" value="localhost"/>
      <jndiEntry jndiName="com.ibm.commerce.foundation.server.services.search.port" value="3738"/> 
      <jndiEntry jndiName="com.ibm.commerce.foundation.server.services.search.preview.port" value="3738"/>
    3. Save and close the file.
    4. Open the configuration file located at WCDE_installdir\wasprofile\config\cells\localhost\nodes\localhost\servers\server1\namebindings.xml for editing.
    5. Update the following entries.
      <namebindings:StringNameSpaceBinding xmi:id="StringNameSpaceBinding_1566569392360" name="com.ibm.commerce.foundation.server.services.search.port" nameInNameSpace="com.ibm.commerce.foundation.server.services.search.port" stringToBind="3738"/> 
      <namebindings:StringNameSpaceBinding xmi:id="StringNameSpaceBinding_1566569392372" name="com.ibm.commerce.foundation.server.services.search.hostname" nameInNameSpace="com.ibm.commerce.foundation.server.services.search.hostname" stringToBind="localhost"/> 
      <namebindings:StringNameSpaceBinding xmi:id="StringNameSpaceBinding_1566569392380" name="com.ibm.commerce.foundation.server.services.search.preview.port" nameInNameSpace="com.ibm.commerce.foundation.server.services.search.preview.port" stringToBind="3738"/> 
      <namebindings:StringNameSpaceBinding xmi:id="StringNameSpaceBinding_1566569392392" name="com.ibm.commerce.foundation.server.services.search.url" nameInNameSpace="com.ibm.commerce.foundation.server.services.search.url" stringToBind="https://localhost:3738/solr"/> 
      <namebindings:StringNameSpaceBinding xmi:id="StringNameSpaceBinding_1592048347443" name="com.hcl.commerce.search.elasticsearch" nameInNameSpace="com.hcl.commerce.search.elasticsearch" stringToBind="false"/>
    6. Save and close the file.
  6. Optional: Disable Redis.
    Note: If you intend to install the (cache-app) to control your , leave Redis enabled. For detailed instructions, see step #7.
    1. Open the WCDE_installdir\setup\hcl-cache\cache_cfg-ext.yaml configuration file for editing.

      If this file does not exist, create it using WCDE_installdir\setup\hcl-cache\cache_cfg.yaml as a template.

    2. Set the Redis enabled property to false.
      redis:
        enabled: false
      yamlConfig: "WCDE_installdir/setup/hcl-cache/redis/singleserver/redis_cfg.yaml"
    3. Save and close the file.
  7. Optional: Enable the .

Results

Your is now configured to develop or maintain a site configured with a Solr-based search solution.