Reindexing Failed Index Items

  • 7019110
  • 07-Apr-2016
  • 07-Aug-2017


Retain 4.x


The indexer says there are a lot of failed items, is there a way to try indexing them again?


This knowledgebase (KB) article is provided for informational purposes only and as a courtesy service to you, our customer. GWAVA Technical Support does not have any database administration (DBA) expertise, nor does it provide DBA services or support. GWAVA is not responsible for the results of implementing any of the concepts contained in this KB article. Implementation of any of the concepts suggested in this KB article shall be done entirely at your own and sole risk, and GWAVA does not provide any kind of warranties whatsoever resulting from your decision of implementing any of the KB article’s concepts. It is up to you to do any research and to ensure yourself that any implementation and setup of any of the KB article’s concepts in your database system is correctly and properly executed. It is imperative that you have backups of your database system and storage directory before making any implementation. If you don’t have any DBA expertise, you should consult with a DBA expert before any implementation of the KB article’s concepts.  Under no circumstances, shall GWAVA, or any of its employees, be liable, in contract, tort, delict or otherwise, whether negligence is provable or not, for any direct, indirect, incidental, special, punitive, consequential or other damages, loss, cost or liability whatsoever that would result from or are related to the implementation of any of the concepts suggested in the KB article.

To the extent permitted by applicable law, GWAVA shall not be liable to you for any special, consequential, direct, indirect or similar damages, including any loss of data, arising out from migrating any type of messages, attachments, database, metadata in your Retain system to another server and/or location.


Usually the indexer is unable to index an item because it is password protected, in a format that doesn't have text to index, or corrupt in some way and that should result in a few failed items, but if there are many failed items something may have gone wrong more generally.  Trying to reindex the failed items in this instance could be a good idea.

To reindex the failed items: You have to go into the database and reset the f_indexed field in the t_message table.

In MySQL the update command would be:

update retain.t_message set f_indexed = 1 where f_indexed > 2;

It may be slightly different in other SQL dialects.

Additional Information

This article was originally published in the GWAVA knowledgebase as article ID 2781.