Saturday, April 21, 2012

WebSphere Commerce v7 SOLR Configuration Files

Configuration Files Used for Creating the SOLR Index

wc-dataimport-preprocess-aaa.xml

This file contains the create statement for the particular preprocess table, and a query for populating the data for this table.

Typically on the WC server. Sample location:
[IBM]/WebSphere/CommerceServer70/instances/myInstance/search/pre-processConfig/MC_10001/DB2/

wc-data-config.xml

This file contains queries for getting data from preprocess tables (and regular WC tables if necessary) to populate the index. The query results are mapped to SOLR fields in this file. 

Typically on the SOLR server. Sample location:
C:\WCSearch\search\searchInstance\search\solr\home\MC_10001\en_US\CatalogEntry\conf\

schema.xml

This file defines the SOLR field settings. Searchable, sortable SOLR fields are defined here. 

Typically on the SOLR server. Sample location:
C:\WCSearch\search\searchInstance\search\solr\home\MC_10001\en_US\CatalogEntry\conf\

solrconfig.xml

This is the main SOLR configuration file. 

Typically on the SOLR server. Sample location:
C:\WCSearch\search\searchInstance\search\solr\home\MC_10001\en_US\CatalogEntry\conf\

Configuration Files Used by WC to Interpret Index Data

wc-search.xml

This file contains the search profiles. Fields to sort by are defined here. 

Typically on the WC Server. Sample location: 
[SOLR EAR]/xml/config/com.ibm.commerce.catalog-ext/

Highlights


  • Facet configuration including facet sort (index vs count), facet count upper and lower limits, facet data converters.
  • Config profiles (IBM_findCatalogEntryByNameAndShortDescription), fields that are searched (name, shortDescription, defaultSearch), expression providers (SolrSearchByKeywordExpressionProvider).

wc-business-object-mediator.xml

This file has the mapping from SOLR fields to WC fields (usually user data fields are used). 

Typically on the WC Server. Sample location: 
[SOLR EAR]/xml/config/com.ibm.commerce.catalog-ext/

Additional Reference Information

Sample SOLR log location (on the SOLR server)

[IBM]/WebSphere/AppServer/profiles/myProfile_solr/logs/solrServer/

Sample preprocessing command (run on the WC server)

[IBM]/WebSphere/CommerceServer70/bin/di-preprocess.sh [IBM]/WebSphere/CommerceServer70/instances/myInstance/search/pre-processConfig/MC_10001/DB2 -instance myInstance -dbuser dbUserName -dbuserpwd dbPassword -localename en_US -onelevel false -fullbuild true -multithread true

Sample indexing command (run on the WC server)

[IBM]/WebSphere/CommerceServer70/bin/di-buildindex.sh -instance myInstance -masterCatalogId 10001 -indextype CatalogEntry -dbuser dbUserName -dbuserpwd dbPassword -fullbuild true -localename en_US