Troubleshooting: Recovering lost or corrupted Solr External files

If index data including external .txt files has been lost due to data corruption or accidental deletion, you can regenerate the files.

Problem

Customized sequences no longer appear in the store.

Solution

Adding a language to a store can overwrite the data in the Solr External files directory, and corruption can occur for other reasons. Loss of the Solr External files causes the display sequence to reset to its default state, but the sequence data itself is not lost. The customized display can be restored by using the following procedure.

  1. Confirm that the problem does not have another cause. In a typical non-clustered, master node configuration, the Solr External Index files are found in solrhome/MC_3074457345616676668/en_US/CatalogEntry/data. The index files are text files with the extension .txt. If these files are still present and have not been corrupted, then the problem may be due to other causes, such as Solr caching issues.
  2. If the files are missing or corrupted, open the Administration Console, which by default can be found at https://host_name:8002/adminconsole.
  3. From the menu bar of the Administration Console home page, click Configuration > Scheduler.
  4. In the Scheduler window, click the New button, which can be found in the column of buttons on the right side of the window. The New Scheduled Job window appears.
  5. Select ProductDisplayPropertiesUpdate in the Job Command menu. Type the storeID in the Job Parameters field, followed by the refresh parameter refresh=true. storeId must be an extended sites store ID. Separate the parameters with an ampersand character. For example, storeID=1020&refresh=true.
  6. Provide a starting time and date in the Start Date fields. Leave all other fields and options in the window unchanged.
  7. Click Okay to run the job.

The ProductDisplayPropertiesUpdate command calls the product_display_properties REST method with the refresh_display_properties parameter. This REST call tells the search server to refresh the Solr External files that contain the product display sequencing information. When the command completes, the files should reappear. Features such as customized display sequences will again be visible in the store.