Configuring the managed repeater and subordinates to perform index check validation
You can configure the managed repeater and subordinate index cores to perform index validation during replication. Index validation is triggered every time index replication completes downloading new index files into the repeater or subordinate. If both nodes are synchronized, hence, no files are downloaded, index validation is not run. Index validation is configured at the core level.
true
. When index validation is configured, an optional query check properties file with a list of queries can be specified. Otherwise, a default query of q=*:* is run, which is expected to return results greater than zero. The results of the index validation queries are then compared with predefined minimum result counts that a query should return. An entry is logged into the administration logger indicating the query check status.
In addition to the query check operation, a new index status check operation
can be configured. This operation validates the last replication status, and checks whether a
subordinate index is in sync with its master. The checks are done by examining the response of the
/replication?command=details
instruction.
A new uponFailure
recovery operation will be invoked if
either of the check operations returns false. It will retry replication logic for a configurable
number of times. The status check operation will log an entry in the admin log if the status check
shows "failed", or when "passed" if the same core had previously failed.
Before you begin
About this task
- Enable the index query check operation option in the managed repeater or subordinate.
- Optional: Configure the query check properties file and save it into its default location.
- Optional: Copy the query check property file into a common location among all cores.
Procedure
-
Enable the index query check operation option in the managed repeater or subordinate.
- Optional:
Configure the query check properties file and save it into its default location.
- Optional:
Copy the query check property file into a common location among all cores.
- Optional:
Change the default SolrDoFetchIndexOperation configurable properties. To
change the default number of attempt to fetch the index, edit or create the
solrcore.properties file and add the following properties.
- To change the default number of attempt to fetch the index, add
com.ibm.commerce.foundation.solr.operation.SolrDoFetchIndexOperation.retryFetchIndexAttemptsLimit=10
, or any other positive number. (Default value is 5 if not specified) - To change the default wait time before each retry attempt, add
com.ibm.commerce.foundation.solr.operation.SolrDoFetchIndexOperation.retryFetchIndexDelay=60000
, or any other value which represents Milliseconds. (The default value is 15000 milliseconds.)
- To change the default number of attempt to fetch the index, add
Results
- When failure is detected.
- When succeeding after a failure.
- When indicating that a retry attempt will be performed.
- When the system has reached the maximum number of attempts.
[Fri Sep 16 19:20:21 EDT 2016] [wcsolr45.torolab.ibm.com] [00001021]
<com.ibm.commerce.foundation.solr.operation.SolrSearchCoreOperationProcessor:executeOperatios(String operationStr)>
LIFECYCLE OPERATION com.ibm.commerce.foundation.solr.operation.SolrDoStatusCheckOperation ON MC_3074457345616676668_CatalogEntry_fr_FR
IS FAILED.
.
.
[Fri Sep 16 19:20:21 EDT 2016] [wcsolr45.torolab.ibm.com] [00001021]
<com.ibm.commerce.foundation.solr.operation.SolrDoFetchIndexOperation:doOperation(NamedList operationProps)>
LIFECYCLE OPERATION com.ibm.commerce.foundation.solr.operation.SolrDoFetchIndexOperation ON MC_3074457345616676668_CatalogEntry_fr_FR
IS RETRYING REPLICATION LOGIC IN 15,000 MILLISECONDS . ATTEMPT NUMBER [1]
.
.
[Fri Sep 16 19:20:36 EDT 2016] [wcsolr45.torolab.ibm.com] [00001024]
<com.ibm.commerce.foundation.solr.operation.SolrSearchCoreOperationProcessor:executeOperatios(String operationStr)>
LIFECYCLE OPERATION com.ibm.commerce.foundation.solr.operation.SolrDoStatusCheckOperation ON MC_3074457345616676668_CatalogEntry_fr_FR
IS FAILED.
.
.
[Fri Sep 16 19:20:36 EDT 2016] [wcsolr45.torolab.ibm.com] [00001024]
<com.ibm.commerce.foundation.solr.operation.SolrDoFetchIndexOperation:doOperation(NamedList operationProps)>
LIFECYCLE OPERATION com.ibm.commerce.foundation.solr.operation.SolrDoFetchIndexOperation ON MC_3074457345616676668_CatalogEntry_fr_FR
IS RETRYING REPLICATION LOGIC IN 15,000 MILLISECONDS . ATTEMPT NUMBER [2]
.
.
[Fri Sep 16 19:20:51 EDT 2016] [wcsolr45.torolab.ibm.com] [00001028]
<com.ibm.commerce.foundation.solr.operation.SolrSearchCoreOperationProcessor:executeOperatios(String operationStr)>
LIFECYCLE OPERATION com.ibm.commerce.foundation.solr.operation.SolrDoStatusCheckOperation ON MC_3074457345616676668_CatalogEntry_fr_FR
IS PASSED.