You are here

Issues to consider before upgrading search

Before beginning an upgrade of the search subsystems, there are some important issues you should consider.

Setup wizard installation

Alfresco Content Services uses the Solr 1 search subsystem only during the upgrade process. When upgrading to using the setup wizards, you should install both the Solr 1 and Solr 4 search subsystems. If you wish to minimize the necessary downtime of the search subsystem while the Solr 4 indexes are being build, you must run Solr 1. Once the Solr 4 indexes are up to date, you must enable the Solr 4 subsystem and disable the Solr 1 subsystem.

Note: Note that when you have both the subsystems, you will need more memory. So, you might consider installing them as separate web applications on separate Tomcat instances.
Note: You do not have to use the Solr 1 search service during the upgrade process. Instead, you can let Solr 4 build its indexes, but during this time, any search carried out might return incomplete results. This is because only those documents that have been indexed are available for searching. Set the NoIndex option to avoid incomplete and/or misleading results. For more information, see transactional metadata query.

Solr 4 suggester configuration

Alfresco Content Services uses the suggester component in Solr to provide users with automatic suggestions for query terms.
  • With new Alfresco Content Services 5.2.6 installations, the suggester is enabled for the workspace store, by default.
  • If you are upgrading to Alfresco Content Services 5.2.6 with Solr 4, before building the new index, we recommend that you disable the suggester property in the <solrRootDir>/workspace-SpacesStore/conf/solrcore.properties file:
    solr.suggester.enabled=false

    This is because on a low specification system, building the suggester can cause CPU and IO load issues, which can affect other operations. When the Solr 4 index is up to date, the solr.suggester.enabled property can be reset to true.

    The Solr 4 suggester holds a view of the index. Normally, there is only one live view of the index. An old view can exist for a few seconds or minutes until all the running queries are complete. If there are two or more live views of the index, index tracking will not run. This only happens while the suggester is being build and if the process of building the suggester is slow. To solve this issue, you can configure how often the suggester will run, if it is enabled.

An out-of-the-box Alfresco Content Services application allows you to use three word phrase suggestions across the repository. Suggestions are not limited by permissions. To limit the scope, you can configure the suggester to use single words or two word phrases by changing schema.xml before you rebuild the index.

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.