Introduced in Feature Pack 2

Enabling tracing and logging for WebSphere Commerce search

You can enable tracing and logging of WebSphere Commerce search features to help debug server-side issues.

Before you begin

Procedure

  • You can enable the trace for WebSphere Commerce search features by specifying the following trace string in the WebSphere Application Server administration console.
    On the WebSphere Commerce server:
    
    com.ibm.commerce.catalog.*=all:com.ibm.commerce.foundation.*=all:com.ibm.commerce.search.*=all
    
    Feature Pack 7 or laterOn the WebSphere Commerce search server:
    
    com.ibm.commerce.foundation.*=all: com.ibm.commerce.rest.*=all: org.apache.solr.*=all: org.apache.wink.*=all: com.ibm.commerce.solr.*=all
    

    This trace string enables traces for WebSphere Commerce search that can be used for troubleshooting issues.

  • If you need more information, you can enable the following additional traces to help troubleshoot issues:
    1. For general Solr-side troubleshooting, enable the following traces:
      Feature Pack 4Feature Pack 2Feature Pack 5Feature Pack 3Feature Pack 6
      
      org.apache.solr.*=all
      org.apache.commons.httpclient.*=all
      com.ibm.commerce.solr.*=all
      
    2. Feature Pack 3For web content troubleshooting, enable the following traces:
      
      org.apache.droids.*=all
      com.ibm.commerce.search.crawler.*=all
      
    3. Feature Pack 8For price index troubleshooting, enable the following traces:
      
      com.ibm.commerce.foundation.dataimport.priceindex.*=finest
      com.ibm.commerce.price.*=finest
      com.ibm.websphere.commerce.WC_ORDER
      
  • The log file is located in the following directory:
    • SolarisLinuxAIXWindowsWAS_installdir/profiles/instance_name/logs/server1
    • For IBM i OS operating systemWAS_userdir/profiles/instance_name/logs/server1
    • WebSphere Commerce DeveloperWCDE_installdir/wasprofiles/logs/server1
  • Logging properties exist for the search utilities. You can get more logging information by updating the logging level from INFO to FINEST:
    Feature Pack 4Feature Pack 2Feature Pack 5Feature Pack 3Feature Pack 6
    
    # Default global logging level, INFO
    .level=FINEST
    
    Feature Pack 7 or later
    
    # Default global logging level, INFO
    com.ibm.commerce.level=FINEST
    

    For the following utilities and log files:

    Setup search index:
    • WC_installdir/components/foundation/subcomponents/search/config/logging.properties for the local machine.
    • working_dir/search/config/logging.properties for the remote machine.
    Search preprocessor:
    • WebSphere Commerce DeveloperWCDE_installdir\workspace\WC\xml\config\dataimport\logging.properties
    • SolarisLinuxAIXWindowsWC_installdir/instances/instance_name/xml/config/dataimport/logging.properties
    • For IBM i OS operating systemWC_instance_root/xml/config/dataimport/logging.properties
    Search build index:
    • WebSphere Commerce DeveloperWCDE_installdir\workspaces\WC\xml\config\dataimport\buildindex-logging.properties
    • SolarisLinuxAIXWindowsWC_installdir/components/foundation/wc.ear/xml/config/dataimport/buildindex-logging.properties
    • For IBM i OS operating systemWC_instance_root/xml/config/dataimport/buildindex-logging.properties
    Introduced in Feature Pack 3Index prop:
    • WebSphere Commerce DeveloperWCDE_installdir\workspaces\WC\xml\config\dataimport\indexprop-logging.properties
    • SolarisLinuxAIXWindowsWC_installdir/components/foundation/wc.ear/xml/config/dataimport/indexprop-logging.properties
    • For IBM i OS operating systemWC_instance_root/xml/config/dataimport/indexprop-logging.properties
    Introduced in Feature Pack 3Search migration:
    • WebSphere Commerce DeveloperWCDE_installdir\components\foundation\subcomponents\search\config\migrate-solr-search-logging.properties
    • SolarisLinuxAIXWindowsWC_eardir\components\foundation\subcomponents\search\config\migrate-solr-search-logging.properties
    Feature Pack 5 or laterSearch facet migration:
    • WebSphere Commerce DeveloperWCDE_installdir\components\foundation\subcomponents\search\config\migrate-facet-logging.properties
    • SolarisLinuxAIXWindowsWC_eardir\components\foundation\subcomponents\search\config\migrate-facet-logging.properties
    Feature Pack 7 or laterSearch replication configuration:
    • WebSphere Commerce DeveloperWCDE_installdir\components\foundation\subcomponents\search\config\configure-solr-replication-logging.properties
    • SolarisLinuxAIXWindowsWC_eardir\components\foundation\subcomponents\search\config\configure-solr-replication-logging.properties
    Feature Pack 8Search price index:
    • WebSphere Commerce DeveloperWCDE_installdir\workspace\WC\xml\config\dataimport\calculateprice-logging.properties
    • SolarisLinuxAIXWindowsWC_installdir/instances/instance_name/xml/config/dataimport/calculateprice-logging.properties
    • For IBM i OS operating systemWC_instance_root/xml/config/dataimport/calculateprice-logging.properties