You are here

About file

The <ALFRESCO_HOME>/alfresco-search-services/solrhome/conf/ file is used to set configuration that applies to all the cores in a Solr instance.
The file defines the:
  • properties that are treated as identifiers
  • properties that are used to generate suggestions
  • data types that support cross locale/word splitting/token pattern
  • properties that support cross locale/word splitting/token pattern
  • property
  • solr.port property

Properties defined in the file

You can define which properties are treated as identifiers, regardless of how they are defined in the model. These are properties must not be tokenised. If this list is changed, a reindex is required. You can also reindex by query. For more information, see Reindex documents by query.

If you rename the file to, it will use the same set of identifier properties that are used in Alfresco One 5.0.

# Properties treated as identifiers when indexed{}creator{}modifier{}userName{}authorityName{}lockOwner  

You can define which properties are used for suggestion.

# Suggestable Properties{}name{}title{}description{}content
Suggestion can also be configured for the search subsystem and for any SOLR core using properties. If the file is missing in Alfresco Community Edition 201911 GA, suggestion will be configured as it is in Alfresco One 5.0.

You can define which properties are used for tokenisation with the Solr word delimiter factory.

# Data types that support cross locale/word splitting/token patterns if tokenised{}name{}lockOwner

You can define which property types are used for tokenisation with the Solr word delimiter factory.

# Data types that support cross locale/word splitting/token patterns if tokenised

# alfresco.cross.locale.datatype.0={}text
# alfresco.cross.locale.datatype.1={}content
# alfresco.cross.locale.datatype.2={}mltext

Support for cross-language search

The cross core configuration options to use specific locales for cross-locale searches are set in the file. Cross language search uses the appropriate stemmed tokens for all locales.

For backward compatibility, this file is absent in Alfresco Community Edition 201911 GA to provide options equivalent to Alfresco One 5.0.

To configure cross-language search, follow the steps below:
  1. Open the <ALFRESCO_HOME>/alfresco-search-services/solrhome/conf/ file.
  2. Set the following properties:{}name

    This sets the properties that should be dual tokenised.

    The cross-language search in Alfresco One 5.0 is now only used to provide support to split tokens (based on case and numbers) to generate in word tokens. The in word tokenisation is mainly used for name. For example, find RedDog12 by Red, Dog, or 12, Dog12, and so on. This property must be indexed and tokenised.

  3. To specify the same behaviour based on the data type, set the following properties:

Query time expansion of locales

Query time expansion of locales can be defined in the solrconfig.xml file as part of the query language definition.

Locale parameter What is it?
autoDetectQueryLocale If true, this uses the query typed in by the user to detect the locale.
autoDetectQueryLocales This specifies a set of locales. One of these may be used in executing the query if autoDetectQueryLocale=true.
fixedQueryLocales This specifies a fixed set of locales always used by the query.
What locales are used?
  • The locale for the current session is always used.
  • If the autoDetectQueryLocale parameter is used, then the best match from autoDetectQueryLocales is used. If no parameter is set, then all the possible locales are used.
  • All fixedQueryLocales are used.
Here are some example entries in the solrconfig.xml file:
<queryParser name="afts" class="org.alfresco.solr.query.AlfrescoFTSQParserPlugin">
    <str name="rerankPhase">QUERY_PHASE</str>
    <str name="autoDetectQueryLocale ">true</str>
    <str name="autoDetectQueryLocales ">en,fr,de</str>
<queryParser name="afts" class="org.alfresco.solr.query.AlfrescoFTSQParserPlugin">
    <str name="rerankPhase">QUERY_PHASE</str>
    <str name="fixedQueryLocales">en,fr,de</str>

These are query time options and do not require a reindex. Currently, these values cannot be set in the file.

Enabling path queries

The property alfresco.cascade.tracker.enabled provides Index fields that are required for path-based queries when set to true (the default is true). Disabling support for path queries (i.e. setting this to false) can speed up indexing in sharded systems.

Updating this property from the default setting will result in path-based fields not being populated. Consequently it should not be changed after the initial startup of the server.
Note: If alfresco.cascade.tracker.enabled is set to false and Solr is restarted, cascaded updates are disabled.
  • When you disable cascade tracking and do not index fields that are updated on cascaded updates:

    This is the default setting when cascade tracking is disabled and as a result many search queries will not work, even for users with an environment where parent entries are not updated (e.g when a parent node has been renamed), such as SITE:swsdp.

    This approach ensures search queries affected by disabling cascade tracking will not work, rather than risking inconsistent query results.

    Review how the following services are affected:
    • CMIS
      • IN_TREE, PATH, PARENT, ANCESTOR queries will not work.
    • Search API
      • Faceted Search (Facet Fields, Pivot Facet, Facet Range), PATH, NPATH, Secondary Association, Cascade Updates, Search with Sort queries will not work.
    • SQL API
      • There are at least 70 less fields found in the Solr schema.
      • SITE, PATH: fields are not indexed and SQL queries based on these fields will return null values.
      • Queries will not be successful with these fields being used in predicates, for example queries with <select * from alfresco where Site = ‘swsdp’>.
    • Share
      • Category Manager http://localhost:8081/share/page/console/admin-console/category-manager can't be used.
      • TAGs can't be created or browsed.
      • Your site can be defined as a Facet for Search Results (via Search manager) but it will not work.
      • Searching within a site (or within a folder) returns a list of content within the site. This will not work, for example using SITE:swsdp syntax or via node browser using PATH queries.
      • Node browser default PATH query doesn’t list system and category roots and PATH queries.

    If alfresco.cascade.tracker.enabled is set to false and Solr is restarted cascaded updates will be disabled. To avoid inconsistencies in the results, by default the fields that are updated on cascade updates are not indexed.

    When parent paths have been updated or renamed, path queries are affected because the correct parent paths are available in the database but the Solr indexes for any children are not updated. The result of this can be inconsistent results for path queries and queries where parent/path are used.

    These types of results will affect users when their environment allows for cascaded changes. The results of a search query that use the database and search/SQL, including the index, may not always match, if the parent path is updated (only in case of renaming a parent).

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.