You are here

Performing a full hot reindex on a cluster

This section describes the process of performing a full hot reindex on an Alfresco cluster.

This process applies to Lucene indexes only.
  1. Change your load balancer configuration to prevent any user traffic from being directed to node 1.
  2. Shut down Alfresco on node 1.
  3. Remove the Lucene indexes on node 1 (alf_home_dir/alf_data/lucene-indexes).
  4. Make the following changes in the alfresco-global.properties file on node 1:

    system.cache.disableMutableSharedCaches=true 
    alfresco.cluster.name=temporaryclustername   

    You can set the value of alfresco.cluster.name parameter to anything, provided that cluster name is not in use by any other Alfresco nodes on the same network.

  5. Start Alfresco on node 1. It takes some time for indexing to complete. The following message is displayed in the log files:

    18:14:44,806 INFO [node.index.FullIndexRecoveryComponent] 100 %  complete. 
    18:14:44,992 INFO [node.index.FullIndexRecoveryComponent] Index recovery completed.

    This message does not indicate that full reindex is finished, it shows that the full reindex of the metadata is finished. Node 1 will then index the content of the documents in the background. You need to wait till this process is finished. To confirm that the content is indexed, you could monitor the CPU activity - it will be consistently high until the indexing is finished, at which point it should drop sharply.

  6. Shut down Alfresco on node 1.
  7. Make a backup copy of the indexes on node 1.
  8. Revert the configuration changes made in Step 4. To do so, remove the system.cache.disableMutableSharedCaches=true setting and change alfresco.cluster.name back to what it was previously.
  9. Start up Alfresco on node 1.
  10. Change your load balancer configuration to allow user traffic back to node 1 and stop traffic from going to node 2.
  11. Shut down Alfresco on node 2.
  12. Delete the Lucene indexes on node 2.
  13. Copy the backup made in Step 7 into the lucene-indexes directory on node 2.
  14. Start Alfresco on node 2.
  15. There may be a small amount of additional top-up indexing required on node 2. Once this indexing has finished (as per Step 5), change your load balancer configuration to allow traffic to node 2.